This function augments a data frame by adding cumulative mean columns for specified variables.
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.
See also
Other Utility Functions:
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()
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)
#> # A tibble: 5 × 3
#> x y cum_mean_x
#> <dbl> <dbl> <dbl>
#> 1 1 10 1
#> 2 2 20 1.5
#> 3 3 30 2
#> 4 4 40 2.5
#> 5 5 50 3
std_cum_mean_augment(df, .value = y, .names = c("cummean_y"))
#> # A tibble: 5 × 3
#> x y cummean_y
#> <dbl> <dbl> <dbl>
#> 1 1 10 10
#> 2 2 20 15
#> 3 3 30 20
#> 4 4 40 25
#> 5 5 50 30