Running an AlpineFlow simulation requires several steps:
1. Getting and compiling AlpineFlow
1. Preparing the input data
1. Configuring the simulation
1. Running the simulation
Please note that usually, you would do several iterations on the steps 2-6. The goal of this document is to describe these steps.
# Getting and compiling AlpineFlow
Please see [[Getting-started]]
# Preparing the input data
The input data for AlpineFlow consists of
* sub-catchments and river network files
* land use file
* meteorological files from Alpine3D
## Sub-catchments and river network files
These files are produced through the open source Taudem routines. The software can be found in the <AHREF="http://hydrology.usu.edu/taudem/taudem5/downloads.html">Taudem</A> web page.
In case you decide to run the routines on command lines, you can find a useful guide in the <AHREF="http://models.slf.ch/p/alpineflow/doc/">Documentation</A> section
There are three Taudem output files that you need for an AlpineFlow simulation:
* the ascii file containing the grid of sub-catchment partitioning (by default, Taudem saves it as "_w.tif" so a format conversion is needed)
* the text file containing the river network delineation (by default, Taudem saves it as "_tree.dat")
* the text file containing the coordinates of the stream pixels (by default, Taudem saves it as "_coord.dat")
Place "_w.asc" in "./input/DTM/", "_tree.dat" and "_coord.dat" in "./input/TAUDEM/" of your AlpineFlow simulation folder.
## Land use file
The land use file is an ascii grid in the PREVAH format (the same used by Alpine3D). It may have a different cell size and reference low left point than "_w.asc". Place this file in "./input/DTM/" of your AlpineFlow simulation folder.
## Meteorological files from Alpine3D
These files are
For a stream flow simulation only the first file is needed. For a stream temperature simulation all files are needed. Place these files in "./input/alpine3d/" of your AlpineFlow simulation folder.
# Configuring the simulation
To configure the simulation you need to edit two files
* "./input/param.dat", the file containing simulation parameters
* "./input/fileIO.dat", the file containing the name of input and output files
In the first file you have the possibility to change the value of the "physical" parameters of the simulation as well the flags that specify which modules of the code will be activated.
In the second file you have the possibility to change the name of your input and output file. Be sure to be consistent with the actual names of your input files to correctly parse the data!
# Run a simulation
Once the input data and the configuration files are ready and set, you can run your simulation by launching the "./alpineflow" command in the root of your AlpineFlow simulation folder