std_cum_mean_augment: Augment Cumulative Sum

In RandomWalker: Generate Random Walks Compatible with the 'tidyverse'

Augment Cumulative Sum

Description

This function augments a data frame by adding cumulative mean columns for specified variables.

Usage

std_cum_mean_augment(.data, .value, .names = "auto", .initial_value = 0)

Arguments

.data	A data frame to augment.
.value	A column name or names for which to compute the cumulative mean.
.names	Optional. A character vector of names for the new cumulative mean columns. Defaults to "auto", which generates names based on the original column names.
.initial_value	A numeric value to start the cumulative mean from. Defaults to 0.

Details

The function takes a data frame and a column name (or names) and computes the cumulative mean for each specified column, starting from an initial value. If the column names are not provided, it will throw an error.

Value

A tibble with the original data and additional columns containing the cumulative means.

Author(s)

Steven P. Sanderson II, MPH

See Also

Other Utility Functions: confidence_interval(), convert_snake_to_title_case(), generate_caption(), get_attributes(), rand_walk_column_names(), rand_walk_helper(), running_quantile(), std_cum_max_augment(), std_cum_min_augment(), std_cum_prod_augment(), std_cum_sum_augment(), subset_walks()

Examples

df <- data.frame(x = c(1, 2, 3, 4, 5), y = c(10, 20, 30, 40, 50))
std_cum_mean_augment(df, .value = x)
std_cum_mean_augment(df, .value = y, .names = c("cummean_y"))

RandomWalker documentation built on Aug. 19, 2025, 1:14 a.m.