UTRSUB GRID.DAT

Basic Information

File-Type

utrsub_grid.dat

File-Form

FORMATTED

Version

July 2011

Description-Date

July 2011

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, GRIDCONVERT, SGHVIEW2D, UNTRIM2, UTRPRE, VVIEW2D

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