Actions

File

Difference between pages "TdksBspSmEMin.png" and "NCDELTA"

From BAWiki

(Difference between pages)
imported>Spohr Susanne
(TDKS Example: mean salinity ebb current (minimum))
 
imported>Lang Guenther
(HDF Error added)
 
Line 1: Line 1:
TDKS Example: mean salinity ebb current (minimum)
+
{{ProgramDescription
 +
|name_de=NCDELTA
 +
|name=NCDELTA
 +
|version=February 2017
 +
|version_descr=February 2017
 +
|catchwords=
 +
postprocessor<br />
 +
differences of synoptic data<br />
 +
differences of characteristic numbers<br />
 +
differences for extensive quantities<br />
 +
input data for Taylor diagram<br />
 +
median, percentiles (Q01, Q05, Q95, Q99)<br />
 +
parallelization using [http://openmp.org/wp/ OpenMP]<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/]).''
 +
 
 +
|shortdescription=
 +
Program computes differences for comparable variables (primary variable pairs) as well as additional statistical data derived from primary differences, but also data for Taylor diagrams (details see [[Differences of Calculated Results]]) can be computed for some types of data. Finding the primary variable pairs is done in an essentially automatical manner but can be altered to some extent by the user (see [[NCDELTA.DAT|ncdelta.dat]]). Primary differences are computed according to ''variant data'' '''minus''' ''reference data''.
 +
 
 +
Requirements for time-dependent primary variable pairs:
 +
# both data sets must contain an ''identical'' number of data items (time steps), with periods allowed to be different;
 +
# for data sets with constant time step, the respective time steps must be identical.
 +
 
 +
Remarks concerning the spatial location of data:
 +
# data sets may differ with respect to their geographical location;
 +
# areas for which data are defined must overlap to some degree;
 +
# coordinates may be given in different coordinate systems, e. g. Gauß-Krüger and UTM;
 +
# data for a location are compared with data for the nearest lying location, as far as the distance between the different locations does not exceed a prescribed maximum (see [[NCDELTA.DAT|ncdelta.dat]]).
 +
 
 +
Remarks concerning the comparison of extensive variables:
 +
# for extensive variables the respective sizes of the computational cells (area, length) are taken into account.
 +
 
 +
|inputfiles=
 +
# '''general input data''' (file type [[NCDELTA.DAT|ncdelta.dat]])
 +
# '''reference data''' (file type [[CF-NETCDF.NC]])
 +
# '''variant data''' (file type [[CF-NETCDF.NC]])
 +
 
 +
|outputfiles= 
 +
# '''results''' (file type [[CF-NETCDF.NC]])
 +
# (optional) informative '''printer file''' of program execution (file type ncdelta.sdr)
 +
# (optional) '''trace''' of program execution (file type ncdelta.trc)
 +
 
 +
|methodology=
 +
The program is subdivided into the following sections:
 +
# read, check and print steering data prescribed by the user;
 +
# read metadata for ''reference data'';
 +
# read metadata for ''variant data'';
 +
# copy metadata for reference as well as variant data to program specific data structures;
 +
# compare metadata for substantial discrepancies (e. g. reference locations) between data sets;
 +
# classify all reference as well as variant data;
 +
# find primary variable pairs: each variant variable has one partner reference variable; primary computational results will be later derived from primary variable pairs;
 +
# derive variables to be copied from reference as well as variant data file into the result file;
 +
# compute interpolation matrices required for interpolation between reference data locations and variant data locations;
 +
# create all metadata for the result file; essentially they stem from variables to be copied, from primary result variables, newly generated coordinate variables (time, vertical), as well as newly derived or to be copied measure and auxiliary variables;
 +
# copy selceted variables from reference as well as variant file to the result file;
 +
# compute all primary variables, (new) time and vertical coordinate variables, as well as weights and auxiliary variables. 
 +
 
 +
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]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCRCATMAT]], [[NetCDF Operators]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
 +
|postprocessor=DAVIT, [[NCAUTO]], [[NCPLOT]], [[PLOTTS]], [[TAYLORDIAGRAM]]
 +
|language=Fortran95
 +
|add_software=none
 +
|contact_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
 +
|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. SPohr]
 +
|documentation=
 +
* Presentations (available in German only):
 +
** 2015-07-15: [http://ewisa.baw.de/files/12835_tv12_2015_07_15_ncdelta_g_lang.pdf ''NCDELTA - Differenzen neu berechnet''].
 +
* Template Files:
 +
** template files available in '''$PROGHOME/examples/ncdelta'''
 +
}}

Revision as of 09:22, 3 February 2017

Basic Information

Name of Program

NCDELTA

Version-Date

February 2017

Description-Date

February 2017

Catchwords

postprocessor
differences of synoptic data
differences of characteristic numbers
differences for extensive quantities
input data for Taylor diagram
median, percentiles (Q01, Q05, Q95, Q99)
parallelization using OpenMP

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

Short Description of Functionality

Program computes differences for comparable variables (primary variable pairs) as well as additional statistical data derived from primary differences, but also data for Taylor diagrams (details see Differences of Calculated Results) can be computed for some types of data. Finding the primary variable pairs is done in an essentially automatical manner but can be altered to some extent by the user (see ncdelta.dat). Primary differences are computed according to variant data minus reference data.

Requirements for time-dependent primary variable pairs:

  1. both data sets must contain an identical number of data items (time steps), with periods allowed to be different;
  2. for data sets with constant time step, the respective time steps must be identical.

Remarks concerning the spatial location of data:

  1. data sets may differ with respect to their geographical location;
  2. areas for which data are defined must overlap to some degree;
  3. coordinates may be given in different coordinate systems, e. g. Gauß-Krüger and UTM;
  4. data for a location are compared with data for the nearest lying location, as far as the distance between the different locations does not exceed a prescribed maximum (see ncdelta.dat).

Remarks concerning the comparison of extensive variables:

  1. for extensive variables the respective sizes of the computational cells (area, length) are taken into account.

Input-Files

  1. general input data (file type ncdelta.dat)
  2. reference data (file type CF-NETCDF.NC)
  3. variant data (file type CF-NETCDF.NC)

Output-Files

  1. results (file type CF-NETCDF.NC)
  2. (optional) informative printer file of program execution (file type ncdelta.sdr)
  3. (optional) trace of program execution (file type ncdelta.trc)

Methodology

The program is subdivided into the following sections:

  1. read, check and print steering data prescribed by the user;
  2. read metadata for reference data;
  3. read metadata for variant data;
  4. copy metadata for reference as well as variant data to program specific data structures;
  5. compare metadata for substantial discrepancies (e. g. reference locations) between data sets;
  6. classify all reference as well as variant data;
  7. find primary variable pairs: each variant variable has one partner reference variable; primary computational results will be later derived from primary variable pairs;
  8. derive variables to be copied from reference as well as variant data file into the result file;
  9. compute interpolation matrices required for interpolation between reference data locations and variant data locations;
  10. create all metadata for the result file; essentially they stem from variables to be copied, from primary result variables, newly generated coordinate variables (time, vertical), as well as newly derived or to be copied measure and auxiliary variables;
  11. copy selceted variables from reference as well as variant file to the result file;
  12. compute all primary variables, (new) time and vertical coordinate variables, as well as weights and auxiliary variables.

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

DATACONVERT, NCAGGREGATE, NCANALYSE, NCRCATMAT, NetCDF Operators, UNK, UNTRIM2007, UNTRIM2

Program(s) to run after this Program

DAVIT, NCAUTO, NCPLOT, PLOTTS, TAYLORDIAGRAM

Additional Information

Language

Fortran95

Additional software

none

Original Version

G. Lang, S. Spohr

Maintenance

G. Lang, S. SPohr

Documentation/Literature


back to Program Descriptions


Overview

File history

Click on a date/time to view the file as it appeared at that time.

Date/TimeThumbnailDimensionsUserComment
current08:51, 25 September 2019Thumbnail for version as of 08:51, 25 September 20191,260 × 882 (26 KB)Maintenance script (talk | contribs)
  • You cannot overwrite this file.

The following page links to this file:

Metadata