Create an SDM scenario

Top-level container for one structured decision analysis. Assigns generic keys (obj_N, group_N, alt_N) to all components and names weight/metric vectors to match objective keys.

Usage

sdm_scenario(name, species, objectives, groups, alternatives, unit = NULL)

Arguments

name

Character. Scenario name (e.g., "Moose Harvest Review 2026").

species

Character. Species label (e.g., "Moose").

objectives

List of sdm_objective() objects (2–7).

groups

List of sdm_group() objects (2–6).

alternatives

List of sdm_alternative() objects (2–5).

unit

Character. Optional unit/jurisdiction label (e.g., "WMU 300").

Value

An sdm_scenario object (named list with class "sdm_scenario"). Fields: id, name, species, unit, objectives, groups, alternatives, _next_obj, _next_group, _next_alt.

Examples

objs <- list(
  sdm_objective("Opportunity", "Licenses issued",
    "higher_is_better", c(0, 10000), c(8, 5, 4, 2, 1)),
  sdm_objective("Sustainability", "Growth rate",
    "higher_is_better", c(0.8, 1.3), c(10, 6, 2, 1, 1))
)
grps <- list(
  sdm_group("Hunter", "Wants tags", c(0.7, 0.3)),
  sdm_group("Conservationist", "Wants growth", c(0.2, 0.8))
)
alts <- list(
  sdm_alternative("Status Quo", "Current regs", c(5000, 0.98)),
  sdm_alternative("Conservative", "Reduced harvest", c(3000, 1.08))
)
scn <- sdm_scenario("Example", "Elk",
  objectives = objs, groups = grps, alternatives = alts)
scn$name
#> [1] "Example"
length(scn$objectives)
#> [1] 2