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) |
