NCANALYSE: Difference between revisions

Latest revision as of 13:16, 29 March 2023

Basic Information

Name of Program

NCANALYSE

Version-Date

March 2023

Description-Date

September 2022

Catchwords

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

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

Output-Files

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

Methodology

The following data analysis methods are currently available:

Tidal Characteristic Numbers:
Tide-dependent Characteristic Numbers for Transport-Processes (based on exact integrals):
Harmonic Analysis:
1. Harmonic Analysis of Water Level;
2. Harmonic Analysis of Current Velocity.
Tide-Independent Characteristic Numbers:
Tide-Independent Characteristic Numbers for Transport-Processes (based on exact integrals):
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

@@ Line 2: / Line 2: @@
 |name_de=NCANALYSE
 |name=NCANALYSE
-|version=March 2016
+|version=March 2023
-|version_descr=March 2016
+|version_descr=September 2022
 |catchwords=
 data analysis<br />
 postprocessor<br />
 synoptic data sets<br />
+measured time series data (optionally with [http://cfconventions.org/Data/cf-conventions/cf-conventions-1.6/build/cf-conventions.html#flags flag variables] for a more detailed qualification of data) <br />
+depth averaged (2D) and depth structured data (3D) with z-layers<br />
 [[Tidal Characteristic Numbers of Water Level|tidal characteristic numbers of water level]] <br />
-[[Tidal Characteristic Numbers of Current|tidal characteristic numbers of current]] <br />
+[[Tidal Characteristic Numbers of Current|tidal characteristic numbers of current]], [[Tidal Characteristic Numbers of Water Transport|tidal characteristic numbers of water transport]] <br />
-[[Tidal Characteristic Numbers of Salinity|tidal characteristic numbers of salinity]] <br />
+[[Tidal Characteristic Numbers of Salinity|tidal characteristic numbers of salinity]], [[Tidal Characteristic Numbers of Salt Transport|tidal characteristic numbers of salt transport]] <br />
-[[Tidal Characteristic Numbers of Temperature|tidal characteristic numbers of temperature]] <br />
+[[Tidal Characteristic Numbers of Temperature|tidal characteristic numbers of temperature]], [[Tidal Characteristic Numbers of Heat Transport|tidal characteristic numbers of heat transport]] <br />
+[[Tidal Characteristic Numbers of Suspended Sediment Transport|tidal characteristic numbers of suspended sediment]],
+[[Tidal Characteristic Numbers of Suspended Load Transport|tidal characteristic numbers of suspended load transport]] <br />
+[[Tidal Characteristic Numbers of Tracer Load|tidal characteristic numbers of tracer load]], [[Tidal Characteristic Numbers of Tracer Load Transport|tidal characteristic numbers of tracer load transport]]<br />
+[[Tidal Characteristic Numbers of Eff. Bed Shear Stress Action|tidal characteristic numbers of effective bed shear stress]]<br />
+[[Tidal Characteristic Numbers of Bed Load Transport|tidal characteristic numbers of bed load transport]]<br />
+[[Tidal Characteristic Numbers of Potential Energy Anomaly|tidal characteristic numbers of potential energy anomaly]]<br />
+[[Harmonic Analysis of Water Level|harmonic analysis of water level]]<br />
+[[Harmonic Analysis of Current Velocity|harmonic analysis of current velocity]]<br />
 [[Characteristic Numbers of Water Level (independent of tides)|characteristic numbers of water level (independent of tides)]] <br />
 [[Characteristic Numbers of Current Velocity (independent of tides)|characteristic numbers of current velocity (independent of tides)]] <br />
@@ Line 32: / Line 42: @@
 [[Characteristic Numbers of Sediment Transport (independent of tides)|characteristic numbers of sediment transport (independent of tides)]] (bed and suspended load at the bottom)<br />
 [[Characteristic Numbers of Tidal Energy Transport|characteristic numbers of tidal energy transport]]<br />
+[[Characteristic Numbers of Potential Energy Anomaly (independent of tides)|characteristic numbers of potential energy anomaly]]<br />
+[[Characteristic Numbers of Meteorological Data (independent of tides)|characteristic numbers of meteorological data (wind speed)]] <br />
+[[Characteristic Numbers for Wave and Sea State (independent of tides)|characteristic numbers for wave and sea state (significant wave height)]] <br />
 [[NetCDF|CF NetCDF]] format for 2D/3D data<br />
 orthogonal unstructured grid model<br />
 orthogonal unstructured grid model with subgrid information<br />
-parallelization using [http://openmp.org/wp/ OpenMP] and [http://en.wikipedia.org/wiki/Message_Passing_Interface MPI] (MPI ist not available for the August 2014 version)<br />
+data at individual locations (''Discrete Sampling Geometry'' featureType = '''timeSeriesProfile''')<br />
+data at multiple locations along trajectories (''Discrete Sampling Geometry'' featureType = '''trajectoryProfile''')<br />
+parallelization using [http://openmp.org/wp/ OpenMP] and [http://en.wikipedia.org/wiki/Message_Passing_Interface MPI]<br />
+[[NetCDF#Quality assurance using NetCDF attributes|automatic quality assurance (value range)]]<br />
+automatic adjustment of number of READ data to chunk size of data<br />
+automatic setting of WRITE chunk sizes for written variables<br />
+Storage of the content of the ASCII input control files in [[CF-NETCDF.NC|netcdf.nc]] (as a variable)<br />
+Storage of [https://en.wikipedia.org/wiki/MD5 MD5 hash values] of input files in [[CF-NETCDF.NC|netcdf.nc]] (as a variable)<br />
+optional closing of data gaps at reference positions by interpolation <br />
   Acknowledgment: ''This project took advantage of netCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ www.unidata.ucar.edu/software/netcdf/]).''
@@ Line 43: / Line 64: @@
 |inputfiles=
-# '''general input data''' (file type [[NCANALYSE.DAT|ncanalyse.dat]])
+# '''general input data''' (file type [[NCANALYSE.DAT|ncanalyse.dat]]);
-# '''synoptic data sets''' (file type [[CF-NETCDF.NC]])
+# '''synoptic data sets''' (file type [[CF-NETCDF.NC]]);
+# for [[NetCDF#Automatic quality assurance using NetCDF attributes|automatic quality assurance]] (file type [[BOUNDS.CFG.DAT|bounds_verify.dat]]).
 |outputfiles=
@@ Line 58: / Line 79: @@
 *# [[Tidal Characteristic Numbers of Current]];
 *# [[Tidal Characteristic Numbers of Salinity]];
-*# [[Tidal Characteristic Numbers of Temperature]].
+*# [[Tidal Characteristic Numbers of Temperature]];
+*# [[Tidal Characteristic Numbers of Suspended Sediment Transport|Tidal Characteristic Numbers of Suspended Sediment]];
+*# [[Tidal Characteristic Numbers of Tracer Load]];
+*# [[Tidal Characteristic Numbers of Eff. Bed Shear Stress Action|Tidal Characteristic Numbers of Effective Bed Shear Stress]];
+*# [[Tidal Characteristic Numbers of Bed Load Transport]];
+*# [[Tidal Characteristic Numbers of Potential Energy Anomaly]].
+* Tide-dependent Characteristic Numbers for Transport-Processes (based on ''exact'' integrals):
+*# [[Tidal Characteristic Numbers of Water Transport]];
+*# [[Tidal Characteristic Numbers of Salt Transport]];
+*# [[Tidal Characteristic Numbers of Heat Transport]];
+*# [[Tidal Characteristic Numbers of Suspended Load Transport]];
+*# [[Tidal Characteristic Numbers of Tracer Load Transport]].
+* Harmonic Analysis:
+*# [[Harmonic Analysis of Water Level]];
+*# [[Harmonic Analysis of Current Velocity]].
 * Tide-Independent Characteristic Numbers:
 *# [[Characteristic Numbers of Water Level (independent of tides)]];
@@ Line 69: / Line 104: @@
 *# [[Characteristic Numbers of Morphodynamics (independent of tides)]];
 *# [[Characteristic Numbers of Bed Load Transport (independent of tides)]];
-*# [[Characteristic Numbers of Eff. Bed Shear Stress (independent of tides)]]. <br />
+*# [[Characteristic Numbers of Eff. Bed Shear Stress (independent of tides)]];
+*# [[Characteristic Numbers of Potential Energy Anomaly (independent of tides)]].
 * Tide-Independent Characteristic Numbers for Transport-Processes (based on ''exact'' integrals):
 *# [[Characteristic Numbers of Water Transport (independent of tides)]];
@@ Line 80: / Line 116: @@
 * Tidal Energy Transport:
 *# [[Characteristic Numbers of Tidal Energy Transport]]
+* Characteristic Numbers of Meteorological Data:
+*# [[Characteristic Numbers of Meteorological Data (independent of tides)|wind speed]].
+* Characteristic Numbers for Wave and Sea State:
+*# [[Characteristic Numbers for Wave and Sea State (independent of tides)|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.
-|preprocessor=[[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NetCDF Operators]], [[QUICKPLOT]], [[UNTRIM2007]], [[UNTRIM2]]
+|preprocessor=[[BOE2NC]], [[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDVAR]], [[NCMERGE]], [[NetCDF Operators]], [[QUICKPLOT]], [[UNTRIM2007]], [[UNTRIM2]]
-|postprocessor=[[DISPLAY_CONTROL_VOLUMES]], [[NCAUTO]], [[NCDELTA]], [[NCPLOT]]
+|postprocessor=[[DAVIT]], [[DISPLAY_CONTROL_VOLUMES]], [[NCAGGREGATE]], [[NCAUTO]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCPLOT]], [[NC2TABLE]], [[PLOTPROFILZEIT]], [[PLOTTS]]
 |language=Fortran95
 |add_software=---
-|contact_original=[mailto:guenther.lang@baw.de G. Lang]
+|contact_original=G. Lang
-|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
+|contact_maintenance=[mailto:pos.proghome@baw.de Working group POS]
 |documentation=
-template files available in '''$PROGHOME/examples/ncanalyse'''
+* Presentations (many available in German only):
+** 2021-06-16: [http://doi.org/10.13140/RG.2.2.20390.45120 ''Tidal Asymmetry - Classical Parameters vs Skewness''] (DOI: [http://doi.org/10.13140/RG.2.2.20390.45120 http://doi.org/10.13140/RG.2.2.20390.45120]);
+** 2015-05-29: [http://ewisa.baw.de/files/12556_tv12_2015_05_29_tide_energie_transport_g_lang.pdf ''Tidewelle und Energietransport''] (DOI: [http://dx.doi.org/10.13140/RG.2.2.31352.14089 http://dx.doi.org/10.13140/RG.2.2.31352.14089]);
+** 2014-12-03: [http://ewisa.baw.de/files/11284_tv12_2014_12_03_ncanalyse_lzks_g_lang.pdf ''NCANALYSE - Tideunabhängige Kennwerte des Salzgehalts''];
+** 2014-12-03: [http://ewisa.baw.de/files/11285_tv12_2014_12_03_ncanalyse_tdks_g_lang.pdf ''NCANALYSE - Tidekennwerte des Salzgehalts''];
+** 2014-10-08: [http://ewisa.baw.de/files/10587_tv12_2014_10_08_ncanalyse_lzkv_g_lang.pdf ''NCANALYSE - Tideunabhängige Kennwerte der Strömung''];
+** 2014-09-10: [http://ewisa.baw.de/files/10588_tv12_2014_09_10_allgemein_g_lang.pdf ''NCANALYSE - Tidekennwerte der Strömung''];
+** 2013-08-07: [http://ewisa.baw.de/files/08510_speech_2013-08-07.pdf ''NCANALYSE - Tideunabhängige Kennwerte des Wasserstands''];
+** 2013-05-15: [http://ewisa.baw.de/files/08500_speech_2013-05-15.pdf ''NCANALYSE - Daten aus CF netCDF Dateien analysieren''].
+* [https://izw-campus.baw.de/ ''IZW-Campus''] (Podcast, available in German only)
+** 2022-04-25: [https://izw-campus.baw.de/goto.php?target=cat_4105&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse LZKW (tideunabhängige Kennwerte des Wasserstands)''];
+** 2022-03-21: [https://izw-campus.baw.de/goto.php?target=cat_3829&client_id=iliasclient ''Energietransport einer Tidewelle''];
+** 2021-11-29: [https://izw-campus.baw.de/goto.php?target=cat_3490&client_id=iliasclient ''NCANALYSE - Grundlagen - Wechselwirkung zwischen Salzgehalt und Schwebstoffgehalt''];
+** 2021-10-18: [https://izw-campus.baw.de/goto.php?target=cat_3301&client_id=iliasclient ''NCANALYSE - Grundlagen verschiedener Kennwerte (Einfluss des Salzgehalts auf verschiedene Kenngrößen)''];
+** 2021-09-13: [https://izw-campus.baw.de/goto.php?target=cat_3102&client_id=iliasclient ''NCANALYSE - Grundlagen TDKA (Tidekennwerte der Anomalie der Potentiellen Energie)''];
+** 2021-08-09: [https://izw-campus.baw.de/goto.php?target=cat_1830&client_id=iliasclient ''NCANALYSE - Grundlagen TDKS (Tidekennwerte des Salzgehalts)''];
+** 2021-06-07: [https://izw-campus.baw.de/goto.php?target=cat_2554&client_id=iliasclient ''NCANALYSE Update zu Skewness - aus Partialtiden des Wasserstands und der Strömung''];
+** 2021-04-19: [https://izw-campus.baw.de/goto.php?target=cat_2329&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse FRQV (Harmonische Analyse der Strömung)''];
+** 2021-03-08: [https://izw-campus.baw.de/goto.php?target=cat_2224&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse FRQW (Harmonische Analyse des Wasserstands)''];
+** 2021-02-08: [https://izw-campus.baw.de/goto.php?target=cat_1940&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse TDKV (Tidekennwerte der Strömungsgeschwindigkeit)''];
+** 2021-01-11: [https://izw-campus.baw.de/goto.php?target=cat_1853&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse TDKW (Tidekennwerte des Wasserstands)''].
+* Template input files:
+** template files available in '''$PROGHOME/examples/ncanalyse'''
 }}