injsummary {injurytools} | R Documentation |
Estimate injury summary statistics
Description
Calculate injury summary statistics such as injury incidence and injury burden (see Bahr et al. 20), including total number of injuries, number of days lost due to injury, total time of exposure etc., by means of a (widely used) Poisson method, negative binomial, zero-inflated poisson or zero-inflated negative binomial, on a player and overall basis.
Usage
injsummary(
injd,
var_type_injury = NULL,
method = c("poisson", "negbin", "zinfpois", "zinfnb"),
conf_level = 0.95,
quiet = FALSE
)
Arguments
injd |
|
var_type_injury |
Character specifying the name of the column according
to which compute injury summary statistics. It should refer to a
(categorical) variable that describes the "type of injury". Optional,
defaults to |
method |
Method to estimate injury incidence and injury burden. One of "poisson", "negbin", "zinfpois" or "zinfnb"; characters that stand for Poisson method, negative binomial method, zero-inflated Poisson and zero-inflated negative binomial. |
conf_level |
Confidence level (defaults to 0.95). |
quiet |
Logical, whether or not to silence the warning messages
(defaults to |
Value
A list of two data frames comprising player-wise and overall injury
summary statistics, respectively, that constitute an injds
S3 object. Both of them made up of the following columns:
-
ninjuries
: number of injuries sustained by the player or overall in the team over the given period specified by theinjd
data frame. -
ndayslost
: number of days lost by the player or overall in the team due to injury over the given period specified by theinjd
data frame. -
mean_dayslost
: average of number of days lost (i.e.ndayslost
) playerwise or overall in the team. -
median_dayslost
: median of number of days lost (i.e.ndayslost
) playerwise or overall in the team. -
iqr_dayslost
: interquartile range of number of days lost (i.e.ndayslost
) playerwise or overall in the team. -
totalexpo
: total exposure that the player has been under risk of sustaining an injury. -
injincidence
: injury incidence, number of injuries per unit of exposure. -
injburden
: injury burden, number of days lost per unit of exposure. -
var_type_injury
: only if it is specified as an argument to function.
Apart from this column names, they may further include these other columns depending on the user's specifications to the function:
-
percent_ninjuries
: percentage (%) of number of injuries of that type relative to all types of injuries (ifvar_type_injury
specified). -
percent_dayslost
: percentage (%) of number of days lost because of injuries of that type relative to the total number of days lost because of all types of injuries (ifvar_type_injury
specified). -
injincidence_sd
andinjburden_sd
: estimated standard deviation, by the specifiedmethod
argument, of injury incidence (injincidence
) and injury burden (injburden
), for the overall injury summary statistics (the 2nd element of the function output). -
injincidence_lower
andinjburden_lower
: lower bound of, for example, 95% confidence interval (ifconf_level = 0.95
) of injury incidence (injincidence
) and injury burden (injburden
), for the overall injury summary statistics (the 2nd element of the function output). -
injincidence_upper
andinjburden_upper
: the same (as above item) applies but for the upper bound.
References
Bahr R., Clarsen B., & Ekstrand J. (2018). Why we should focus on the burden of injuries and illnesses, not just their incidence. British Journal of Sports Medicine, 52(16), 1018–1021. https://doi.org/10.1136/bjsports-2017-098160
Waldén M., Mountjoy M., McCall A., Serner A., Massey A., Tol J. L., ... & Andersen T. E. (2023). Football-specific extension of the IOC consensus statement: methods for recording and reporting of epidemiological data on injury and illness in sport 2020. British journal of sports medicine.
Examples
df_exposures <- prepare_exp(raw_df_exposures, player = "player_name",
date = "year", time_expo = "minutes_played")
df_injuries <- prepare_inj(raw_df_injuries, player = "player_name",
date_injured = "from", date_recovered = "until")
injd <- prepare_all(data_exposures = df_exposures,
data_injuries = df_injuries,
exp_unit = "matches_minutes")
injsummary(injd)
injsummary(injd, var_type_injury = "injury_type")