Section 2 Architecture

This section provides a description of TUFLOW CATCH’s core architecture. This description is intentionally introductory, and details required to set up and execute simulations that deploy TUFLOW CATCH are provided in Sections 4 and 5. \(\newcommand{\blockindent}{\hspace{0.5cm}}\)

2.1 Context

As our understanding of the natural environment advances, the questions asked of environmental numerical models are rapidly increasing in breadth and complexity. Setting up, calibrating and executing defensible environmental models to assist in addressing such questions has therefore become an increasingly challenging proposition. This is particularly relevant with regard to whole-of-catchment studies where the linkage between catchment management intervention and associated receiving water changes is of increasing interest (and complexity) within the environmental management space.

The architecture and functionality of TUFLOW CATCH has therefore been deliberately designed to assist environmental modellers in overcoming some of these challenges, and in doing so improve the efficiency and effectiveness with which numerical modelling can support longer term environmental management at the catchment scale. Importantly, TUFLOW CATCH’s architecture provides a mechanism by which users can seamlessly simulate hydrologic, hydraulic, pollutant export and transformative receiving water quality processes within one unified, automated and internally consistent framework. This deliberate design choice has been motivated by the observation that historically, catchment and receiving waterway simulations have often been undertaken using disparate modelling platforms not designed or intended to be linked, and that (more often then not) operate under materially different assumptions and levels of scientific rigour. One example of such an instance might be where predictions from a catchment model that uses average (spatially and temporally lumped) hydrology and event mean pollutant export assumptions are used to provide inflow boundary conditions to a fully three dimensional receiving water quality model that operates on a highly spatial and temporally resolved domain and makes limited average assumptions. TUFLOW CATCH exploits the latest compute power advances and scientific rigour to overcome such disconnects.

In short, TUFLOW CATCH has been designed to provide access to state of the art bottom-up environmental modelling science at the integrated catchment scale, without deploying top-down average assumptions. The core architecture that provides this easy access is described below, and the details of the methods deployed in supplementary processes such as geolocation are described in Sections 3.1 and 3.2. The associated simulation commands and execution approaches are provided in Sections 4 and 5, respectively.

2.2 Intention

The intention of the execution coordination sequences described below is that they provide a robust means to automatically link catchment and receiving waterway models within three overarching configurations to support integrated environmental assessment. It is noted that this architecture deliberately:

  • Supports multiple users working on a project simultaneously by allowing (from the same TUFLOW CATCH control file, see Section 4.5):
    • Simulation of TUFLOW HPC without needing to execute TUFLOW FV, and/or
    • Simulation of TUFLOW FV without needing to execute (or repeatedly execute) TUFLOW HPC
  • Aligns with the use of version control platforms to support multi-user co-development. Such use was intended as part of designing TUFLOW CATCH’s architecture, and it means that the same TUFLOW CATCH control file can be used by multiple users to initially independently drive TUFLOW HPC and TUFLOW FV model builds. When appropriate, version control techniques can then be used to unify model builds. This approach avoids the need to build disparate TUFLOW HPC and TUFLOW FV models, and then recast these into a TUFLOW CATCH control file framework: co-development is a core design feature of TUFLOW CATCH.

2.3 Core architecture

TUFLOW CATCH provides three primary functions:

  • Coordination of the execution of TUFLOW HPC and TUFLOW FV across a whole-of-catchment domain (Hydrology and Integrated configurations)
  • Automatic geolocation and writing of flow and concentration boundary conditions for TUFLOW FV (as the receiving water model), generated from TUFLOW HPC predictions (as the catchment model) (Hydrology and Integrated configurations)
  • Pollutant export and transport calculations within a catchment (Pollutant export and Integrated configurations)

The first of these is its core architectural capability and so is described here in Section 2.3.1. The latter two are technical componentry of this architecture and so are described in Sections 3.1 and 3.2, respectively.

2.3.1 Execution coordination

In Hydrology and Integrated configurations, TUFLOW CATCH overarches both TUFLOW HPC and TUFLOW FV to coordinate their execution to affect integrated numerical simulation of water and pollutant flows across a catchment and its receiving waters (the latter of which also includes water quality pollutant transformations). Whilst not undertaking equation solution itself, TUFLOW CATCH does coordinate these supporting TUFLOW products to do so in their respective domains, which are:

  • TUFLOW HPC: 1D and 2D surface and subsurface catchment hydrology and hydraulics, with or without pollutant export and transport
  • TUFLOW FV: 1D, 2D and 3D hydrodynamic, sediment transport, water quality and particle tracking (or user selectable module subsets/combinations thereof) receiving waterway modelling

The order of execution of TUFLOW HPC and TUFLOW FV, coordinated automatically under TUFLOW CATCH for each of the supported simulation configurations described in Section 1.3, is as follows.

2.3.1.1 Hydrology configuration

  1. Execute TUFLOW FV in test mode with the intention of
    1. Reading the TUFLOW FV model mesh and writing the associated mesh check file for subsequent use by TUFLOW HPC in its automatic geolocation processes
  2. Execute TUFLOW HPC, with the intention of
    1. Reading the TUFLOW FV mesh check files to determine the receiving water model domain location and extent
    2. Comparing this mesh with the TUFLOW HPC grid to then determine which TUFLOW HPC cells are to be designated as transfer cells where boundary conditions for TUFLOW FV are to be written (see Section 3.1) from TUFLOW HPC predictions
    3. Executing the TUFLOW HPC catchment based hydrologic and hydraulic modelling over the period specified
    4. Writing TUFLOW FV flow (and optionally constant and/or timeseries temperatures and salinities) boundary conditions at designated transfer cells
    5. Reporting map outputs such as water depth and velocity, as well as downstream timeseries of summed flows leaving the TUFLOW HPC domain
  3. Re-execute TUFLOW FV with the intention of
    1. Executing 1D, 2D and 3D hydrodynamic receiving waterway modelling, using the flow (and optionally temperature and salinity) boundary conditions developed by TUFLOW HPC above
    2. Reporting receiving waterway simulation results such as flows and velocity fields

2.3.1.2 Pollutant export configuration

  1. Execute TUFLOW HPC, with the intention of
    1. Reading a user specified GIS polygon that defines the areal extents of the downstream receiving waterway
    2. Comparing this polygon with the TUFLOW HPC grid to then determine which TUFLOW HPC cells are to be designated as deactivated cells
    3. Executing the TUFLOW HPC catchment based hydrologic, hydraulic and pollutant export modelling over the period specified
    4. Reporting map outputs such as water depth, velocity, dynamic pollutant concentrations in the surface and/or subsurface domains, dry store evolutions and/or erosion/deposition zones (see Section 3.2) and downstream timeseries of summed flows and pollutant loads leaving the TUFLOW HPC domain through the user specified GIS polygon

2.3.1.3 Integrated configuration

  1. Execute TUFLOW FV in test mode with the intention of
    1. Reading the TUFLOW FV model mesh and writing the associated mesh check file for subsequent use by TUFLOW HPC in its automatic geolocation processes
    2. Reading the TUFLOW FV sediment transport and/or water quality log files to determine the suite of constituents to be simulated in the receiving waterway, and therefore those that require specification and simulation as exported (or constant and/or timeseries) pollutants in TUFLOW HPC
  2. Execute TUFLOW HPC, with the intention of
    1. Reading the TUFLOW FV mesh check files to determine the receiving water model domain location and extent
    2. Comparing this mesh with the TUFLOW HPC grid to then determine which TUFLOW HPC cells are to be designated as transfer cells where boundary conditions for TUFLOW FV are to be written (see Section 3.1) from TUFLOW HPC predictions
    3. Checking the pollutants specified in the pollutant export model for consistency with those set in the TUFLOW FV simulation
    4. Executing the TUFLOW HPC catchment based hydrologic, hydraulic and pollutant export modelling over the period specified
    5. Writing TUFLOW FV boundary conditions at designated transfer cells, including assignment of constant and/or timeseries pollutants in addition to those computed dynamically within TUFLOW HPC
    6. Reporting catchment based simulation results such as water depth, velocity, dynamic pollutant concentrations in the surface and/or subsurface domains, dry store evolutions and/or erosion/deposition zones (see Section 3.2) and downstream summed flows and pollutant loads leaving the TUFLOW HPC domain and entering the TUFLOW FV mesh
  3. Re-execute TUFLOW FV with the intention of
    1. Executing 1D, 2D and 3D hydrodynamic, sediment transport, water quality and particle tracking (or user selectable module subsets/combinations thereof) receiving waterway modelling, using the boundary conditions developed by TUFLOW HPC above
    2. Reporting receiving waterway simulation results such as pollutant concentrations and diagnostic mass fluxes