6.3 Check files

TUFLOW CATCH produces a small suite of additional GIS check files, and these are associated with the catchment hydraulic model, so have the corresponding name root ‘_catchment_hydraulic_’. These files are either standalone shape files, or included within the broader catchment hydraulic model geopackage of check files, depending on the user preference set (see Section 4.5.1). They are written to the user specified check file folder location. The TUFLOW CATCH specific check file names and descriptions are as follows.

  1. _catchment_hydraulic_hpc_transfer_R. Always produced. A file that has a single GIS region feature covering each catchment hydraulic model grid cell that has been identified as a transfer cell (either lateral and nodestring) from the catchment hydraulic model to the receiving model (hydrology or integrated configurations) or receiving polygon (pollutant export configuration). In the case of the latter configuration, flow and concentration data from all cells identified in the check file are aggregated to produce a single timeseries (see Section C.9.2). Attributes of each region feature are:
    • HPC_id: Sequential ID given to the catchment hydraulic model cell from which flows and concentrations are transferred. The ID is generated by TUFLOW CATCH and is not a TUFLOW HPC cell ID. The ID starts at 1 and increments upwards and is unrelated to the name of the associated receiving model boundary condition file (which uses the cell ID of the receiving model mesh, and only if hydrology or integrated configurations are deployed). Whilst this ID is generally not needed for subsequent analysis, it is used for cross referencing purposes in other check files (especially _catchment_hydraulic_lateral_transfer_)
    • type:
      • 1: lateral inflow
      • 2: nodestring inflow
    • n: catchment hydraulic model cell column number
    • m: catchment hydraulic model cell row number
  2. _catchment_hydraulic_nodestrings_R. Only produced in hydrology and integrated configurations. A file that has a single GIS region feature covering each catchment hydraulic model grid cell that has been identified as a nodestring transfer cell from the catchment hydraulic model to the receiving model. These polygons should correspond exactly to polygons of type 2 in the _catchment_hydraulic_hpc_transfer_R check file. This nodestrings check file is not produced in the pollutant export configuration where no receiving model is specified (receiving polygons are not associated with nodestrings). Attributes of each region feature are:
    • n: catchment hydraulic model cell column number
    • m: catchment hydraulic model cell row number
    • ns_name: Name of nodestring as set by user in 2d_ns_ GIS file
    • ns_name_1: Cell: 1 of X cells for nodestring number Y
    • ns_name_2: Cell: 2 of X cells for nodestring number Y
    • ns_name_3: Cell: 3 of X cells for nodestring number Y
    • …
    • ns_name_X: Cell: X of X cells for nodestring number Y
  3. _catchment_hydraulic_lateral_transfer_R. Only produced in hydrology and integrated configurations. A file that has a single GIS region feature covering each receiving model mesh cell that has been identified as receiving flows and concentrations from the catchment hydraulic model. These polygons should correspond exactly to the geometry of cells of the receiving model mesh that receiving catchment inflows. This _lateral_transfer check file is not produced in the pollutant export configuration where no receiving model is specified (receiving polygons are not associated with receiving model meshes). Attributes of each region feature are:
    • fv_id: Sequential ID given to the receiving model mesh cell at which flows and concentrations are transferred. The ID is generated by TUFLOW CATCH and is not a TUFLOW FV cell ID. The ID starts at 1 and increments upwards and is unrelated to the name of the associated receiving model boundary condition file (which uses the cell ID of the receiving model mesh, and only if hydrology or integrated configurations are deployed). This ID is generally not needed for subsequent analysis
    • n_HPC: The number of TUFLOW HPC grid cells that transfer flows and concentrations to the receiving model cell
    • cell_list: A comma separated list of the TUFLOW CATCH generated IDs of catchment hydraulic model cells (see field HPC_id in check file _catchment_hydraulic_hpc_transfer_R above). This list has n_HPC elements
  4. _catchment_hydraulic_im_check_L. Only produced if intervention measures are included. A file that has a single GIS line feature covering each intervention measure within the catchment hydraulic model. Attributes of each line feature are:
    • Device_name: Name of intervention as set by user in 2d_im_ GIS file
    • Length: Length of intervention (m)