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.
Run
| Parameters | Description | Type |
|---|---|---|
| run_id | Simulation identifier | character |
| date_start | Simulation start date | date |
| date_end | Simulation end date | date |
Crop
| Parameters | Description | Type |
|---|---|---|
| date_sowing | Sowing date | date |
| date_harvest | Harvest date | date |
| crop | Crop type identifier | NA |
| HIp | Potential harvest index | numeric |
| c1 | Asymptote coefficient in the canopy partition function Cp = c1 - exp(-c2 * LAI) | numeric |
| c2 | Shape coefficient in the canopy partition function Cp = c1 - exp(-c2 * LAI) | numeric |
| Kc_max | Maximum crop coefficient value | numeric |
| ratio_RDU_RU | Ratio between easily usable reserve and useful reserve. Threshold for reduction in transpiration, hence water stress. | numeric |
| TT_harvest | Harvest temperature (°C) | numeric |
| TT_maturity | Plant maturity temperature (°C) | numeric |
| TT_LAImax | Temperature at maximum LAI in the absence of stress (°C) | numeric |
| TT_flowering | Flowering temperature (°C) | numeric |
| TT_emerg | Emergence temperature (°C) | numeric |
| TT_root_install | Root system installation temperature (°C) | numeric |
| TT_B_root5 | Temperature for 5% of maximum root biomass (°C) | numeric |
| TT_B_root70 | Temperature for 70% of maximum root biomass (°C) | numeric |
| Tgel | Temperature for the onset of frost damage (°C) | numeric |
| Tbase | Base temperature (plant development) | numeric |
| RUE | Radiation Use Efficiency (g DM per MJ of PAR) | numeric |
| LAImax | Maximum LAI (Leaf Area Index) | numeric |
| Tmax | Constant for thermal stress calculation | numeric |
| beta | Shape parameter “amplitude x” [growth/senescence] of the logistic for LAI | numeric |
| alpha1 | Shape parameter “slope” [growth] of the logistic for LAI | numeric |
| alpha2 | Shape parameter “slope” [senescence] of the logistic for LAI | numeric |
| degred | Base daily root depth growth rate per degree day | numeric |
| seuil | Root growth parameter | numeric |
| vroot | Root growth rate | numeric |
| racplus | Root growth parameter | numeric |
| vrac | Root growth parameter | numeric |
| estress_lai | LAI stress nocivity value | numeric |
| TTnorm_LTsat | Normalised thermal-time value kept for future senescence controls. | numeric |
| LAImin | Minimum LAI targeted by the damping rule during senescence. Use NA to disable. | numeric |
| k | Senescence damping coefficient used to limit daily LAI loss towards LAImin. Use NA to disable. | numeric |
| estress_b | biomass stress nocivity value | numeric |
Soil
| Parameters | Description | Type |
|---|---|---|
| soil | Soil type identifier | NA |
| psand | Percentage of Sand | numeric |
| pclay | Percentage of Clay | numeric |
| zES | Soil evaporation front (m) | numeric |
| Ksol | Crop coefficient for bare soil | numeric |
| Ks | Saturated hydraulic conductivity (mm/h) | numeric |
| zmax | Maximum root or profile depth: choose the most limiting | numeric |
| theta_fc | Field capacity | numeric |
| theta_wp | Wilting point | numeric |
| theta_r | Residual water content | numeric |
| theta_sat | Saturated water content | numeric |
| theta_raw | Raw water content used to calculate the water stress | numeric |
| R_init | Initial reserve content (NA if not applicable) (mm) | numeric |
| ratio_R_init | Percentage of the useful reserve initially contained in the soil (%) | numeric |
| mulch | Mulch effect, reduction of soil evaporation by a factor of 1/(1+mulch) | numeric |
Yield
| Parameters | Description | Type |
|---|---|---|
| humgrec | Target grain moisture at harvest | numeric |
| humgsec | Target grain moisture after drying | numeric |
| TT_ms | Starting temperature (°C) for the capacitor charging of sugar mass percentage in the roots — i.e. the temperature at which sugar begins to accumulate (be stored) in the roots | numeric |
| tau | Time constant (days) of the capacitor for sugar accumulation in the roots | numeric |
| max_sugar_rate | Maximum sugar rate in the roots function of Biomass (%) | numeric |
Economics
| Parameters | Description | Type |
|---|---|---|
| f1fix | Fixed costs for site management (salaries, subscriptions, inputs, energy) | numeric |
| f2sec | Costs related to drying the harvest (in € per ton for 1% moisture reduction in grain) | numeric |
| f2varirr | Variable costs related to water consumption for irrigation | numeric |
| f2varnrj | Variable costs related to energy consumption for irrigation | numeric |
| f3vente | Selling price of the crop | numeric |
Irrigation (option)
| Parameters | Description | Type |
|---|---|---|
| irrigation | Irrigation data file | character |
| tbis_mod | Option to switch irrigation strategies based on thermal time | numeric |
| TT_d | Thermal time threshold used to switch irrigation strategy when tbis_mod > 0 | numeric |
| gge | Option for irrigation technique: 0 for ASP, 999 for GGE. If gge=999 and mulch=1000, then mulch becomes mulch=0.1 to simulate GGS | numeric |
| irrig_mod | irrig_mod = 0 reads irrigation dates and doses from file; irrig_mod = 1 triggers irrigation from rule-based criteria | numeric |
| irrig_strategy_start | Start date of the irrigation strategy window | date |
| irrig_strategy_end | End date of the irrigation strategy window | date |
| RU_thrld | Available water threshold to trigger irrigation (if iStrat=1 and other possible triggering thresholds are = NA) | numeric |
| THETA_thrld | Available moisture threshold to trigger irrigation (if iStrat=1 and other possible triggering thresholds are = NA) | numeric |
| ETM_thrld | Evapotranspiration threshold (if iStrat=1; mm) | numeric |
| ETM_ndays | Number of consecutive days used to check whether water inputs (rain + irrigation) satisfy climatic demand (ETM) | numeric |
| SW_thrld | Water stress threshold to trigger irrigation (if iStrat=1 and other possible triggering thresholds are = NA) | numeric |
| SW_ndays | Number of consecutive days used to check the mean water stress | numeric |
| PI_thrld | Threshold on the sum of precipitation (P) and irrigation (I) over a given period | numeric |
| PI_ndays | Number of consecutive day for rainfall and irrigation | numeric |
| T_thrld | Average temperature threshold over a period. It is a threshold value beyond which the recent temperature is considered abnormally high or critical | numeric |
| T_ndays | Number of day to check mean temperature | numeric |
| WTurn_ndays | Frequency for irrigation water round return | numeric |
| WTurn_mod | Water turn mode (0 = no turn constraint, 1 = irrigate only on marked turn days, 2 = irrigate after any turn since the last irrigation) | numeric |
| LTurn_ndays | Minimum number of days between irrigations. Use NA to disable this rule. | numeric |
| RU_units | Unit code for RU thresholds and targets (1 = mm, 2 = % of available water) | numeric |
| RU_target | Target RU to reach with irrigation decision | numeric |
| THETA_target | Target THETA to reach with irrigation decision | numeric |
| dose_fix | Dose applied at each irrigation (if iStrat=1) | numeric |
| quota_max | Irrigation quota over the season | numeric |
| irrig_constraints_start | Start date of the irrigation constraints window | date |
| irrig_constraints_end | End date of the irrigation constraints window | date |
| dose_min | Minimal dose applied at each irrigation (if iStrat=1) | numeric |
| dose_max | Maximal dose applied at each irrigation (if iStrat=1) | numeric |
| quota_wind | Maximal irrigation quota over a given period (if constraints are active) | numeric |
| irrig_not_allowed | Dates where irrigation is not allowed (e.g. due to operational constraints) | date |