NCANALYSE

Basic Information

Name of Program

NCANALYSE

Version-Date

March 2023

Description-Date

September 2022

Catchwords

data analysis
postprocessor
synoptic data sets
measured time series data (optionally with flag variables for a more detailed qualification of data)
depth averaged (2D) and depth structured data (3D) with z-layers
tidal characteristic numbers of water level
tidal characteristic numbers of current, tidal characteristic numbers of water transport
tidal characteristic numbers of salinity, tidal characteristic numbers of salt transport
tidal characteristic numbers of temperature, tidal characteristic numbers of heat transport
tidal characteristic numbers of suspended sediment, tidal characteristic numbers of suspended load transport
tidal characteristic numbers of tracer load, tidal characteristic numbers of tracer load transport
tidal characteristic numbers of effective bed shear stress
tidal characteristic numbers of bed load transport
tidal characteristic numbers of potential energy anomaly
harmonic analysis of water level
harmonic analysis of current velocity
characteristic numbers of water level (independent of tides)
characteristic numbers of current velocity (independent of tides)
characteristic numbers of salinity (independent of tides)
characteristic numbers of temperature (independent of tides)
characteristic numbers of suspended sediment concentration (independent of tides)
characteristic numbers of tracer load (independent of tides)
characteristic numbers of oxygen concentration (independent of tides)
characteristic numbers of morphodynamics (independent of tides)
characteristic numbers of bedload transport (independent of tides)
characteristic numbers of effective bed shear stress (independent of tides)
characteristic numbers of water transport (independent of tides)
characteristic numbers of salt transport (independent of tides)
characteristic numbers of heat transport (independent of tides)
characteristic numbers of tracer transport (independent of tides)
characteristic numbers of suspended sediment transport (independent of tides)
characteristic numbers of sediment transport (independent of tides) (bed and suspended load at the bottom)
characteristic numbers of tidal energy transport
characteristic numbers of potential energy anomaly
characteristic numbers of meteorological data (wind speed)
characteristic numbers for wave and sea state (significant wave height)
CF NetCDF format for 2D/3D data
orthogonal unstructured grid model
orthogonal unstructured grid model with subgrid information
data at individual locations (Discrete Sampling Geometry featureType = timeSeriesProfile)
data at multiple locations along trajectories (Discrete Sampling Geometry featureType = trajectoryProfile)
parallelization using OpenMP and MPI
automatic quality assurance (value range)
automatic adjustment of number of READ data to chunk size of data
automatic setting of WRITE chunk sizes for written variables
Storage of the content of the ASCII input control files in netcdf.nc (as a variable)
Storage of MD5 hash values ​​of input files in netcdf.nc (as a variable)
optional closing of data gaps at reference positions by interpolation

Acknowledgment: This project took advantage of netCDF software developed by UCAR/Unidata (www.unidata.ucar.edu/software/netcdf/).

Short Description of Functionality

Program NCANALYSE serves as an analysis program for data stored in CF netCDF data files.

Input-Files

1. general input data (file type ncanalyse.dat);
2. synoptic data sets (file type CF-NETCDF.NC);
3. for automatic quality assurance (file type bounds_verify.dat).

Output-Files

1. data analysis result files (file type CF-NETCDF.NC)
2. (optional) informative printer file of program execution (file type ncanalyse.sdr)
3. (optional) trace of program execution (file type ncanalyse.trc)

Methodology

The following data analysis methods are currently available:

• Tidal Characteristic Numbers:
  1. Tidal Characteristic Numbers of Water Level;
  2. Tidal Characteristic Numbers of Current;
  3. Tidal Characteristic Numbers of Salinity;
  4. Tidal Characteristic Numbers of Temperature;
  5. Tidal Characteristic Numbers of Suspended Sediment;
  6. Tidal Characteristic Numbers of Tracer Load;
  7. Tidal Characteristic Numbers of Effective Bed Shear Stress;
  8. Tidal Characteristic Numbers of Bed Load Transport;
  9. Tidal Characteristic Numbers of Potential Energy Anomaly.
• Tide-dependent Characteristic Numbers for Transport-Processes (based on exact integrals):
  1. Tidal Characteristic Numbers of Water Transport;
  2. Tidal Characteristic Numbers of Salt Transport;
  3. Tidal Characteristic Numbers of Heat Transport;
  4. Tidal Characteristic Numbers of Suspended Load Transport;
  5. Tidal Characteristic Numbers of Tracer Load Transport.
• Harmonic Analysis:
  1. Harmonic Analysis of Water Level;
  2. Harmonic Analysis of Current Velocity.
• Tide-Independent Characteristic Numbers:
  1. Characteristic Numbers of Water Level (independent of tides);
  2. Characteristic Numbers of Current Velocity (independent of tides);
  3. Characteristic Numbers of Salinity (independent of tides);
  4. Characteristic Numbers of Temperature (independent of tides);
  5. Characteristic Numbers of Suspended Sediment Concentration (independent of tides);
  6. Characteristic Numbers of Tracer Load (independent of tides);
  7. Characteristic Numbers of Oxygen Concentration (independent of tides);
  8. Characteristic Numbers of Morphodynamics (independent of tides);
  9. Characteristic Numbers of Bed Load Transport (independent of tides);
  10. Characteristic Numbers of Eff. Bed Shear Stress (independent of tides);
  11. Characteristic Numbers of Potential Energy Anomaly (independent of tides).
• Tide-Independent Characteristic Numbers for Transport-Processes (based on exact integrals):
  1. Characteristic Numbers of Water Transport (independent of tides);
  2. Characteristic Numbers of Water Transport (independent of tides);
  3. Characteristic Numbers of Salt Transport (independent of tides);
  4. Characteristic Numbers of Heat Transport (independent of tides);
  5. Characteristic Numbers of Tracer Transport (independent of tides);
  6. Characteristic Numbers of Suspended Sediment Transport (independent of tides);
  7. Characteristic Numbers of Sediment Transport (independent of tides) (bed an suspended load at the bottom).
• Tidal Energy Transport:
  1. Characteristic Numbers of Tidal Energy Transport
• Characteristic Numbers of Meteorological Data:
  1. wind speed.
• Characteristic Numbers for Wave and Sea State:
  1. significant wave height.

Just in case HDF error is detected during read of a data record, the program tries to reconstruct the wanted data set from adjacent (in time) records for the same variable. This type of repair works for time dependent variables only.

Program(s) to run before this Program

BOE2NC, DATACONVERT, GRIDCONVERT, NCAGGREGATE, NCCHUNKIE, NCCUTOUT, NCDVAR, NCMERGE, NetCDF Operators, QUICKPLOT, UNTRIM2007, UNTRIM2

Program(s) to run after this Program

DAVIT, DISPLAY_CONTROL_VOLUMES, NCAGGREGATE, NCAUTO, NCCHUNKIE, NCCUTOUT, NCDELTA, NCDVAR, NCPLOT, NC2TABLE, PLOTPROFILZEIT, PLOTTS

Additional Information

Language

Fortran95

Additional software

---

Original Version

G. Lang

Maintenance

Working group POS

Documentation/Literature

• Presentations (many available in German only):
  • 2021-06-16: Tidal Asymmetry - Classical Parameters vs Skewness (DOI: http://doi.org/10.13140/RG.2.2.20390.45120);
  • 2015-05-29: Tidewelle und Energietransport (DOI: http://dx.doi.org/10.13140/RG.2.2.31352.14089);
  • 2014-12-03: NCANALYSE - Tideunabhängige Kennwerte des Salzgehalts;
  • 2014-12-03: NCANALYSE - Tidekennwerte des Salzgehalts;
  • 2014-10-08: NCANALYSE - Tideunabhängige Kennwerte der Strömung;
  • 2014-09-10: NCANALYSE - Tidekennwerte der Strömung;
  • 2013-08-07: NCANALYSE - Tideunabhängige Kennwerte des Wasserstands;
  • 2013-05-15: NCANALYSE - Daten aus CF netCDF Dateien analysieren.
• IZW-Campus (Podcast, available in German only)
  • 2022-04-25: NCANALYSE - Grundlagen am Beispiel der Analyse LZKW (tideunabhängige Kennwerte des Wasserstands);
  • 2022-03-21: Energietransport einer Tidewelle;
  • 2021-11-29: NCANALYSE - Grundlagen - Wechselwirkung zwischen Salzgehalt und Schwebstoffgehalt;
  • 2021-10-18: NCANALYSE - Grundlagen verschiedener Kennwerte (Einfluss des Salzgehalts auf verschiedene Kenngrößen);
  • 2021-09-13: NCANALYSE - Grundlagen TDKA (Tidekennwerte der Anomalie der Potentiellen Energie);
  • 2021-08-09: NCANALYSE - Grundlagen TDKS (Tidekennwerte des Salzgehalts);
  • 2021-06-07: NCANALYSE Update zu Skewness - aus Partialtiden des Wasserstands und der Strömung;
  • 2021-04-19: NCANALYSE - Grundlagen am Beispiel der Analyse FRQV (Harmonische Analyse der Strömung);
  • 2021-03-08: NCANALYSE - Grundlagen am Beispiel der Analyse FRQW (Harmonische Analyse des Wasserstands);
  • 2021-02-08: NCANALYSE - Grundlagen am Beispiel der Analyse TDKV (Tidekennwerte der Strömungsgeschwindigkeit);
  • 2021-01-11: NCANALYSE - Grundlagen am Beispiel der Analyse TDKW (Tidekennwerte des Wasserstands).
• Template input files:
  • template files available in $PROGHOME/examples/ncanalyse

---

back to Program Descriptions

---

Overview