c1TIF: thickness integrated flow module

c1TIF is a module for debris flow computations using thickness integration. c1TIF executes AvaFrame::com1DFA with overwriting various parameters and adding debris-flow related features. Calculations are based on the thickness integrated governing equations and solved numerically using the smoothed particle hydrodynamics (sph) method. Please note the use of thickness averaged/integrated instead of depth averaged/integrated for clarity and consistency.

Thickness integrated flow simulations can be performed for different release scenarios, with or without entrainment and/or resistance areas, and is controlled via a configuration file. The configuration can be modified in order to change any of the default settings and also allows to perform simulations for varying parameters all at once.

Note

We provide the documentation of the most important debris flow related features here, for the entire documentation we refer to the AvaFrame documentation.

Note

The configuration parameters are still under development.

Input

c1TIF simulations are performed within a process directory, organized with the folder structure described in the AvaFrame documentation. Regarding the release- and entrainment thickness settings we refer to the respective AvaFrame section. Note that option 3 (thickness set via time dependent release file) is the default setting in c1TIF. This option is used for hydrographs as input.

Friction parameters

The available friction models are described here.

Erosion, Deposition, adaptive topography

When entrainment, detrainment or stopping (flow velocity is zero) occurs and the respective flags adaptSfcEntrainment, adaptSfcDetrainment and adaptSfcStopped are switched on, the surface is adapted accordingly (see the AvaFrame adaptive topography documentation). Additionally, the deposition can be erodible if entrainableDeposition is switched on.

Model configuration

The model configuration is read from a configuration file: c1TIF/c1TIFCfg.ini. In this file, all model parameters are listed and can be modified. These parameters overwrite the respective parameters of AvaFrame’s com1DFACfg.ini configuration file. We recommend to create a local copy and keep the default configuration in c1TIF/c1TIFCfg.ini untouched. For this purpose, in DebrisFrame/debrisframe/ run:

cp c1TIF/c1TIFCfg.ini c1TIF/local_c1TIFCfg.ini

and modify the parameter values in there.

It is also possible to perform multiple simulations at once, with varying input parameters.

Output

The simulation results are saved to: Outputs/com1DFA. The description of the default and optional results are in the AvaFrame documentation.

To run

first go to DebrisFrame/debrisframe
copy debrisframeCfg.ini to local_debrisframeCfg.ini and set your desired process directory name
create a process directory with required input files
copy c1TIF/c1TIFCfg.ini to c1TIF/local_c1TIFCfg.ini and if desired change configuration settings
run:
```
pixi run python runC1TIF.py
```

Theory

The theory and numerics of the thickness integrated flow model can be found in the AvaFrame documentation: com1DFA Theory.