# UTRSUB GRID.DAT

### From BAWiki

##### Revision as of 12:59, 14 December 2018 by imported>Lang Guenther (link to DATACONVERT)

Revision as of 12:59, 14 December 2018 by imported>Lang Guenther (link to DATACONVERT)

## Basic Information

### File-Type

utrsub_grid.dat

### File-Form

FORMATTED

### 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)

**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).

**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.

- (optional) Block
*GLOBAL_STATIC*

Can be used to fill in global attributes before generating a CF-NetCDF file.- NH =
**number**of history lines. - NC =
**number**of comment lines.

- NH =
- (optional) Block
*GLOBAL*

Can be used to fill in global attributes before generating a 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.

- INSTITUTION =
- (optional) blocks
*GLOBAL_HISTORY*

Can be used to fill in global attributes before generating a CF-NetCDF file.- HISTORY = a
**history line**of the file.

- HISTORY = a
- (optional) blocks
*GLOBAL_COMMENT*

Can be used to fill in global attributes before generating a CF-NetCDF file.- COMMENT = a
**comment line**of the file.

- COMMENT = a
- (optional) Block
*CODE_AND_TIME_INFO*

Can be used to fill in attributes to the depth variable before generating a 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.

- CODE =

## Programs using this Type of File

CREATE_SIMPLE_UNTRIM2_GRID, DATACONVERT, GRIDCONVERT, 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