TUFLOW Classic/HPC User Manual 2026.3
  1. Appendices
  2. H  QCF Commands
  • TUFLOW Classic/HPC User Manual
  • Overview
  • 1  Introduction
  • 2  Getting Started
  • 3  Hydraulic Modelling Fundamentals
  • 4  Control Files and Input Layers
  • 5  1D Network Domains - ESTRY
  • 6  1D Network Domains - EPA SWMM
  • 7  2D Domains
  • 8  Boundaries and Initial Conditions
  • 9  Advection Dispersion
  • 10  Combining Domains and Solvers
  • 11  Outputs
  • 12  Hardware and Operating System
  • 13  Managing and Starting Simulations
  • 14  Checks and Log Files
  • 15  Viewing Outputs
  • 16  Quality Control and Troubleshooting
  • 17  Utilities
  • 18  Default Changes
  • References
  • Appendices
    • A  TCF Commands
    • B  ECF Commands
    • C  TGC Commands
    • D  TBC Commands
    • E  TOC Commands
    • F  TRFC Commands
    • G  TESF Commands
    • H  QCF Commands
    • I  TSCF Commands
    • J  ADCF Commands
    • K  TEF Commands
    • L  SWMM GeoPackage Format

Table of contents

  • H.1 QCF Commands
    • Base Cell Size == <cell_size> | {TGC}
    • If Event == <e1> | <e2> | <e3> | …
    • If Scenario == <s1> | <s2> | <s3> | …
    • Model Origin and Extent == {Auto} | TGC
    • Orientation Angle == <angle> | Optimise | {TGC}
    • Quadtree Mesh Processing Method == {FAST} | Memory Efficient
    • Read GIS Nesting == <gis_file_in_2d_qnl_format>
    • Spatial Database == OFF | TCF
  1. Appendices
  2. H  QCF Commands

Appendix H — QCF Commands

The Quadtree Control File (.qcf) is used to define the grid refinement areas and optionally the model location and extent, it is read into the .tcf using the Quadtree Control File command. For more information on the .qcf see Section 4.1.9. Setting up a quadtree grid is discussed in Section 7.3.1. The available QCF commands are listed below. For an explanation of the command syntax, see Commands.

H.1 QCF Commands

Base Cell Size == <cell_size> | {TGC}

Status: Optional
Solver: HPC

Used to set the Level 1 (parent) cell size. If set to “TGC”, then the cell size defined in the .tgc is used. If set to a numerical value, can be used to override the cell size command in the .tgc file. Using metric units (default) the value is in metres. Using Units == US Customary, the value is in feet. See Section 7.3.1 for more details.

If Event == <e1> | <e2> | <e3> | …

Status: Optional
Solver: Classic and HPC

Controls which commands to process for different events (see Appendix A).

If Scenario == <s1> | <s2> | <s3> | …

Status: Optional
Solver: Classic and HPC

Controls which commands to process for different scenarios (see Appendix A).

Model Origin and Extent == {Auto} | TGC

Status: Required
Solver: HPC

If set to “Auto” the extents of the Level 1 GIS polygon are used to define the model origin and extents. If set to “TGC”, the model is located as per the commands in the .tgc file. Note the angle of the model is defined with the Orientation Angle command below. Also note, if set to “Auto” the GIS nesting polygons must have a Level 1 polygon defined, otherwise an ERROR is generated. The default setting is “TGC” if Quadtree Control File == Single Level and “Auto” if a .qcf (e.g. Quadtree Control File == <.qcf>) is specified. See Section 7.3.1 for more details.

Orientation Angle == <angle> | Optimise | {TGC}

Status: Optional
Solver: HPC

If set to a numerical value (in degrees) defines the model orientation angle and overwrites any angle / location .tgc commands. If Set to “Optimise” the parent Level 1 polygon is used to optimise the angle of the mesh. As such the GIS nesting polygon must have a Level 1 polygon defined. See Section 7.3.1 for more details.

Quadtree Mesh Processing Method == {FAST} | Memory Efficient

Status: Optional
Solver: HPC

When pre-processing the Quadtree mesh, a hidden 2D domain is used for areas of refinement to allow fast processing of geometry on a regular grid. The default approach, “FAST”, treats each nesting level as a domain, and with 3 levels of nesting the geometry control file is processed 3 times. To reduce initialisation memory demands it is possible to treat each GIS polygon in the 2d_qnl as a separate domain for the processing of geometry inputs by setting this command to “Memory Efficient”. Whilst being more memory efficient during mesh creation, this may be slower to initialise. It has no effect on the speed of the hydraulic computations or the memory demand during the hydraulic calculations. See Section 7.3.1 for more details.

Read GIS Nesting == <gis_file_in_2d_qnl_format>

Status: Required
Solver: HPC

Used to define polygons of mesh refinement (different levels). Uses 2d_qnl GIS layers, as described Section 7.3.1.3. See Section 7.3.1 for more details.

Spatial Database == OFF | TCF

Status: Optional
Solver: HPC

Optional when using the GeoPackage input format. Sets the database to use for subsequent inputs. See Section 4.3.3.

G  TESF Commands
I  TSCF Commands