Runs the daily time-step CUMBA simulation in scenario (automatic
irrigation) mode. Unlike cumba, which requires an observed
irrigation schedule, cumba_scenario computes irrigation
autonomously based on the crop water stress index, phenological stage, and
user-defined stress thresholds. This is the function used by the CUMBA
Shiny app for decision support and what-if analysis.
Usage
cumba_scenario(
weather,
param,
estimateRad = TRUE,
estimateET0 = TRUE,
transplantingDOY = 120,
irrigationStrategy = list(vegetative = list(wsLevel = 0.5, turnMin = 2), reproductive =
list(wsLevel = 0.5, turnMin = 2), ripening = list(wsLevel = 0.5, turnMin = 2)),
irrigationStopCycle = 100,
irrigationEfficiency = 0.9,
fullOut = FALSE,
irrigationOverride = NULL,
verbose = FALSE
)Arguments
- weather
A
data.frame(or tibble) of daily weather by site. See Required weather columns above.- param
Model parameters. Either a named list where each element is itself a list with fields
value,min,max,description(as returned bycumbaParameters), or a tibble/data.frame of numeric parameter values already unpacked. Seecumbafor the full list of required parameter names.- estimateRad
Logical. If
TRUE(default), solar radiation is estimated from temperature (Hargreaves);Latmust be inweather. IfFALSE,weathermust includeRad.- estimateET0
Logical. If
TRUE(default), ET0 is estimated from temperature (Hargreaves). IfFALSE,weathermust includeET0.- transplantingDOY
Integer. Day of year (1-365) of transplanting. The model starts accumulating GDD and running the water balance from this day. Default
120(approx. 30 April).- irrigationStrategy
A named list with three phenological phases -
vegetative,reproductive,ripening- each containing:wsLevelNumeric (0-1). Per-phase threshold applied to
ws = 1 - WSI, the complement of the water-stress indexWSI(derived from the fraction of transpirable soil water; 0 = no stress, 1 = maximum stress). Irrigation is triggered whenws < wsLevel, i.e. whenWSIexceeds1 - wsLevel; higher values trigger at lower stress and keep the soil wetter (1approaches full irrigation).turnMinInteger. Minimum number of days that must have elapsed since the last irrigation event before a new one is allowed.
Default: all phases use
wsLevel = 0.5andturnMin = 2.- irrigationStopCycle
Numeric (0-100). Cycle-completion percentage beyond which automatic irrigation is suppressed regardless of crop water status. Useful to implement a cut-off irrigation strategy near harvest. Default
100(no cut-off; irrigation runs until the end of the cycle).- irrigationEfficiency
Numeric (0-1). Fraction of applied water that effectively reaches the root zone. Default
0.9(90%, typical for drip irrigation). The model computes the net soil-water deficit and divides it by this value to obtain the gross volume the farmer must apply; theirrigationcolumn in the output reports this gross amount, while the soil water balance uses only the net fraction (gross * efficiency). Set to1to disable the efficiency correction (e.g. for sprinkler or furrow irrigation where efficiency is accounted for elsewhere).- fullOut
Logical. If
FALSE(default), the function returns the key agronomic outputs (stage,swc,yield,brix,irrigation,p) plus site/date identifiers. IfTRUE, all internal state variables are included.- irrigationOverride
A
data.frame(orNULL) that lets the user manually override the model's automatic irrigation decision for specific dates. Must contain columnsdate(classDate) andaction("skip"or"applied"). An optionalmmcolumn specifies the volume whenaction = "applied"."skip"Forces
irrigation = 0on that date, even if the model would have irrigated."applied"Forces
irrigation = mmon that date, even if the model would not have irrigated.
Default
NULL(no overrides).- verbose
Logical. If
TRUE, progress messages are printed to the console; defaultFALSE.
Value
A data.frame of daily outputs. When fullOut = FALSE
(default) the columns are: site, year, doy,
p (precipitation, mm), irrigation (mm),
stage (phenological stage label), swc (soil water
content, %), yield (fruit fresh weight, t/ha), brix
(degrees Brix). When fullOut = TRUE, all internal state variables
are included.
Details
On each simulated day the model: (1) updates the two-layer soil-water
balance; (2) computes the water-stress index WSI from the fraction
of transpirable soil water (FTSW), and its complement ws = 1 - WSI;
(3) decides whether to irrigate - irrigation is applied when
ws < wsLevel for the current
phase, at least turnMin days have elapsed since the last event,
cycleCompletion < irrigationStopCycle, and the crop is in an active
phenological phase (phenoCode > 0); (4) applies
irrigationEfficiency so that the gross applied volume equals
net deficit / efficiency while only the net fraction enters the
soil; (5) computes biomass accumulation, fruit growth, and Brix dynamics.
Any irrigationOverride entries are applied after the automatic
decision and before the water-balance update, so they correctly propagate
to soil moisture in subsequent days.
The function prints "CUMBA running in deficit irrigation mode" in
blue (via crayon) when called.
Required weather columns
weather must contain Site, Tx, Tn, P,
DATE. Additionally:
if
estimateRad = TRUE(default),Latis required;if
estimateRad = FALSE,Radmust be present;if
estimateET0 = FALSE,ET0must be present.
See also
cumba for the experiment-mode runner that requires
an observed irrigation schedule; cumbaParameters for the
default parameter set.
Examples
data(tomatoFoggia)
data(cumbaParameters)
# Autonomous deficit-irrigation scenario on one growing season
wx <- subset(tomatoFoggia$weather, format(DATE, "%Y") == "2018")
out <- cumba_scenario(
weather = wx,
param = cumbaParameters,
transplantingDOY = 120,
irrigationStrategy = list(
vegetative = list(wsLevel = 0.5, turnMin = 4),
reproductive = list(wsLevel = 0.5, turnMin = 4),
ripening = list(wsLevel = 0.5, turnMin = 4)
)
)
head(out)
#> site year experiment doy p irrigation stage swc yield
#> 1 Foggia 2018 1 120 0.0 0 post-transplanting 29.74483 0
#> 2 Foggia 2018 1 121 0.0 0 post-transplanting 29.54968 0
#> 3 Foggia 2018 1 122 24.8 0 post-transplanting 30.00000 0
#> 4 Foggia 2018 1 123 24.8 0 post-transplanting 30.00000 0
#> 5 Foggia 2018 1 124 0.0 0 post-transplanting 29.80320 0
#> 6 Foggia 2018 1 125 4.8 0 post-transplanting 29.80934 0
#> brix
#> 1 0
#> 2 0
#> 3 0
#> 4 0
#> 5 0
#> 6 0
