Actions

Difference between revisions of "UTRSUB GRID.DAT"

From BAWiki

imported>Lang Guenther
m (HVIEW2D durch SGHVIEW2D ersetzt / Link UNTRIM2)
imported>Lang Guenther
(link to DATACONVERT)
 
(5 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
|name_de=UTRSUB_GRID.DAT
 
|name_de=UTRSUB_GRID.DAT
 
|filetype=utrsub_grid.dat  
 
|filetype=utrsub_grid.dat  
|version=1.x / September 2010
+
|version=December 2018
|version_descr=December 2010
+
|version_descr=December 2018
 
|significance=contains grid data for the numerical model UnTRIM2 (with SubGrid data)  
 
|significance=contains grid data for the numerical model UnTRIM2 (with SubGrid data)  
 
|filecontents=
 
|filecontents=
Line 17: Line 17:
 
#* EPSG code for coordinate transformation (see [http://www.epsg-registry.org/ EPSG Geodetic Parameter Registry]);
 
#* EPSG code for coordinate transformation (see [http://www.epsg-registry.org/ EPSG Geodetic Parameter Registry]);
 
#* informative text;
 
#* informative text;
#* number of subpolygons (larger or equal than number of polygons);
+
#* number of subpolygon depth classes (larger or equal than number of polygons);
#* number of subedges (larger or equal than number of edges with flow).  
+
#* number of subedge depth classes (larger or equal than number of edges with flow).  
 
# '''dynamic data''':
 
# '''dynamic data''':
 
#* '''vertex data''' (for each vertex):
 
#* '''vertex data''' (for each vertex):
Line 35: Line 35:
 
#** second node of an edge,
 
#** second node of an edge,
 
#** indices of adjacent polygons (0 indicates missing polygons - boundary edge).  
 
#** indices of adjacent polygons (0 indicates missing polygons - boundary edge).  
#* '''subpolygon data''' (for each polygon):
+
#* '''subpolygon depth class data''' (for each polygon):
 
#** polygon number (informative),
 
#** polygon number (informative),
#** number of local subpolygons,
+
#** number of local subpolygon depth classes,
#** areas for all local subpolygons (the sum of all subpolygon areas must be less than or equal to the geometric polygon area), and
+
#** areas for all local subpolygon depth classes (the sum of all sub areas must be less than or equal to the geometric polygon area), and
#** depths for all local subpolygons.  
+
#** depths for all local subpolygon depth classes.  
#* '''subedge data''' (for each edge):
+
#* '''subedge depth class data''' (for each edge):
 
#** edge number (informative),
 
#** edge number (informative),
#** number of local subedges,
+
#** number of local subedge depth classes,
#** lengths of all local subedges (the sum of all subedge lengths must be less than or equal to the geometric edge length), and
+
#** lengths of all local subedge depth classes (the sum of all sub lengths must be less than or equal to the geometric edge length), and
#** depths for all local subedges.  
+
#** depths for all local subedge depth classes.
 +
#: ''Remark'': the maximum subedge depth of an edge may not be larger than the maximum subpolygon depth from the adjacent polygons.
 +
# (optional) Block ''GLOBAL_STATIC''<br />Can be used to fill in global attributes before generating a [[CF-NETCDF.NC|CF-NetCDF]] file.
 +
##NH = '''number''' of history lines.
 +
##NC = '''number''' of comment lines.
 +
# (optional) Block ''GLOBAL''<br />Can be used to fill in global attributes before generating a [[CF-NETCDF.NC|CF-NetCDF]] file.
 +
##INSTITUTION = '''institution''' which generates the data.
 +
##REFERENCES = '''reference''' of the providing institution.
 +
##CONVENTIONS = '''NetCDF conventions''' which are fulfilled by the file.
 +
##TITLE = '''title''' of the file.
 +
##SOURCE = '''source''' of the file.
 +
# (optional) blocks ''GLOBAL_HISTORY''<br />Can be used to fill in global attributes before generating a [[CF-NETCDF.NC|CF-NetCDF]] file.
 +
##HISTORY = a '''history line''' of the file.
 +
# (optional) blocks ''GLOBAL_COMMENT''<br />Can be used to fill in global attributes before generating a [[CF-NETCDF.NC|CF-NetCDF]] file.
 +
##COMMENT = a '''comment line''' of the file.
 +
# (optional) Block ''CODE_AND_TIME_INFO''<br />Can be used to fill in attributes to the depth variable before generating a [[CF-NETCDF.NC|CF-NetCDF]] file.
 +
##CODE = '''phydef code''' to explain the meaning of the depth data [1149].
 +
##TIME = '''reference time''' of the depth data.
 +
##BEGIN = '''start time''' of the validity period of the depth data.
 +
##END = '''end time''' of the validity period of the depth data.
 +
 
 +
 
 
|nutzerprogramme=
 
|nutzerprogramme=
[[GRIDCONVERT]], SGHVIEW2D, [[UNTRIM2]], [[UTRPRE]], [[VVIEW2D]]
+
[[CREATE_SIMPLE_UNTRIM2_GRID]], [[DATACONVERT]], [[GRIDCONVERT]], [[UNTRIM2]], [[UTRPRE]], [[VVIEW2D]]
 
|language=Fortran90
 
|language=Fortran90
 
|fileform=FORMATTED
 
|fileform=FORMATTED
Line 55: Line 76:
 
|contact_original=[mailto:info.hamburg@baw.de V. Casulli], [mailto:guenther.lang@baw.de G. Lang]
 
|contact_original=[mailto:info.hamburg@baw.de V. Casulli], [mailto:guenther.lang@baw.de G. Lang]
 
|contact_maintenance=[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]
|examplefile=see $PROGHOME/examples/lib/h_grid/
+
|examplefile=
 +
see $PROGHOME/examples/lib/h_grid/ <br />
 +
$PROGHOME/examples/lib/h_grid/h_grid_test_sub_plus_CF_Info_input.dat
 
}}
 
}}

Latest revision as of 12:59, 14 December 2018

Basic Information

File-Type

utrsub_grid.dat

Version

December 2018

Description-Date

December 2018

Significance of the File

contains grid data for the numerical model UnTRIM2 (with SubGrid data)

File-Contents (in Catchwords)

  1. static informations:
    • number of vertices;
    • number of edges (geometric edges of a grid);
    • number of polygons (geometric polygons of a grid);
    • number of red polygons;
    • number of polygons at open boundaries;
    • number of internal edges;
    • last edge number with Dirichlet boundary condition (number of edges with flow);
    • mean geographic latitude;
    • EPSG code for coordinate transformation (see EPSG Geodetic Parameter Registry);
    • informative text;
    • number of subpolygon depth classes (larger or equal than number of polygons);
    • number of subedge depth classes (larger or equal than number of edges with flow).
  2. dynamic data:
    • vertex data (for each vertex):
      • vertex number (informative),
      • x- and y-coordinate, and
      • (optional) vertex depth.
    • polygon data (for each polygon):
      • polygon number (informative),
      • number of vertices (and edges),
      • x- and y-coordinate of the center (meaningful for the computational method),
      • node indices (anti clockwise sorting), and
      • edge indices (anti clockwise sorting).
    • edge data (for each edge):
      • edge number (informative),
      • first node of an edge,
      • second node of an edge,
      • indices of adjacent polygons (0 indicates missing polygons - boundary edge).
    • subpolygon depth class data (for each polygon):
      • polygon number (informative),
      • number of local subpolygon depth classes,
      • areas for all local subpolygon depth classes (the sum of all sub areas must be less than or equal to the geometric polygon area), and
      • depths for all local subpolygon depth classes.
    • subedge depth class data (for each edge):
      • edge number (informative),
      • number of local subedge depth classes,
      • lengths of all local subedge depth classes (the sum of all sub lengths must be less than or equal to the geometric edge length), and
      • depths for all local subedge depth classes.
    Remark: the maximum subedge depth of an edge may not be larger than the maximum subpolygon depth from the adjacent polygons.
  3. (optional) Block GLOBAL_STATIC
    Can be used to fill in global attributes before generating a CF-NetCDF file.
    1. NH = number of history lines.
    2. NC = number of comment lines.
  4. (optional) Block GLOBAL
    Can be used to fill in global attributes before generating a CF-NetCDF file.
    1. INSTITUTION = institution which generates the data.
    2. REFERENCES = reference of the providing institution.
    3. CONVENTIONS = NetCDF conventions which are fulfilled by the file.
    4. TITLE = title of the file.
    5. SOURCE = source of the file.
  5. (optional) blocks GLOBAL_HISTORY
    Can be used to fill in global attributes before generating a CF-NetCDF file.
    1. HISTORY = a history line of the file.
  6. (optional) blocks GLOBAL_COMMENT
    Can be used to fill in global attributes before generating a CF-NetCDF file.
    1. COMMENT = a comment line of the file.
  7. (optional) Block CODE_AND_TIME_INFO
    Can be used to fill in attributes to the depth variable before generating a CF-NetCDF file.
    1. CODE = phydef code to explain the meaning of the depth data [1149].
    2. TIME = reference time of the depth data.
    3. BEGIN = start time of the validity period of the depth data.
    4. END = end time of the validity period of the depth data.

Programs using this Type of File

CREATE_SIMPLE_UNTRIM2_GRID, DATACONVERT, GRIDCONVERT, UNTRIM2, UTRPRE, VVIEW2D

Additional Information

Language

Fortran90

File-Form

FORMATTED

File-Access

SEQUENTIAL (DELIM=QUOTE)

File-Extension

.dat

WRITE-Subroutine(s)/Module(s)

mod_p_h_grid_ui.f90 (User-Interface).

READ-Subroutine(s)/Module(s)

mod_p_h_grid_ui.f90 (User-Interface).

Original Version

V. Casulli, G. Lang

Maintenance

G. Lang, S. Spohr

Example-File

see $PROGHOME/examples/lib/h_grid/
$PROGHOME/examples/lib/h_grid/h_grid_test_sub_plus_CF_Info_input.dat


back to: File Descriptions


Overview