Outputs

Outputs from a simulation are saved in a folder named after the simulation name. The folder content depends on the type of run: single simulation, calibration, or forecast.

Different kinds of ouptut are available.

The outputs table in the TOML configuration file is used to select the outputs to save. The following keys are available:

[outputs]
# Save water balance components of each watershed
budget = true
# Save the calibration results in a csv file
metrics = true
# Save the physical parameters in a csv file
parameters = true
# Save the simulation final states in a csv file
states = true
# Save the simulation settings in a toml file.
toml = true

Simulation run

Depending on the TOML configuration file settings, the output folder contains the following files and folders:

• budget: a folder containing csv files with the water balance components of each watershed,

• riverflow.csv: a csv file containng the river flow at the outlet of each watershed,

• watertable.csv: a csv file containng the groundwater level for each watershed,

• parameters.csv: a csv file containing the physical parameters of each watershed,

• parameters.toml: a toml file containing all the settings and the physical parameters of each watershed,

• final_states.csv: a csv file containing the final states of each watershed,

• metrics_riverflow.csv: a csv file containing the metrics for the river flow at the outlet of each watershed

• metrics_watertable.csv: a csv file containing the metrics for the groundwater level of each watershed,

Metrics are computed from the simulation starting date to the simulation ending date, which corresponds to the end of the meteorological data.

Optimization run

Two supplementary files are saved in the output folder:

• metrics_opti_riverflow.csv: a csv file containing the metrics for the river flow at the outlet of each watershed

• metrics_opti_watertable.csv: a csv file containing the metrics for the groundwater level of each watershed,

These metrics are computed from the starting date to the ending date specified in the [optimization] table of the TOML configuration file.

The parameters.toml file contains the calibrated physical parameters of each watershed. It can be reused for a new simulation run.

Forecast run

During a forecast run, results are stored in a folder named forecast. This folder contains the following files:

• riverflow.csv: a csv file containing the river flow at the outlet of each watershed from the simulation starting date to the emission date of the forecast,

• watertable.csv: a csv file containing the groundwater levels of each watershed from the simulation starting date to the emission date of the forecast,

• riverflow_#.csv: a cluster of files containing the river flow at the outlet of each watershed for each ensemble member from the emission date to the end of the forecast,

• watertable_#.csv: a cluster of files containing the groundwater levels at the outlet of each watershed for each ensemble member from the emission date to the end of the forecast.

Format of the output files

Rameau saves most of the outputs in csv files. Separator is a semicolon. The header contains the watersheds ids. The first column is the date and the subsequent columns contains the time series of the output variable for each watershed.

Exceptions apply to some outputs for which the header corresponds to the output variable name and each line to a watershed.

parameters

Header	Definition	Unit
ID	Watershed identifier
Name	Simulation name
Rainfall_corr	Rainfall correction factor	%
PET_corr	PET correction factor	%
Area_corr	Drainage area correction factor
Concentration_time	Watershed oncentration time	time step unit
Propagation_time	Upstream river flow propagation time	time step unit
Thorn_capacity	Thornthwaite reservoir soil capacity	mm
Progr_capacity	Progressive reservoir soil capacity	mm
Transfer_halflife	Transfer reservoir halflife time	months
Overflow_threshold	Overflow threshold of the transfer reservoir	mm
Overflow_halflife	Overflow halflife time of the transfer reservoir	time step unit
Snow_retention	Maximum snow retention in the snowpack
Snow_soil_melting	Snow melting by soil calories	1/10 \(\mathrm{mm.day^{-1}}\)
Snow_temp_corr	Additive temperature correction	°C
Snow_pet_corr	PET correction factor in the snowpack	%
Snow_rainfall_corr	Corretion factor of snow melting by rainfall calories	%
Snow_degreeday_coef	Degree day model coefficient
Snow_degreeday_temp	Degree day model temperature threshold	°C
Pump_riv_coef	Coefficient of the river pumping reservoir
Pump_riv_rise	Rising halflife time of the river pumping reservoir	months
Pump_riv_fall	Falling halflife time of the river pumping reservoir	months
Pump_gw_coef	Rising halflife time of the groundwater pumping reservoir
Pump_gw_rise	Rising halflife time of the groundwater pumping reservoir	months
Pump_gw_fall	Falling halflife time of the groundwater pumping reservoir	months
Gw_storage	Groundwater storage coefficient	%
Gw_base_level	Groundwater base level	m
Gw_drainage.#	Groundwater drainage halflife time	months
Gw_baseflow.#	Groundwater baseflow halflife time	months
Gw_exchanges.#	Groundwater exchanges with outside the watershed	%
Gw_threshold.#	Overflow threshold of the groundwater reservoir	mm
Gw_overflow.#	Overflow halflife time of the groundwater reservoir	time step unit
Infl_gw_coef.#	Coefficient of the #th groundwater influence
Infl_gw_rise.#	Rising halflife time of the #th groundwater influence	months
Infl_gw_fall.#	Falling halflife time of the #th groundwater influence	months

metrics csv files

Field	Definition
ID	Watershed identifier
Name	Simulation name
NSE	Nash-Sutcliffe efficiency
KGE	Kling-Gupta efficiency
KGE_2012	Kling-Gupta efficiency 2012
NSE_sqrt	Nash-Sutcliffe efficiency with square root transformation
KGE_sqrt	Kling-Gupta efficiency with square root transformation
KGE_2012_sqrt	Kling-Gupta efficiency 2012 with square root transformation
NSE_log	Nash-Sutcliffe efficiency with log transformation
KGE_log	Kling-Gupta efficiency with log transformation
KGE_2012_log	Kling-Gupta efficiency 2012 with log transformation
Ratio	Ratio of the simulated river flow to the observed river flow

final_states.csv

This file contains the states of each reservoir. It can be reused in another simulation as initial states.