Skip to contents

Introduction

This vignette serves as a comprehensive guide to the parameters used in the OptirrigCORE project. It provides detailed explanations and references for each parameter, helping users understand their purpose and how to configure them effectively. Whether you are a new user or an experienced developer, this document will assist you in making the most of the parameter settings.

Crop

Variables Description
TT Cumulative thermal time since simulation start (°C.days)
TT_sowing Cumulative thermal time since sowing (°C.days)
TT_LAI Thermal time since emergence used for LAI development (°C.days)
TT_root Thermal time since the root-installation threshold (°C.days)
TT_LAI_norm Normalised thermal time for LAI development
alpha Shape parameter “slope” [growth or senescence] of the logistic for LAI
LT Logistic thermal index used to compute potential LAI
LAIp Potential leaf area index (LAI) in the absence of water stress (m²/m²)
LAI Actual leaf area index (LAI) accounting for stress (m²/m²)
degred Daily root depth growth rate per degree day
zrootp Potential root depth (m)
Tcrit Critical temperature threshold for thermal stress (°C)
B Total dry matter of the plant (t.ha⁻¹)
Bp Potential total dry matter of the plant (t.ha⁻¹)
B_root Root dry matter of the plant (t.ha⁻¹)
Bp_root Potential root dry matter of the plant (t.ha⁻¹)
iday_sowing Sowing-day index (currently not populated)
iday_harvest Harvest-day index (currently not populated)
iday_emerg Emergence-day index (1 on emergence day, 0 otherwise)
iday_root_install Root-installation-day index (1 on the first root installation day, 0 otherwise)
iday_crop_dev Crop development index (1 during active crop development, 0 otherwise)
stress_ES Evaporation stress
stress_TP Transpiration stress
stress_ETR Evapotranspiration stress
stress_T Thermal stress
stress_LAI Combined stress affecting LAI development
stress_B Combined stress affecting biomass accumulation
stress_noci_LAI LAI stress + nocivity
stress_noci_B Biomass stress + nocivity
taum Root growth parameter used in dzroot calculation
crac Root growth coefficient computed from taum, ks_root and seuil
ks_root Root growth water-stress indicator based on soil moisture
dzrootp Potential daily root depth increment (m)
dzroot Actual daily root depth increment (m)
zroot Crop root depth (m)
case Water-balance case indicator (0 = no active root zone, 1 = zroot <= zES, 2 = zroot > zES)
Kc Daily crop coefficient
IR Intercepted radiation fraction by the canopy (0-1)
IRp Potential intercepted radiation fraction by the canopy (0-1)
PAR Photosynthetically active radiation (J.cm⁻².day⁻¹)
Cp Partition coefficient between ES0 and TP0 (“canopy variable”)
sugar_accumulation Daily sugar accumulation in roots (t.ha⁻¹)
Y_sugar Daily yield of sugar (t.ha⁻¹)
Yp_sugar Daily potential yield of sugar (t.ha⁻¹)

Water Balance

Variables Description
ET0 Potential reference evapotranspiration (mm)
ES0 Potential daily evaporation (mm)
TP0 Potential daily transpiration (mm)
ETM Potential daily evapotranspiration (mm)
theta1_init Initial theta content in R1 (m3/m3)
theta2_init Initial theta content in R2 (m3/m3)
theta3_init Initial theta content in R3 (m3/m3)
z1_init Initial value of the depth of the soil layer R1 (m)
z2_init Initial value of the depth of the soil layer R2 (m)
z3_init Initial value of the depth of the soil layer R3 (m)
z1 Depth of the soil layer R1 (m)
z2 Depth of the soil layer R2 (m)
z3 Depth of the soil layer R3 (m)
R1 Soil water reserve in R1 (mm)
R2 Soil water reserve in R2 (mm)
R3 Soil water reserve in R3 (mm)
theta1 Theta content in R1 (m3/m3)
theta2 Theta content in R2 (m3/m3)
theta3 Theta content in R3 (m3/m3)
I1 Irrigation dose (mm)
Kd1 Infiltration rate in R1 (mm/h)
Kd2 Infiltration rate in R2 (mm/h)
Kd3 Infiltration rate in R3 (mm/h)
Rgravity1 Gravitational water in R1 above field capacity (mm)
Rgravity2 Gravitational water in R2 above field capacity (mm)
Rgravity3 Gravitational water in R3 above field capacity (mm)
d1 Drainage from R1 (mm)
d2 Drainage from R2 (mm)
d3 Drainage from R3 (mm)
RU1 Available water in R1 (mm)
RU2 Available water in R2 (mm)
RU3 Available water in R3 (mm)
KES1 Kc for R1 evaporation need
KES2 Kc for R2 evaporation need
ES1 Evaporation from R1 (mm)
ES2 Evaporation from R2 (mm)
ES Total soil evaporation (ES1 + ES2) (mm)
KTP1 Kc for R1 transpiration need
KTP2 Kc for R2 transpiration need
TP1 Transpiration from R1 (mm)
TP2 Transpiration from R2 (mm)
TP Real transpiration (mm)
ETR Real evapotranspiration (mm)
R Total water reserve (mm)
RU Total available water (mm)
RU_root Available water in the root zone (mm)
RU1max Maximum available water in R1 (mm)
RU2max Maximum available water in R2 (mm)
RU3max Maximum available water in R3 (mm)
RUmax Maximum available water in the soil profile (mm)
RUmax_root Maximum available water in the root zone (mm)

Yield/Economics

Variables Description
HI Harvest index
HI_p Potential harvest index
Y Yield
Yp Potential yield
Financial Reserved financial output placeholder (finance module not implemented)
F_a Reserved financial output placeholder (finance module not implemented)
yE Silage yield (forage)
F0 Financial yield of completely dry grain (oven, HuG=0)
FhuG Financial yield of moist grain at HuG%
FhuGs Financial yield of grain dried to HuGS%
FE Financial yield of silage (forage)
ratio_Y Yield ratio

Irrigation

Variables Description
iday_strategy Irrigation strategy period index (0 = outside any strategy period)
iday_constraints Irrigation constraints period index (0 = outside any constraints period)
iday_no_irrig Irrigation allowed index (1 = allowed, 0 = forbidden)
iday_waterturn Water-turn-day index (1 on marked turn days, 0 otherwise)
iday_tbis Legacy TBIS period index (currently not populated)
W_need Irrigation dose requested before constraints are applied (mm)
RU_daily_perc Legacy routing percentage placeholder (currently not populated)
W_eff Effective water input used by the routing routine (P + I1 + R0) (mm)