# Difference between revisions of "NCANALYSE.DAT"

### From BAWiki

imported>Lang Guenther (new featres "characteristic numbers of temperature (independent of tides)" and "characteristic numbers of sediment transport (independent of tides)" added to page) |
imported>Lang Guenther (modification added for "Characteristic Numbers of Oxygen Concentration (independent of tides)") |
||

Line 49: | Line 49: | ||

*#* '''LZKC''' = [[Characteristic Numbers of Suspended Sediment Concentration (independent of tides)]]; | *#* '''LZKC''' = [[Characteristic Numbers of Suspended Sediment Concentration (independent of tides)]]; | ||

*#* '''LZKP''' = [[Characteristic Numbers of Tracer Load (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)]]; | *#* '''LZKM''' = [[Characteristic Numbers of Morphodynamics (independent of tides)]]; | ||

*#* '''LZKG''' = [[Characteristic Numbers of Bed Load Transport (independent of tides)]]; | *#* '''LZKG''' = [[Characteristic Numbers of Bed Load Transport (independent of tides)]]; | ||

Line 91: | Line 92: | ||

:**# '''Interval''': lower and upper bound of classes (intervals). | :**# '''Interval''': lower and upper bound of classes (intervals). | ||

:** Block '''Tracer_Quantiles''': definition of quantiles. | :** Block '''Tracer_Quantiles''': definition of quantiles. | ||

+ | :**# '''Value''': quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5. | ||

+ | :* 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. | :**# '''Value''': quantile from interval ] 0.0, 1.0 [; for median choose Value = 0.5. | ||

:* required for '''LZKM''': | :* required for '''LZKM''': | ||

Line 122: | Line 128: | ||

#* '''LZKC_ncanalyse_cfg.dat''': definition file for [[Characteristic Numbers of Suspended Sediment Concentration (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)]]; | #* '''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)]]; | #* '''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)]]; | #* '''LZKG_ncanalyse_cfg.dat''': definition file for [[Characteristic Numbers of Bed Load Transport (independent of tides)]]; |

## Revision as of 10:38, 9 March 2016

## Basic Information

### File-Type

ncanalyse.dat

### File-Form

FORMATTED

### Version

March 2016

### Description-Date

March 2016

## 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.

- 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).

- 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;**TDKS**= Tidal Characteristic Numbers of Salinity;**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);**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.

**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.- 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

### 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;**TDKS_ncanalyse_cfg.dat**: definition file for Tidal Characteristic Numbers of Salinity;**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);**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;

## Programs using this Type of File

### Example-File

$PROGHOME/examples/ncanalyse/ncanalyse.dat

back to: File Descriptions