ACWR

R-CMD-check Codecov test coverage CRAN status License: MIT

Overview

The ACWR package has been designed to calculate the acute chronic workload ratio (Gabbett, 2016) using three different methods: exponentially weighted moving average (EWMA; Williams et al., 2017; Murray et al., 2017), rolling average coupled (RAC) and rolling average uncoupled (RAU) (Windt & Gabbett, 2019).

Sessions are placed on a daily calendar: sessions on the same day are summed and days without a session count as a load of 0. Acute and chronic loads are then computed over calendar days, not over sessions:

Version 0.2.0 fixed a bug: results of earlier versions are only correct when there was exactly one session every day. See NEWS.md.

Example

This is a basic example which shows you how to use the ACWR package:

install.packages("ACWR")
library(ACWR)

First, we have to load the data stored in the package. training_load has one session every day; training_load_rest has rest days, a day with two sessions and a week without training.

data("training_load", package = "ACWR")
data("training_load_rest", package = "ACWR")

Then, we can calculate the ACWR:

result_ACWR <- ACWR(db = training_load_rest,
                    ID = "ID",
                    TL = "TL",
                    days = "Day",
                    training_dates = "Training_Date",
                    ACWR_method = c("EWMA", "RAC", "RAU"))

RAC and RAU are NA until 28 days of history exist. Use partial = TRUE to use the days available instead.

Additionally, individual plots can be obtained:

ACWR_plot <- plot_ACWR(db = result_ACWR,
                       TL = "TL",
                       ACWR = "RAC_ACWR",
                       day = "Day",
                       ID = "ID")

Functions for each individual method have been implemented too:

# Select the first subject
training_load_1 <- training_load_rest[training_load_rest[["ID"]] == 1, ]

# EWMA
result_EWMA <- EWMA(TL = training_load_1$TL,
                    training_dates = training_load_1$Training_Date)

# RAC
result_RAC <- RAC(TL = training_load_1$TL,
                  training_dates = training_load_1$Training_Date)

# RAU
result_RAU <- RAU(TL = training_load_1$TL,
                  training_dates = training_load_1$Training_Date)

Limitations of the ACWR

The package calculates the ACWR as it is described in the literature, but the ratio has well-documented limitations that should be considered before using it to make decisions:

References