Actions

UTRSUB GRID.DAT

From BAWiki

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