agg_totals: Aggregate Across Groups

In mcmodule: Modular Monte Carlo Risk Analysis

Aggregate Across Groups

Description

Combines node values across specified grouping variables using different aggregation methods. The aggregation method can be specified via agg_func parameter:

• "prob": Combined probability assuming independence

• "sum": Sum of values

• "avg": Average of values

• NULL: defaults to "sum" if mc_name ends in "_n", else defaults to "prob"

Usage

agg_totals(
  mcmodule,
  mc_name,
  agg_keys = NULL,
  agg_suffix = NULL,
  prefix = NULL,
  name = NULL,
  summary = TRUE,
  keep_variates = FALSE,
  agg_func = NULL
)

Arguments

mcmodule	mcmodule object containing nodes and data
mc_name	name of node to aggregate
agg_keys	grouping variables for aggregation
agg_suffix	Suffix for aggregated node name (default: "agg")
prefix	Optional prefix for output node name - includes metadata as add_prefix() (default: NULL)
name	Custom name for output node (optional)
summary	whether to include summary statistics (default: TRUE)
keep_variates	whether to preserve individual values (default: FALSE)
agg_func	aggregation method ("prob", "sum", "avg", or NULL)

Value

mcmodule with new aggregated node added

Examples

imports_mcmodule <- agg_totals(
  imports_mcmodule, "no_detect_a",
  agg_keys = c("scenario_id", "pathogen")
)
print(imports_mcmodule$node_list$no_detect_a_agg$summary)

mcmodule documentation built on Nov. 25, 2025, 5:10 p.m.