5.1 Overview

This chapter describes the construction of a 2D Hydrodynamic (2D HD) simulation class. The 2D HD simulation class provides the foundation for all subsequent simulation classes and is typically the first simulation constructed.

A 2D HD simulation is configured through a single model initialisation process followed by definition of the required and optional model classes, as described in Section 2.2.2. Model classes introduced in this chapter form the basis for subsequent simulation classes and may be reused or extended in accordance with the simulation class architecture.

5.1.1 Using the Model Construction Chapters

All model construction chapters in this manual follow a consistent structure.

Each chapter begins with an overview, followed by a section for each model class applicable to the simulation class. For each model class, the following components are provided.

  1. Command Status, which identifies whether the model class is required, conditionally required, or optional for the simulation class.
  2. Description, which outlines the purpose of the model class and includes a summary table of applicable commands.
  3. One or more Model Implementation sections, which describe the supported configuration approaches for the model class.

Where applicable, model implementation sections include example TUFLOW FV syntax that may be copied directly into a control file.

Command summary tables provided in each model class Description section identify the commands required to configure the model class and provide direct links to the command appendix where each command is formally defined. Model construction chapters focus on configuration and workflow and reference supporting material in the appendices where appropriate. Navigation between the construction chapters and appendices is expected during model development.

5.1.2 Recommended Workflow for Model Construction

The recommended workflow for model construction is:

  1. Review the Architecture chapter to understand the simulation class framework and organisation of the construction chapters.
  2. Begin with the 2D HD simulation class and construct a 2D only model.
  3. For each model class, review the command status and description.
  4. Select an appropriate model implementation for required model classes and determine whether conditionally required or optional model classes are needed.
  5. Use the command tables to identify required commands and refer to the command appendix (Appendix A) for detailed input requirements, with reference to the Science appendix as required.
  6. Copy example syntax into the TUFLOW FV control file and modify as needed.
  7. Repeat this process for each model class until the simulation is complete.
  8. Extend the model to additional simulation classes as required.