Add losses

Legacy convenience wrapper around add_effects that retains only negative signed changes (effect < 0). Negative change does not necessarily imply an ecological loss. For new code, prefer add_effects() to retain signed effects of both directions. Effects can be defined only once per problem.

Usage

add_losses(
  x,
  losses = NULL,
  effect_type = c("delta", "after"),
  effect_aggregation = c("sum", "mean")
)

Arguments

x

A Problem created by create_problem with feasible actions already defined by add_actions.

losses

Alias of effects, used for symmetry with add_benefits().

effect_type

Deprecated interpretation argument: "delta" for signed changes or "after" for expected amounts. Legacy multipliers retain their original interpretation; omit for modern tables.

effect_aggregation

Deprecated raster aggregation argument; use raster_aggregation instead.

Value

An updated Problem object containing:

dist_effects

The canonical filtered effects table, containing only rows with loss > 0.

dist_loss

A convenience table containing only the loss component.

losses_meta

Metadata for the stored loss table.

See also

add_effects, add_benefits, add_objective_min_loss