# NCANALYSE.DAT

### From BAWiki

## Basic Information

### File-Type

ncanalyse.dat

### File-Form

FORMATTED

### Version

March 2023

### Description-Date

October 2021

## Significance of the File

contains general steering data for the program NCANALYSE.

## File-Contents (in Catchwords)

**steering data**

- Block
**Program_Parameters**: general input data**Max_Read_Storage**: maximum number of data items which can be read, stored and processed within one analysis cycle.**Min_Water_Depth**: minimum water depth up to which analyses are carried through.- (optional)
**Create_Missing_Variables**: create additional (virtual) variables- 0 = do not create (default);
- 1 = create (actually only "magnitude_of_sea_water_velocity" for DFlow FM UGRID CF NetCDF).

- (optional)
**NC_Deflate_Level**: level (0 to 9) of online-compression used during write of the result file- 0 = no compression (default);
- 5 = good compression (recommendation);
- 9 = highest level of compression.

- (optional)
**FRQ_use_j_v_correction**: nodal correction in tidal constituent analysis- .true. = use nodal correction in computation of tidal constituents (default);
- .false. =
*neglect*nodal correction in computation of tidal constituents.

- (optional)
**END_after_hrp**: end program execution after analysis at reference locations before entering spatial analysis- .true. = end execution before spatial analysis;
- .false. = normal execution of program (default).

- (optional)
**CU_zero_slack**: critical value for current velocity in [m s-1]. Typically 1 [cm s-1] is predefined in the configuration files. This value is used to determine current slack. Current slack is recognized by the program in case magnitude of current velocity lies above this limit value and the direction of flow has changed. - (optional)
**Compute_FE_Ratio**: Compute flood(current):ebb(current) characteristic numbers, in case they are marked using <OPT:COMPUTE_FE_RATIO> in a configuration file.- .true. = F:E-Kenngrößen berechnen
- .false. = F:E-Kenngrößen nicht berechnen (Default)

- (optional)
**CFG_Level**: some configuration files may contain lines including <OPT:CFG_Level_*number*> to allow for a more flexible use for different purposes.- 0 = activate lines including <OPT:CFG_Level_0> (default)
- 1 = activate lines including <OPT:CFG_Level_1>

- (optional)
**Location_XY_EPSG**: EPSG code for X- and Y-coordinates used in**Location**blocks. In case this key is missing, EPSG code derived from input data (block**Input_Files**) will be used. - (optional)
**Gap_Fill**: control parameter for filling data gaps at reference locations by interpolation. If this key is not specified, data gaps (water level, current) are not automatically filled.- 0 = data gaps are not filled (default)
- 1 = Data gaps are filled by spline interpolation

- Block
**Data_Analysis_Period**: period of data analysis**Start_Time**: start time of data analysis period.**End_Time**: end time of data analysis period.

- Block
**Input_Files**: CF NetCDF file with input data**Data_File**: name and type (NETCDF) of the input data file (filetype cf-netcdf.nc). An optional third parameter may be used to choose between MPI COLLECTIVE I/O and MPI INDEPENDENT I/O (relevant for MPI program version only).

- Block
**Location**: reference locations (one block per location)**Name**: name of reference location.**Type**: type of reference location:- 0 = reference location
*tide*(must be specified exactely once); - 1 = reference location
*phase*(must be specified exactely once); - 2 = auxiliary location (can be specified several times).

- 0 = reference location
**X**: x-coordinate of location(specify either**X**and**Y**or**LON**and**LAT**).**Y**: y-coordinate of location (specify either**X**and**Y**or**LON**und**LAT**).**LON**: longitude of location (specify either**X**and**Y**or**LON**and**LAT**).**LAT**: latitude of location (specify either**X**and**Y**or**LON**and**LAT**).**Z**: z-coordinate of location (positive downwards).**Rank**:*rank*of location(not for*reference location phase*).**Previous_Rank**: refers to the*rank*of the previous location (not for*reference location tide*and*reference location phase*).

- Block
**Input_Variables**: names(s) for variables to be analysed**Name**: name of variable to be analysed (must be a valid CF NetCDF variable name from the input data file).

- Block
**Data_Analysis**: type of analysis and CF NetCDF file for result data**Type**: type of analysis:**TDKW**= Tidal Characteristic Numbers of Water Level;**TDKV**= Tidal Characteristic Numbers of Current;**TDXF**= Tidal Characteristic Numbers of Water Transport;**TDKS**or**TDWS**= Tidal Characteristic Numbers of Salinity;**TDXS**= Tidal Characteristic Numbers of Salt Transport;**TDKT**= Tidal Characteristic Numbers of Temperature;**TDXT**= Tidal Characteristic Numbers of Heat Transport;**TDKC**= Tidal Characteristic Numbers of Suspended Sediment;**TDXC**= Tidal Characteristic Numbers of Suspended Load Transport;**TDKP**= Tidal Characteristic Numbers of Tracer Load;**TDXP**= Tidal Characteristic Numbers of Tracer Load Transport;**TDKB**= Tidal Characteristic Numbers of Effective Bed Shear Stress;**TDKG**= Tidal Characteristic Numbers of Bed Load Transport;**TDKA**= Tidal Characteristic Numbers of Potential Energy Anomaly;**FRQW**= Harmonic Analysis of Water Level (tidal constituents);**FRQV**= Harmonic Analysis of Current Velocity (tidal constituents);**LZKW**= Characteristic Numbers of Water Level (independent of tides);**LZKV**= Characteristic Numbers of Current Velocity (independent of tides);**LZKS**= Characteristic Numbers of Salinity (independent of tides);**LZKT**= Characteristic Numbers of Temperature (independent of tides);**LZKC**= Characteristic Numbers of Suspended Sediment Concentration (independent of tides);**LZKP**= Characteristic Numbers of Tracer Load (independent of tides);**LZKO**= Characteristic Numbers of Oxygen Concentration (independent of tides);**LZKM**= Characteristic Numbers of Morphodynamics (independent of tides);**LZKG**= Characteristic Numbers of Bed Load Transport (independent of tides);**LZKB**= Characteristic Numbers of Eff. Bed Shear Stress (independent of tides);**LZKA**= Characteristic Numbers of Potential Energy Anomaly (independent of tides);**LZXF**= Characteristic Numbers of Water Transport (independent of tides);**LZXS**= Characteristic Numbers of Salt Transport (independent of tides);**LZXT**= Characteristic Numbers of Heat Transport (independent of tides);**LZXP**= Characteristic Numbers of Tracer Transport (independent of tides);**LZXC**= Characteristic Numbers of Suspended Sediment Transport (independent of tides);**LZXG**= Characteristic Numbers of Sediment Transport (independent of tides) (bed and suspended load at the bottom);**LZXE**= Characteristic Numbers of Tidal Energy Transport;**LZMW**= Characteristic Numbers of Meteorological Data (Wind Speed);**LZSS**= Characteristic Numbers for Wave and Sea State (significant wave height).

**Result_File**: name and type (NETCDF) of the result file (filetype cf-netcdf.nc).

**Optional Input Blocks**for different analyses

- To specify meaningful
*bounds*, which are the interval boundaries for the various frequency distributions computed, the range of the physical quantity under consideration should be evaluated before, e.g. using program NCAUTO.- optional for
**TDKW**:- Block
**TDKW_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- optional for
**TDKV**:- Block
**TDKV_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- optional for
**TDKS**or**TDWS**:- Block
**TDKS_Quantiles**or**TDWS_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- optional for
**TDKT**:- Block
**TDKT_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- optional for
**TDKC**:- Block
**TDKC_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- optional for
**TDKP**:- Block
**TDKP_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- optional for
**TDKG**:- Block
**TDKG_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- optional for
**TDKB**:- Block
**TDKB_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- optional for
**TDKA**:- Block
**TDKA_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- optional for
**FRQW**and**FRQV**:- Block
**Tidal_Constituents**: list of tidal constituents**Value**: code of tidal constituent, e. g. Mm, Mf, K_1, O_1, S_2, M_2, M_4, M_6, M_8.

- Block

- optional for

**Optional Required Input Blocks**for different analyses

- To specify meaningful
*bounds*, which are the interval boundaries for the various frequency distributions computed, the range of the physical quantity under consideration should be evaluated before, e.g. using program NCAUTO.- required for
**LZKW**:- Block
**Water_Level_Bounds**: definition of classes for water level.**Interval**: lower and upper bound of classes (intervals).

- Block
**Water_Level_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKV**:- Block
**Current_Velocity_Bounds**: definition of classes for current velocity.**Interval**: lower and upper bound of classes (intervals).

- Block
**Current_Velocity_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKS**:- Block
**Salinity_Bounds**: definition of classes for salinity.**Interval**: lower and upper bound of classes (intervals).

- Block
**Salinity_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKT**:- Block
**Temperature_Bounds**: definition of classes for temperature.**Interval**: lower and upper bound of classes (intervals).

- Block
**Temperature_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKC**:- Block
**Suspended_Sediment_Bounds**: definition of classes for suspended sediment concentration.**Interval**: lower and upper bound of classes (intervals).

- Block
**Suspended_Sediment_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKP**:- Block
**Tracer_Bounds**: definition of classes for tracer load.**Interval**: lower and upper bound of classes (intervals).

- Block
**Tracer_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKO**:- Block
**Oxygen_Bounds**: definition of classes for oxygen concentration.**Interval**: lower and upper bound of classes (intervals).

- Block
**Oxygen_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKM**:- Block
**Bathymetry_Bounds**: definition of classes for bathymetry.**Interval**: lower and upper bound of classes (intervals).

- Block
**Bathymetry_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKG**:- Block
**Bedload_Bounds**: definition of classes for bedload transport.**Interval**: lower and upper bound of classes (intervals).

- Block
**Bedload_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKB**:- Block
**Bedfriction_Bounds**: definition of classes for eff. bed shear stress.**Interval**: lower and upper bound of classes (intervals).

- Block
**Bedfriction_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZKA**:- Block
**PE_Anomaly_Bounds**: definition of classes for PEA.**Interval**: lower and upper bound of classes (intervals).

- Block
**PE_Anomaly_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZMW**:- Block
**Wind_Bounds**: definition of classes for wind speed.**Interval**: lower and upper bound of classes (intervals).

- Block
**Wind_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block
- required for
**LZSS**:- Block
**Sig_Wave_Bounds**: definition of classes for significant wave height.**Interval**: lower and upper bound of classes (intervals).

- Block
**Sig_Wave_Quantiles**: definition of quantiles.**Value**: quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5.

- Block

- required for

### General Remarks

- Dictionary files used from directory
:**$PROGHOME/dic/**and**ncanalyse_dico.dat**.**ncanalyse_config_dico.dat**

- Standard configuration files used from directory
:**$PROGHOME/cfg/****TDKW_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Water Level;**TDKV_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Current;**TDXF_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Water Transport;**TDKS_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Salinity;**TDXS_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Salt Transport;**TDKT_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Temperature;**TDXT_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Heat Transport;**TDKC_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Suspended Sediment;**TDXC_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Suspended Load Transport;**TDKP_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Tracer Load;**TDXP_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Tracer Load Transport;**TDKB_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Effective Bed Shear Stress;**TDKG_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Bed Load Transport;**TDKA_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Potential Energy Anomaly;**FRQW_ncanalyse_cfg.dat**: definition file for Harmonic Analysis of Water Level;**FRQV_ncanalyse_cfg.dat**: definition file for Harmonic Analysis of Current Velocity;**LZKW_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Water Level (independent of tides);**LZKV_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Current Velocity (independent of tides);**LZKS_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Salinity (independent of tides);**LZKT_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Temperature (independent of tides);**LZKC_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Suspended Sediment Concentration (independent of tides);**LZKP_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Tracer Load (independent of tides);**LZKO_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Oxygen Concentration (independent of tides);**LZKM_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Morphodynamics (independent of tides);**LZKG_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Bed Load Transport (independent of tides);**LZKB_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Eff. Bed Shear Stress (independent of tides);**LZKA_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Potential Energy Anomaly (independent of tides);**LZXF_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Water Transport (independent of tides);**LZXS_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Salt Transport (independent of tides);**LZXT_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Heat Transport (independent of tides);**LZXP_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Tracer Transport (independent of tides);**LZXC_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Suspended Sediment Transport (independent of tides);**LZXG_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Sediment Transport (independent of tides) (bed an suspended load at the bottom);**LZXE_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Tidal Energy Transport;**LZMW_ncanalyse_cfg.dat**: definition file for Characteristic Numbers of Meteorological Data (Wind Speed);**LZSS_ncanalyse_cfg.dat**: definition file for Characteristic Numbers for Wave and Sea State (significant wave height).

## Programs using this Type of File

### Example-File

$PROGHOME/examples/ncanalyse/ncanalyse.dat

back to: File Descriptions