TUFLOW Check Files: Difference between revisions
Content deleted Content added
| (22 intermediate revisions by 3 users not shown) | |||
Line 21:
Depending on the size of the model, the check files may contain a large amount of data, for example the _grd_check file may contain thousands or millions of cells. As a modeller you probably won't inspect each cell to ensure that the data is value, however you may want to view this for the entire model. Thematic mapping or styling the input layers can be used in your GIS software to do this.
Some tips are given below for a range of GIS platforms, however, the functionality is likely to be available in almost all GIS platforms:<br>
* [[MapInfo_Style_Check_Files | MapInfo style check files]]
=Check File Types=
The check files are separated into 2D and 1D check files. The output location for these is controlled by commands in the .tcf and .ecf as described above. Not all check file types will be output for all models, if a model has no 2D Z Shape (2d_zsh) format topography modifiers then the _zsh_zpt check file type will not be output by TUFLOW. A list of the check file types is provided below. For more information on each of these please click on the page link.<br>
Line 31 ⟶ 30:
{| class="wikitable" width="75%"
!
! width=75% style="background-color:#005581; font-weight:bold; color:white;"
|-
!colspan="2" | Tabular Check Files
| [[Check_Files_2d_bc_tables | _2d_bc_tables_check.csv]]|| Tabular data as read from the boundary condition database via any 2d_bc layers and after any adjustments (eg. time shift). Provides traceability to original data source. '''Note: the boundary values do not include the effects of any 2d_bc attributes such as f.'''▼
|-
▲| [[Check_Files_2d_bc_tables | _2d_bc_tables_check
| [[Check_Files_2d_bg_uvpt_check | _2d_bg_uvpt_check.mif<br>_2d_bg_uvpt_check.shp]]|| Contains information on adjustments to the ZU/ZV cell sides as modified by <font color="blue"><tt>Read GIS BG Shape</tt></font> <font color="red"><tt> ==</tt></font> command.▼
|-
!colspan="2" | Raster Check Files
| [[Check_Files_2d_bcc_check | _bcc_check.mif<br>_bcc_check_R.shp<br>]]|| GIS files providing trace back information and uses cells, rather than point/line objects to show 2D BCs.▼
|-
|
|-
|
The DEM_M and DEM_Z check grids are written if the model start up is forced to only process the .tgc file. To do this, don’t specify or comment out, the <font color="blue"><tt> BC Control File </tt></font> command.
|-
|[[Check_Files_2d_DEM_Zmin | _DEM_Zmin]]|| A DEM based on the minimum SGS elevations. This file is only produced when running a model with SGS. The .tcf command <font color="blue"><tt>Grid Format </tt></font> can be used output this check file in ASCII (ASC) or binary (FLT) format rather than the default GeoTIFF (TIF) format.
| [[Check_Files_2d_dom | _dom_check.mif<br>_dom_check_R.shp]]|| Contains a rectangle for each 2D domain showing the location, orientation and size of the domain. Within this domain, cells can be turned on or off, outside this domain no 2D calculations can be performed.▼
|-
|[[Check_Files_2d_DEM_Z_HR | _DEM_Z_HR]]|| A DEM based on the SGS elevations. This file is only produced when running a model with SGS and high resolution outputs. The .tcf command <font color="blue"><tt>Grid Format </tt></font> can be used output this check file in ASCII (ASC) or binary (FLT) format rather than the default GeoTIFF (TIF) format.
| [[Check_Files_2d_fc | _fc_check.mif<br>_fc_check_R.shp]]|| GIS layer of the final arrangement of flow constrictions (FC). The flow constrictions are written as individual square cells of the same shape as the grid cells, even if the FC was specified using points or lines/polylines.▼
|-
! colspan="2" | Vector Check Files
| [[Check_Files_2d_fcsh_uvpt | _fcsh_uvpt_check.mif<br>_fcsh_uvpt_check_P.shp]]|| Contains information on adjustments to the ZU/ZV cell sides as modified by <font color="blue"><tt>Read GIS FC Shape </tt></font> <font color="red"><tt>==</tt></font> commands.▼
|-
|[[Check_Files_2d_ad_check | _ad_check]]|| Contains information on initial conditions when using the advection-dispersion module.
| [[Check_Files_2d_glo | _glo_check.mif<br>_glo_check_P.shp]]|| GIS layer of any gauge level output (GLO) locations.▼
|-
▲|
| [[Check_Files_2d_grd | _grd_check.mif<br>_grd_check_R.shp]]|| GIS layer of the final 2D grid. Represents the final grid including modifications from the .tgc file, boundary specifications and flow constrictions. Note that the Material and bed resistance (eg. Mannings_n) attributes do not include any modifications due to flow constrictions as these are applied directly to the cell mid-sides (rather than the cell centre). To view these use the [[Check_Files_2d_uvpt|_uvpt_check.mif/.shp file]].<br>▼
|-
▲| [[Check_Files_2d_bcc_check | _bcc_check
|-
▲| [[Check_Files_2d_dom | _dom_check
|-
▲| [[Check_Files_2d_fc | _fc_check
|-
▲| [[Check_Files_2d_fcsh_uvpt | _fcsh_uvpt_check
|-
▲| [[Check_Files_2d_glo | _glo_check
|-
▲| [[Check_Files_2d_grd | _grd_check
Can also be written at different stages within a .tgc file (see <font color="blue"><tt>Write GIS Grid </tt></font> <font color="red"><tt>==</tt></font> command). The file contains all modifications to the 2D grid at the point in the .tgc file that it is written. <br>
Note that a number of additional attributes are appended to the_grd_check layer when some features of TUFLOW have been used.
|-
| [[Check_Files_2d_input_layers | _input_layers
|-
| [[Check_Files_2d_lfcsh_uvpt | _lfcsh_uvpt_check
|-
| [[Check_Files_2d_LP | _lp_check
|-
| [[Check_Files_2d_PO | _po_check
|-
| [[Check_Files_2d_sac | _sac_check
|-
| [[Check_Files_2d_sh_obj | _sh_obj_check
|-
| [[Check_Files_2d_uvpt | _uvpt_check
|-
| [[Check_Files_2d_vzsh | _vzsh_check
|-
| [[Check_Files_2d_zln_zpt | _zln_zpt_check
|-
| [[Check_Files_2d_zpt | _zpt_check
Can also be written at different stages within a .tgc file (see the <font color="blue"><tt>Write GIS Zpts</tt></font> command). The file contains all modifications to the 2D Zpts at the point in the .tgc file that it is written. This allows checking of the elevations at different stages of building the topography.
|-
| [[Check_Files_2d_zsh_zpt | _zsh_zpt_check
|}
Line 86 ⟶ 96:
{| class="wikitable" width="75%"
! style="background-color:#005581; font-weight:bold; color:white;" | Filename prefix / suffix
! style="background-color:#005581; font-weight:bold; color:white;" width=75% | Brief Description
|-
!colspan="2" | Tabular Check Files
| [[Check_Files_1d_bc_check | _1d_bc_check.mif<br>_1d_bc_check_P.shp]]|| GIS .mif/.mid or .shp files of the final 1D boundary conditions (BC). If no boundary conditions were specified, empty .mif/.mid or .shp files are written that can be used to set up a new layer. ▼
|-
|
|-
|
|-
|
|-
|
| [[Check_Files_1d_hydroprop | _hydroprop_check.mif<br>_hydroprop_check_L.shp]]|| Contains the hydraulic properties at the top of the hydraulic properties tables as attributes of the 1D channels. Other information such as the primary Manning’s n is also provided. Very useful for carrying out quality control checks on the 1D channels.▼
|-
! colspan="2" | Vector Check Files
|-
▲| [[Check_Files_1d_bc_check | _1d_bc_check
| [[Check_Files_1d_IWL | _iwl_check.mif<br>_iwl_check_P.shp]]|| GIS .mif/.mid or .shp files of the initial water levels at the 1D model nodes.▼
|-
▲| [[Check_Files_1d_hydroprop | _hydroprop_check
| [[Check_Files_1d_mhc | _mhc_check.mif<br>_mhc_check_P.shp]]|| GIS layer of manholes including any automatically created manholes.▼
|-
| [[
Any generated pit channels are shown as a small channel flowing from north to south into the pit node. The upstream pit channel node that is generated is also shown. The length of the pit channel is controlled by <font color="blue"><tt>Pit Channel Offset </tt></font> <font color="red"><tt>==</tt></font> command.▼
|-
▲| [[Check_Files_1d_IWL | _iwl_check
| [[Check_Files_1d_nwk_N | _nwk_N_check.mif<br>_nwk_N_check_P.shp]]|| GIS .mif/.mid or .shp files of the final 1D model network. This check layer contains the nodes of the 1D domain only. The _nwk_C_check layer contains the channels.<br>▼
|-
▲| [[Check_Files_1d_mhc | _mhc_check
| [[ Check_Files_1d_pit_A |_pit_A_check.mif<br>_pit_A_check_P.shp]]|| GIS layer of the 1D pit details. ▼
|-
| [[Check_Files_1d_nwk_C | _nwk_C_check]]|| GIS layer of the final 1D model network. This check layer contains the channels of the 1D domain only. The _nwk_N_check layer contains the nodes.<br>
▲| [[Check_Files_Str_Grp | _Str_Grp_All.csv<br>_Str_Grp_Multi.csv]]|| .csv file containing information on the structure groups.
▲Any generated pit channels are shown as a small channel flowing from north to south into the pit node. The upstream pit channel node that is generated is also shown. The length of the pit channel is controlled by <font color="blue"><tt>Pit Channel Offset </tt></font> <font color="red"><tt>==</tt></font> command.
|-
▲| [[Check_Files_1d_nwk_N | _nwk_N_check
'''This is very useful for checking for channel ends or nodes that are not snapped.'''<br>
|-
▲| [[ Check_Files_1d_pit_A |_pit_A_check
|-
| [[Check_Files_1d_WLLo | _WLLo_check
The _WLLo_check layers are written for ESTRY 1D domains, whereas the _xWLLo_check layers are written for external 1D domains, such as Flood Modeller or XP-SWMM.
|-
| [[Check_Files_1d_WLLp | _WLLp_check
The _WLLp_check layers are written for ESTRY 1D domains, whereas the _xWLLp_check layers are written for external 1D domains, such as Flood Modeller or XP-SWMM.
|-
| [[Check_Files_1d_xsl | _xsl_check
|-
| [[Check_Files_1d_x1d_chans | _x1d_chans_check
|-
| [[Check_Files_1d_x1d_nodes | _x1d_nodes_check
|}
Line 134 ⟶ 146:
{| class="wikitable" width="75%"
! style="background-color:#005581; font-weight:bold; color:white;" | Filename prefix / suffix
! style="background-color:#005581; font-weight:bold; color:white;" width=75%| Brief Description
|-
!colspan="2" | Tabular Check Files
| [[Check_Files_1d_to_2d_bc | _1d_to_2d_check.mif<br>_1d_to_2d_check_R.shp]]|| Displays the 2D cells connected to 1D nodes via 2D HX and 2D SX 2d_bc objects including SX boundaries from 1D features. For the .mif/.mid format cells connected to the same node are given the same colour to allow for easy visualisation of whether the right connections have been made. Additional information is supplied through the attributes.<br>▼
In the .mif layer, all SX cells connected to the same 1D node are grouped together as one object, and the Lowest_ZC_2D value is the lowest 2D cell ZC value of all the cells connected to the 1D node. For the .shp layer, it’s not possible to group the cells as one object, each cell is separate, when clicking on the SX cells, note that the value is still the lowest ZC of all 2D cells, not of the individual cell. For 2D HX links, the value is the ZC value of the individual cell.▼
|-
| [[Check_Files_x1D_to_2D.csv | _x1D_H_to_2D
|-
!colspan="2" | Vector Check Files
|-
▲| [[Check_Files_1d_to_2d_bc | _1d_to_2d_check
▲In the
|-
| [[Check_Files_1d_to_2d_gw | _1d_to_2d_gw_check]]|| Displays the 2D cells connected to 1D nodes via SX boundaries representing groundwater connections (as defined in the 2d_bc layer using the "GW" flag).
|}
Line 147 ⟶ 165:
{| class="wikitable" width="75%"
! style="background-color:#005581; font-weight:bold; color:white;" | Filename prefix / suffix
! style="background-color:#005581; font-weight:bold; color:white;" width=75%| Brief Description
|-
!colspan="2" | Vector Check Files
| [[Check_Files_2d_to_2d_bc | _2d_to_2d_check.mif<br>_2d_to_2d_check_R.shp]]|| Displays the 2D cells used to link two 2D domains together via a 2d_bc type “2D” boundary. Similar to the [[Check_Files_1d_to_2d_bc|_1d_to_2d_check layer]], the cells connected to the same hidden 1D node are given the same colour when using the .mif/.mid format. Use the command <font color="blue"><tt>Reveal 1D Nodes</tt></font> <font color="red"><tt>==</tt></font> <tt>ON</tt> command in the .tcf to view the locations of the hidden 1D nodes. ▼
|-
▲| [[Check_Files_2d_to_2d_bc | _2d_to_2d_check
|}
= Common Questions Answered (FAQ)=
== My cross sections have various Manning's ''n'', but only one value is reported in 1d_ta_tables_check.csv. Is it applied correctly? ==
| |||