Actions

NCAGGREGATE.DAT: Difference between revisions

From BAWiki

imported>Lang Guenther
(new key NC_Cmode_Id added to description)
imported>Schade Peter
(Original version)
Line 1: Line 1:
{{FileDescription
{{FileDescription
|name_de=NCAGGREGATE.DAT
|name_de=NCCUTOUT.DAT
|filetype=ncaggregate.dat
|filetype=nccutout.dat
|version=December 2017
|version=November 2018
|version_descr=December 2017
|version_descr=November 2018
|significance=contains general steering data for the program [[NCAGGREGATE]].
|significance=contains general steering data for the program [[NCCUTOUT]].
|filecontents=
|filecontents='''steering data'''
'''steering data'''


* Block '''Program_Parameters''': general input data
* Block '''Program_Parameters''': general input data
*# '''Input_Data_File''': [[NetCDF|CF NetCDF]] file with input data
*# '''Input_Data_File''': [[NetCDF|CF NetCDF]] file with input data
*# '''Output_Data_File''': [[NetCDF|CF NetCDF]] file with aggregated result data
*# '''Output_Data_File''': [[NetCDF|CF NetCDF]] file with extracted data
*# '''Aggregation_File''': definition of control volumes in file of type [[IPDS.DAT|ipds.dat]]
*# '''Subdomain_File''': definition of the cut out area in file of type [[IPDS.DAT|ipds.dat]]
*# '''Aggregation_EPSG''': EPSG code (see [http://www.epsg-registry.org/ http://www.epsg-registry.org/]) for coordinates stored in ''Aggregation_File''
*# '''Subdomain_EPSG''': EPSG code (see [http://www.epsg-registry.org/ http://www.epsg-registry.org/]) for coordinates stored in ''Subdomain_File''
*# (optional) '''NC_Deflate_Level''': deflate level (0,1,2,...,9) for online compression of data during write. 0 corresponds to no compression and 9 to maximum compression
*# (optional) '''NC_Deflate_Level''': deflate level (0,1,2,...,9) for online compression of data during write. 0 corresponds to no compression and 9 to maximum compression
*# (optional) '''NC_Cmode_Id''': ''creation mode flag'' used for [[NetCDF|CF NetCDF]] method  [https://www.unidata.ucar.edu/software/netcdf/netcdf-4/newdocs/netcdf-f90/NF90_005fCREATE.html NF90_CREATE]. Typical values used in this application are:
*# (optional) '''NC_Cmode_Id''': ''creation mode flag'' used for [[NetCDF|CF NetCDF]] method  [https://www.unidata.ucar.edu/software/netcdf/netcdf-4/newdocs/netcdf-f90/NF90_005fCREATE.html NF90_CREATE]. Typical values used in this application are:
*#* 4 = '''NF90_64BIT_OFFSET''' (NetCDF 64Bit file, no HDF - no online compression);
*#* 4 = '''NF90_64BIT_OFFSET''' (NetCDF 64Bit file, no HDF - no online compression);
*#* 5 = '''NF90_CLASSIC_MODEL''' (HDF file without use of extended HDF features - with online compression).
*#* 5 = '''NF90_CLASSIC_MODEL''' (HDF file without use of extended HDF features - with online compression).
*# (optional) '''Max_Time_Steps_Per_Record''': maximum number of time steps allowed to be transferred in one WRITE to disc file.
* (optional) Block '''Exclude_Variable_From_NCCUTOUT''': list of geophysical variables to be excluded from extraction.
*# (optional) '''Create_Missing_Variables''': create additional (virtual) variables
*# '''Variable''': variable from ''Input_Data_File''. Key can be prescribed several times. With exception of the variables listed here results will be computed for all variables suited for extraction. Coordinate, ancillary and weight variables can not be listed here.
*#: 0 = do not create (default);
* (optional) Block '''Include_Only_Variable_for_NCCUTOUT''': list of variables for which results are exclusively extracted.
*#: 1 = create (for DFlow FM UGRID CF NetCDF).
*# '''Variable''': variable from ''Input_Data_File''. Key can be prescribed several times. These geophysical variables will be exclusively extracted. Coordinate, ancillary and weight variables can not be listed here.
*# (optional) '''With_Median''': compute (.true.) median (>= 32 values) or do not compute (.false.);
*# (optional) '''With_Percentiles_05_95''': compute (.true.) percentiles Q05, Q95 (>= 32 values) or do not compute (.false.);
*# (optional) '''With_Percentiles_01_99''': compute (.true.) percentiles Q01, Q99 (>= 51 values) or do not compute (.false.).
* (optional) Block '''Exclude_Variable_From_NCAGGREGATE''': list of variables to be excluded from aggregation.
*# '''Variable''': variable from ''Input_Data_File''. Key can be prescribed several times. With exception of the variables listed here results will be computed for all variables suited for aggregation.
* (optional) Block '''Include_Only_Variable_for_NCAGGREAGTE''': list of variables for which results are exclusively aggregated.
*# '''Variable''': variable from ''Input_Data_File''. Key can be prescribed several times. Aggregation will be solely performed for the variables listed here.
* (optional) Block '''Probability_Distribution_Group''': classification and list of variables for which probability distributions are computed. Block can be prescribed several times.
*# '''Bounds_Name''': classification from file [[BOUNDS.CFG.DAT|bounds.cfg.dat]] which will be used to compute probability distributions for all subsequent variables.
*# '''Variable''': variable from ''Input_Data_File''. Key can be prescribed several times. Probability distributions will be solely performed for the variables listed here. Variables listed here shall not be excluded via blocks '''Exclude_Variable_From_NCAGGREGATE''' or '''Include_Only_Variable_for_NCAGGREAGTE'''.
===General Remarks===
===General Remarks===
# Dictionary file used from directory '''''$PROGHOME/dic/''''':
# Dictionary file used from directory '''''$PROGHOME/dic/''''':
#* '''''ncaggregate_dico.dat'''''.  
#* '''''nccutout_dico.dat'''''.  
# If no online compression is used during output file creation, it is recommended to apply [https://www.unidata.ucar.edu/software/netcdf/docs/netcdf/nccopy.html NCCOPY] manually. Example:
# If no online compression is used during output file creation, it is recommended to apply [https://www.unidata.ucar.edu/software/netcdf/docs/netcdf/nccopy.html NCCOPY] or [[NCCHUNKIE|NCCHUNKIE]] manually.  
nccopy -k 3 -d 5 <infile> <outfile>


|nutzerprogramme=[[NCAGGREGATE]]
|nutzerprogramme=[[NCCUTOUT]]
|language=Fortran90
|language=Fortran90
|fileform=FORMATTED
|fileform=FORMATTED
Line 43: Line 31:
|fileextension=.dat
|fileextension=.dat
|writemodules= ---
|writemodules= ---
|readmodules=$PROGHOME/fortran/prg/ncaggregate/*/mod_m_ncaggregate_steer.f90
|readmodules=$PROGHOME/fortran/prg/nccutout/*/mod_m_nccutout_steer.f90
|contact_original=[mailto:guenther.lang@baw.de G. Lang]
|contact_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:peter.schade@baw.de P. Schade]
|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|contact_maintenance=[mailto:peter.schade@baw.de P. Schade]
|examplefile=$PROGHOME/examples/ncaggregate/ncaggregate.dat
|examplefile=$PROGHOME/examples/nccutout/nccutout.dat
}}
}}

Revision as of 09:48, 21 November 2018

Basic Information

File-Type

nccutout.dat

File-Form

FORMATTED

Version

November 2018

Description-Date

November 2018

Significance of the File

contains general steering data for the program NCCUTOUT.

File-Contents (in Catchwords)

steering data

  • Block Program_Parameters: general input data
    1. Input_Data_File: CF NetCDF file with input data
    2. Output_Data_File: CF NetCDF file with extracted data
    3. Subdomain_File: definition of the cut out area in file of type ipds.dat
    4. Subdomain_EPSG: EPSG code (see http://www.epsg-registry.org/) for coordinates stored in Subdomain_File
    5. (optional) NC_Deflate_Level: deflate level (0,1,2,...,9) for online compression of data during write. 0 corresponds to no compression and 9 to maximum compression
    6. (optional) NC_Cmode_Id: creation mode flag used for CF NetCDF method NF90_CREATE. Typical values used in this application are:
      • 4 = NF90_64BIT_OFFSET (NetCDF 64Bit file, no HDF - no online compression);
      • 5 = NF90_CLASSIC_MODEL (HDF file without use of extended HDF features - with online compression).
  • (optional) Block Exclude_Variable_From_NCCUTOUT: list of geophysical variables to be excluded from extraction.
    1. Variable: variable from Input_Data_File. Key can be prescribed several times. With exception of the variables listed here results will be computed for all variables suited for extraction. Coordinate, ancillary and weight variables can not be listed here.
  • (optional) Block Include_Only_Variable_for_NCCUTOUT: list of variables for which results are exclusively extracted.
    1. Variable: variable from Input_Data_File. Key can be prescribed several times. These geophysical variables will be exclusively extracted. Coordinate, ancillary and weight variables can not be listed here.

General Remarks

  1. Dictionary file used from directory $PROGHOME/dic/:
    • nccutout_dico.dat.
  2. If no online compression is used during output file creation, it is recommended to apply NCCOPY or NCCHUNKIE manually.

Programs using this Type of File

NCCUTOUT

Example-File

$PROGHOME/examples/nccutout/nccutout.dat


back to: File Descriptions


Overview