Skip to contents

Defines a stakeholder group with objective weights. Groups are archetypes representing common patterns of priority (e.g., "Opportunity Hunter", "Conservation Advocate"), not real individuals. Weights are normalized to sum to exactly 1.0 if within tolerance (0.01).

Usage

sdm_group(name, description, weights)

Arguments

name

Character. Human-readable name (e.g., "Opportunity Hunter").

description

Character. Plain language description (e.g., "Prioritizes license availability and total harvest").

weights

Numeric vector. One weight per objective. Can be unnamed (names are assigned as obj_N by sdm_scenario()). Must sum to approximately 1.0 (within 0.01). A weight of 0 means that objective is excluded from the group's evaluation.

Value

An sdm_group object (named list with class "sdm_group"). Fields: id (assigned as group_N by sdm_scenario(), NULL until then), name, description, weights.

Examples

grp <- sdm_group(
  name = "Opportunity Hunter",
  description = "Prioritizes license availability",
  weights = c(0.70, 0.30)
)
grp$weights
#> [1] 0.7 0.3
sum(grp$weights)
#> [1] 1