Difference between revisions of "Check Files 2d grd"

From Tuflow
Jump to navigation Jump to search
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
This pages contains information on the attributes of the _grd_check file.  This GIS contains a region object for each active (cell code 1) or null (cell code -1) cell.  A number of the output attributes are only written if certain model features are enabled.  For example, the '''SRF''' (Storage Reduction Factor) attribute is only included if any SRF commands are used in the model.<br>
 
This pages contains information on the attributes of the _grd_check file.  This GIS contains a region object for each active (cell code 1) or null (cell code -1) cell.  A number of the output attributes are only written if certain model features are enabled.  For example, the '''SRF''' (Storage Reduction Factor) attribute is only included if any SRF commands are used in the model.<br>
 
<br>
 
<br>
−
There are a number of attributes that are only output for TUFLOW GPU models, as the GPU model is a cell centred scheme certain properties such as Manning's roughness and Form Loss are applied at the cell centre, whilst in TUFLOW these are applied at the cell side (refer to the TUFLOW manual for a more detailed explanation).  These GPU only attributes are noted in the table below.
+
There are a number of attributes that are only output for TUFLOW GPU models, as the GPU model is a cell centred scheme certain properties such as Manning's roughness and Form Loss are applied at the cell centre, whilst in TUFLOW these are applied at the cell side (refer to the <u>[https://downloads.tuflow.com/TUFLOW/Releases/Latest/TUFLOW%20Manual.pdf TUFLOW Manual]</u> for a more detailed explanation).  These GPU only attributes are noted in the table below.<br>
 +
 
 
'''Attributes of grd_check'''<br>
 
'''Attributes of grd_check'''<br>
 
{| align="center" class="wikitable" width="75%"
 
{| align="center" class="wikitable" width="75%"
Line 7: Line 8:
 
! style="background-color:#005581; font-weight:bold; color:white;" width=75%| Attribute Description
 
! style="background-color:#005581; font-weight:bold; color:white;" width=75%| Attribute Description
 
|-
 
|-
−
| n||Row number in the TUFLOW domain
+
| n||Row number in the TUFLOW domain.
 
|-
 
|-
−
| m||Column number in the TUFLOW domain
+
| m||Column number in the TUFLOW domain.
 
|-
 
|-
−
| Code||The cell code status. This is 1 for active cells and -1 for null cells that are included in the mesh.  Refer to the TUFLOW Manual for more information on the cell codes.<br>
+
| Code||The cell code status. This is 1 for active cells and -1 for null cells that are included in the mesh.  Refer to the <u>[https://downloads.tuflow.com/TUFLOW/Releases/Latest/TUFLOW%20Manual.pdf TUFLOW Manual]</u> for more information on the cell codes.
 
|-
 
|-
 
| Material||The material ID.
 
| Material||The material ID.
 
|-
 
|-
−
| ZC||The cell centre elevation.
+
| ZC (ZMin if SGS is used)||The elevation within the cell. If SGS is used, minimum elevation within the cell.  
 
|-
 
|-
 
| IWL||The initial water level value.  If the initial water level set in the model is below the cell elevation (ZC) or if no initial water level has been set, the cell elevation plus the model wet / dry depth is output. Note, this value is rounded to 3 decimal places.  
 
| IWL||The initial water level value.  If the initial water level set in the model is below the cell elevation (ZC) or if no initial water level has been set, the cell elevation plus the model wet / dry depth is output. Note, this value is rounded to 3 decimal places.  
 
|-
 
|-
−
| Domain_Index||The index of the model domain.  This is the order with <tt>Start 2D Domain == <Domain Name></tt> commands appears in the .tcf control file.  For a single domain model this will be 1.
+
| Domain_Index||The index of the model domain.  This is the order with <tt><font color="blue">Start 2D Domain</font><font color="red"> == </font><Domain Name></tt> commands appears in the TCF control file.  For a single domain model this will be 1.
 
|-
 
|-
−
| Mann_n (GPU model only)||The Manning's n value for the cell. This is only output for a GPU model only as the GPU model is a cell centred scheme and the Manning's n value is applied at the cell centre.  For a TUFLOW "classic" simulation the Manning's is applied at the cell side and this is output in the [[Check_Files_2d_uvpt | _uvpt_check<br>_uvpt_check_P]]
+
| SRF (only if SRF feature used)||The Storage Reduction Factor for the cell.
−
|-
 
−
| FLC (GPU model only)||Form loss coefficient, this is only output for a GPU model only as the GPU model is a cell centred scheme and the FLC value is applied at the cell centre.  For a TUFLOW "classic" simulation this is applied at the cell side and this is output in the [[Check_Files_2d_uvpt | _uvpt_check<br>_uvpt_check_P]]
 
−
|-
 
−
| CWF_x (GPU model only)||Cell width factor in the x-direction. This is only output for a GPU model only as the GPU model is a cell centred scheme and the CWF value is applied at the cell centre.  For a TUFLOW "classic" simulation this is applied at the cell side and this is output in the [[Check_Files_2d_uvpt | _uvpt_check<br>_uvpt_check_P]]
 
 
|-
 
|-
−
| CWF_y (GPU model only)||Cell width factor in the y-direction. This is only output for a GPU model only as the GPU model is a cell centred scheme and the CWF value is applied at the cell centre.  For a TUFLOW "classic" simulation this is applied at the cell side and this is output in the [[Check_Files_2d_uvpt | _uvpt_check<br>_uvpt_check_P]]
+
| Soil_ID (only if soil feature used)||The Soil ID for the cell. This is only output if a <font color="blue"><tt>Set Soil</tt></font>, <font color="blue"><tt>Read GIS Soil</tt></font> or <font color="blue"><tt>Read GRID Soil</tt></font> command is specified for the simulation.
 
|-
 
|-
−
| SRF (only if SRF feature used)||The Storage Reduction Factor for the cell.
+
| Z_Map_Cutoff (only if SGS is used)||The map output cutoff elevation for each cell. This is equal to the minimum cell elevation plus the map cutoff depth (specified by the TCF command <tt><font color="blue">Map Cutoff Depth</font><font color="red"> == </font></tt>).
 
|-
 
|-
−
| Soil_ID (only if soil feature used)||The Soil ID for the cell. This is only output if a Set Soil, Read GIS Soil or Read GRID Soil command is specified for the simulation.
+
| SGS_Delta (only if SGS is used)||This attribute is output only if the <font color="blue"><tt>SGS Breakline Detection Delta</tt></font> TCF command has been used. The SGS breakline detection check processes each 2D cell to identify the minimum water surface elevation needed for a continuous wet connection through the cell traversing between left to right and between top to bottom. The maximum invert elevation of the left and right faces is subtracted from the left-right minimum water level and reports it as “uDelta”. Similarly, the top to bottom value is reported as “vDelta”. uDelta and vDelta represent the depth of water over the cell face inverts by which a natural ridge (break) line would block any flow. This attribute reports the maximum of uDelta and vDelta.
 
|}
 
|}
  
−
This file is very useful to apply a style or thematic map to.  See the [[TUFLOW_Check_Files#Tips_for_Visualising_Check_Files| Tips for visualising check files page]].<br>
+
This file is very useful to apply a style or thematic map to.  See the [[TUFLOW_Check_Files#Tips_for_Visualising_Check_Files| Tips for visualising check files]].<br>
 
This allows a very easy way to visualise the final properties for large models.
 
This allows a very easy way to visualise the final properties for large models.
 
<br><br>
 
<br><br>
 
An grd_check file  styled by the soil ID is below (in QGIS).<br>
 
An grd_check file  styled by the soil ID is below (in QGIS).<br>
 +
<br>
 
[[ File:Grd check SoilID1.JPG]]
 
[[ File:Grd check SoilID1.JPG]]
 
<br><br>
 
<br><br>
 
An example of a grid check file shaded by Material ID is below (in MapInfo).<br>
 
An example of a grid check file shaded by Material ID is below (in MapInfo).<br>
 +
<br>
 
[[File:MI thematic map 04.jpg]]
 
[[File:MI thematic map 04.jpg]]
 +
<br><br>
 +
 +
 +
{{Tips Navigation
 +
|uplink=[[TUFLOW_Check_Files | TUFLOW Check Files]]
 +
}}

Latest revision as of 21:46, 27 August 2024

This pages contains information on the attributes of the _grd_check file. This GIS contains a region object for each active (cell code 1) or null (cell code -1) cell. A number of the output attributes are only written if certain model features are enabled. For example, the SRF (Storage Reduction Factor) attribute is only included if any SRF commands are used in the model.

There are a number of attributes that are only output for TUFLOW GPU models, as the GPU model is a cell centred scheme certain properties such as Manning's roughness and Form Loss are applied at the cell centre, whilst in TUFLOW these are applied at the cell side (refer to the TUFLOW Manual for a more detailed explanation). These GPU only attributes are noted in the table below.

Attributes of grd_check

Attribute Name Attribute Description
n Row number in the TUFLOW domain.
m Column number in the TUFLOW domain.
Code The cell code status. This is 1 for active cells and -1 for null cells that are included in the mesh. Refer to the TUFLOW Manual for more information on the cell codes.
Material The material ID.
ZC (ZMin if SGS is used) The elevation within the cell. If SGS is used, minimum elevation within the cell.
IWL The initial water level value. If the initial water level set in the model is below the cell elevation (ZC) or if no initial water level has been set, the cell elevation plus the model wet / dry depth is output. Note, this value is rounded to 3 decimal places.
Domain_Index The index of the model domain. This is the order with Start 2D Domain == <Domain Name> commands appears in the TCF control file. For a single domain model this will be 1.
SRF (only if SRF feature used) The Storage Reduction Factor for the cell.
Soil_ID (only if soil feature used) The Soil ID for the cell. This is only output if a Set Soil, Read GIS Soil or Read GRID Soil command is specified for the simulation.
Z_Map_Cutoff (only if SGS is used) The map output cutoff elevation for each cell. This is equal to the minimum cell elevation plus the map cutoff depth (specified by the TCF command Map Cutoff Depth == ).
SGS_Delta (only if SGS is used) This attribute is output only if the SGS Breakline Detection Delta TCF command has been used. The SGS breakline detection check processes each 2D cell to identify the minimum water surface elevation needed for a continuous wet connection through the cell traversing between left to right and between top to bottom. The maximum invert elevation of the left and right faces is subtracted from the left-right minimum water level and reports it as “uDelta”. Similarly, the top to bottom value is reported as “vDelta”. uDelta and vDelta represent the depth of water over the cell face inverts by which a natural ridge (break) line would block any flow. This attribute reports the maximum of uDelta and vDelta.

This file is very useful to apply a style or thematic map to. See the Tips for visualising check files.
This allows a very easy way to visualise the final properties for large models.

An grd_check file styled by the soil ID is below (in QGIS).

Grd check SoilID1.JPG

An example of a grid check file shaded by Material ID is below (in MapInfo).

MI thematic map 04.jpg


Up
Go-up.png TUFLOW Check Files
Retrieved from "https://wiki.tuflow.com/w/index.php?title=Check_Files_2d_grd&oldid=40652"