cumba_scenario()?While cumba_experiment() replays an observed irrigation
schedule, cumba_scenario() runs the model in
automatic deficit-irrigation mode. Irrigation is
triggered when, simultaneously:
ws = 1 - WSI, where WSI is the
simulated water-stress index) falls below a phase-specific
threshold (wsLevel), andturnMin days have elapsed since the last
irrigation.The water applied at each event refills the soil to field capacity in the rooted layers.
irrigationStrategy argumentThe irrigation logic is controlled by a single
irrigationStrategy argument — a named list
with one entry per phenological phase:
| Phase | Period |
|---|---|
vegetative |
transplanting → flowering |
reproductive |
flowering → mid-ripening |
ripening |
mid-ripening → harvest |
Each entry is a list with:
wsLevel — threshold (0–1) on the crop water status
ws = 1 - WSI. Irrigation fires when
ws < wsLevel, i.e. when WSI exceeds
1 - wsLevel.turnMin — minimum days between consecutive
irrigations.tomatoFoggialibrary(cumba)
library(dplyr)
library(ggplot2)
data(tomatoFoggia)
data(cumbaParameters)
weather <- tomatoFoggia$weather
out <- cumba_scenario(
weather = weather,
param = cumbaParameters,
estimateRad = TRUE,
estimateET0 = TRUE,
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)
),
fullOut = FALSE
)
head(out)
#> site year experiment doy p irrigation stage swc yield
#> 1 Foggia 2005 1 120 0 0 post-transplanting 29.80184 0
#> 2 Foggia 2005 1 121 0 0 post-transplanting 29.58283 0
#> 3 Foggia 2005 1 122 0 0 post-transplanting 29.37420 0
#> 4 Foggia 2005 1 123 0 0 post-transplanting 29.30290 0
#> 5 Foggia 2005 1 124 0 0 post-transplanting 29.25984 0
#> 6 Foggia 2005 1 125 0 0 post-transplanting 29.22264 0
#> brix
#> 1 0
#> 2 0
#> 3 0
#> 4 0
#> 5 0
#> 6 0Define a full-irrigation and a deficit strategy, then compare yield and Brix at harvest across all site-years:
full_irr <- list(
vegetative = list(wsLevel = 1.0, turnMin = 4),
reproductive = list(wsLevel = 1.0, turnMin = 4),
ripening = list(wsLevel = 1.0, turnMin = 4)
)
deficit <- list(
vegetative = list(wsLevel = 0.4, turnMin = 4),
reproductive = list(wsLevel = 0.4, turnMin = 4),
ripening = list(wsLevel = 0.3, turnMin = 4)
)
run_strategy <- function(strategy, label) {
cumba_scenario(
weather = weather,
param = cumbaParameters,
irrigationStrategy = strategy,
transplantingDOY = 120,
estimateRad = TRUE,
estimateET0 = TRUE,
fullOut = FALSE
) |>
mutate(strategy_label = label)
}
scen <- bind_rows(
run_strategy(full_irr, "Full irrigation"),
run_strategy(deficit, "Deficit irrigation")
)
# Last row per (strategy × site × year) = harvest day
harvest <- scen |>
group_by(strategy_label, site, year) |>
slice_tail(n = 1) |>
ungroup()
pal <- c("Full irrigation" = "#2166ac", "Deficit irrigation" = "#d6604d")
ggplot(harvest, aes(strategy_label, yield, fill = strategy_label)) +
geom_boxplot(width = 0.45, outlier.shape = 21, outlier.size = 2,
colour = "grey30", linewidth = 0.6) +
scale_fill_manual(values = pal) +
labs(y = "Yield (t ha⁻¹)", x = NULL,
title = "Yield response to irrigation strategy") +
theme_bw(base_size = 12) +
theme(legend.position = "none")
ggplot(harvest, aes(strategy_label, brix, fill = strategy_label)) +
geom_boxplot(width = 0.45, outlier.shape = 21, outlier.size = 2,
colour = "grey30", linewidth = 0.6) +
scale_fill_manual(values = pal) +
labs(y = "Brix (°Brix)", x = NULL,
title = "Brix response to irrigation strategy") +
theme_bw(base_size = 12) +
theme(legend.position = "none")scen_yr1 <- scen |> filter(year == min(year))
ggplot(scen_yr1, aes(doy)) +
geom_col(aes(y = irrigation, fill = strategy_label),
position = "dodge", width = 0.9, alpha = 0.5) +
geom_line(aes(y = swc, colour = strategy_label), linewidth = 0.9) +
scale_colour_manual(values = pal, name = NULL) +
scale_fill_manual(values = pal, name = NULL) +
labs(x = "Day of year",
y = "Soil water content (%) / Irrigation (mm)",
title = "Soil water and irrigation events — first year") +
theme_bw(base_size = 12) +
theme(legend.position = "bottom")cumba_scenario() does not require an
irrigation_df; the schedule is generated internally from
the stress thresholds.yield column in the short output is in t
ha⁻¹.fullOut = TRUE returns all internal state
variables (Kc, carbon pools, flowering state, soil water per layer,
etc.).irrigationStopCycle argument (default
100) sets the phenological cycle completion percentage
beyond which no further irrigation is applied — useful for
regulated-deficit ripening.