Actions

Difference between pages "NCDELTA" and "NCDELTA.DAT"

From BAWiki

(Difference between pages)
imported>Schade Peter
m (+ davit)
 
imported>Lang Guenther
(text adjusted for latest version of ncdelta.dat)
 
Line 1: Line 1:
{{ProgramDescription
+
{{FileDescription
|name_de=NCDELTA
+
|name_de=NCDELTA.DAT
|name=NCDELTA
+
|filetype=ncdelta.dat
|version=February 2017
+
|version=not yet available
|version_descr=February 2017
+
|version_descr=June 2015
|catchwords=
+
|significance=contains general steering data for the program [[NCDELTA]].
postprocessor<br />
+
|filecontents=
differences of synoptic data<br />
+
'''steering data'''
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/]).''
+
* Block '''Program_Parameters''': general steering data
 +
*# '''Max_Read_Storage''': maximum number of data items read from input file during each analysis cycle.
 +
*# '''Max_Distance''': maximum distance in [m] up to which points with different location are compared.
 +
*# (optional) '''Print_Modus_Classify''': parameter to steer informative printout messages in program section ''classification'':
 +
*## '''0''' = no extensive messages printed;
 +
*## '''1''' = more extensive messages about classified variables will be printed.
 +
*# (optional) '''Print_Modus_Pairs''': parameter to steer informative printout messages in program section ''primary partner variables'':
 +
*## '''0''' = no extensive messages printed;
 +
*## '''1''' = more extensive messages about detected variable pairs will be printed;
 +
*## '''2''' = also informations about rejected variable pairs will be printed.
 +
*# (optional) '''Print_Modus_Define''': parameter to steer informative printout messages in program section ''definition of computational results'':
 +
*##'''0''' = no extensive messages printed;
 +
*## '''1''' = more extensive informations with respect to metadata of computational results will be printed.  
 +
*# (optional) '''Print_Modus_Compute''': parameter to steer informative printout messages in program section ''computation of results'':
 +
*##'''0''' = no extensive messages printed;
 +
*## '''1''' = more extensive messages about computational result variables will be printed.  
 +
* Block '''Data_Files''': data files
 +
*# '''Reference_File''': file (NETCDF) with '''reference''' data (filetype [[CF-NETCDF.NC|cf-netcdf.nc]]);
 +
*# '''Variant_File''': file (NETCDF) with '''variant''' data (filetype [[CF-NETCDF.NC|cf-netcdf.nc]]);
 +
*# '''Result_File''': file (NETCDF) for '''result''' data (filetype [[CF-NETCDF.NC|cf-netcdf.nc]]).
 +
* (optional) Block '''Data_Operations''': data operations
 +
*# (optional) '''With_Ordinary_Differences''': compute (.true.) common differences (if possible) or do not compute (.false.);
 +
*# (optional) '''With_Taylor_Diagram_Data''': compute (.true.) data for Taylor diagram (if possible) or do not compute (.false.);
 +
*# (optional) '''With_Median''': compute (.true.) median (>= 32 events) or do not compute (.false.);
 +
*# (optional) '''With_Percentiles_05_95''': compute (.true.) percentiles Q05, Q95 (>= 32 events) or do not compute (.false.);
 +
*# (optional) '''With_Percentiles_01_99''': compute (.true.) percentiles Q01, Q99 (>= 51 events) or do not compute (.false.).
 +
* (optional) Block '''Exclude_Variable_From_NCDELTA''': list of variables to be excluded from computation.
 +
*# '''Variant_Variable''': variable from ''Variant-File''. Key can be prescribed several times. With exception of the variables listed here results will be computed for all primary variable pairs.
 +
* (optional) Block '''Include_Only_Variable_for_NCDELTA''': list of variables for which results ar exclusively computed.
 +
*# '''Variant_Variable''': variable from ''Variant-File''. Key can be prescribed several times. Results will be solely computed for the variables listed here.
  
|shortdescription=
+
===General Remarks===
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''.
+
# Dictionary files used from directory '''''$PROGHOME/dic/''''':
 +
#* '''''ncdelta_dico.dat'''''.
  
Requirements for time-dependent primary variable pairs:
+
|nutzerprogramme=[[NCDELTA]]
# both data sets must contain an ''identical'' number of data items (time steps), with periods allowed to be different;
+
|language=Fortran90
# for data sets with constant time step, the respective time steps must be identical.
+
|fileform=FORMATTED
 
+
|fileaccess=SEQUENTIAL
Remarks concerning the spatial location of data:
+
|fileextension=.dat
# data sets may differ with respect to their geographical location;
+
|writemodules= ---
# areas for which data are defined must overlap to some degree;
+
|readmodules=$PROGHOME/fortran/prg/ncdelta/*/mod_m_ncdelta_steer.f90
# coordinates may be given in different coordinate systems, e. g. Gauß-Krüger and UTM;
+
|contact_original=[mailto:guenther.lang@baw.de G. Lang]
# 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]]).
+
|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
 
+
|examplefile=$PROGHOME/examples/ncdelta/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 08:01, 10 June 2015

Basic Information

File-Type

ncdelta.dat

Version

not yet available

Description-Date

June 2015

Significance of the File

contains general steering data for the program NCDELTA.

File-Contents (in Catchwords)

steering data

  • Block Program_Parameters: general steering data
    1. Max_Read_Storage: maximum number of data items read from input file during each analysis cycle.
    2. Max_Distance: maximum distance in [m] up to which points with different location are compared.
    3. (optional) Print_Modus_Classify: parameter to steer informative printout messages in program section classification:
      1. 0 = no extensive messages printed;
      2. 1 = more extensive messages about classified variables will be printed.
    4. (optional) Print_Modus_Pairs: parameter to steer informative printout messages in program section primary partner variables:
      1. 0 = no extensive messages printed;
      2. 1 = more extensive messages about detected variable pairs will be printed;
      3. 2 = also informations about rejected variable pairs will be printed.
    5. (optional) Print_Modus_Define: parameter to steer informative printout messages in program section definition of computational results:
      1. 0 = no extensive messages printed;
      2. 1 = more extensive informations with respect to metadata of computational results will be printed.
    6. (optional) Print_Modus_Compute: parameter to steer informative printout messages in program section computation of results:
      1. 0 = no extensive messages printed;
      2. 1 = more extensive messages about computational result variables will be printed.
  • Block Data_Files: data files
    1. Reference_File: file (NETCDF) with reference data (filetype cf-netcdf.nc);
    2. Variant_File: file (NETCDF) with variant data (filetype cf-netcdf.nc);
    3. Result_File: file (NETCDF) for result data (filetype cf-netcdf.nc).
  • (optional) Block Data_Operations: data operations
    1. (optional) With_Ordinary_Differences: compute (.true.) common differences (if possible) or do not compute (.false.);
    2. (optional) With_Taylor_Diagram_Data: compute (.true.) data for Taylor diagram (if possible) or do not compute (.false.);
    3. (optional) With_Median: compute (.true.) median (>= 32 events) or do not compute (.false.);
    4. (optional) With_Percentiles_05_95: compute (.true.) percentiles Q05, Q95 (>= 32 events) or do not compute (.false.);
    5. (optional) With_Percentiles_01_99: compute (.true.) percentiles Q01, Q99 (>= 51 events) or do not compute (.false.).
  • (optional) Block Exclude_Variable_From_NCDELTA: list of variables to be excluded from computation.
    1. Variant_Variable: variable from Variant-File. Key can be prescribed several times. With exception of the variables listed here results will be computed for all primary variable pairs.
  • (optional) Block Include_Only_Variable_for_NCDELTA: list of variables for which results ar exclusively computed.
    1. Variant_Variable: variable from Variant-File. Key can be prescribed several times. Results will be solely computed for the variables listed here.

General Remarks

  1. Dictionary files used from directory $PROGHOME/dic/:
    • ncdelta_dico.dat.

Programs using this Type of File

NCDELTA

Additional Information

Language

Fortran90

File-Form

FORMATTED

File-Access

SEQUENTIAL

File-Extension

.dat

WRITE-Subroutine(s)/Module(s)

---

READ-Subroutine(s)/Module(s)

$PROGHOME/fortran/prg/ncdelta/*/mod_m_ncdelta_steer.f90

Original Version

G. Lang

Maintenance

G. Lang, S. Spohr

Example-File

$PROGHOME/examples/ncdelta/ncdelta.dat


back to: File Descriptions


Overview