add_losses: Add losses

In multiscape: Multi-Action, Multi-Objective Spatial Planning

Add losses

Description

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

multiscape documentation built on Oct. 12, 2026, 5:08 p.m.