perform_kinetics: Perform VO2 kinetics fitting
In fmmattioni/whippr: Tools for Manipulating Gas Exchange Data

perform_kinetics

R Documentation

Perform VO2 kinetics fitting

Description

Performs the fitting process for the VO2 kinetics analysis. At this point, the data should already have been cleaned (outliers removed) and processed (interpolated, time-aligned, ensembled-averaged, and bin-averaged).

Usage

perform_kinetics(
  .data_processed,
  intensity_domain = c("moderate", "heavy", "severe"),
  fit_level = 0.95,
  fit_phase_1_length,
  fit_baseline_length,
  fit_transition_length,
  verbose = TRUE,
  ...
)

Arguments

`.data_processed`	The data retrieved from `process_data()`.
`intensity_domain`	The exercise-intensity domain that the test was performed. Either moderate, heavy, or severe.
`fit_level`	A numeric scalar between 0 and 1 giving the confidence level for the parameter estimates in the final VO2 kinetics fit. Default to `0.95`.
`fit_phase_1_length`	The length of the phase I that you wish to exclude from the final exponential fit, in seconds. See `⁠VO2 kinetics⁠` section in `?vo2_kinetics` for more details.
`fit_baseline_length`	The length the baseline to perform the final linear fit, in seconds. See `⁠VO2 kinetics⁠` section `?vo2_kinetics` for more details.
`fit_transition_length`	The length of the transition to perform the final exponential fit, in seconds. See `⁠VO2 kinetics⁠` section `?vo2_kinetics` for more details.
`verbose`	A boolean indicating whether messages should be printed in the console. Default to `TRUE`.
`...`	Additional arguments when fitting VO2 kinetics in the heavy- or severe-intensity domains. Arguments may be the following: `TODO`

Details

See ?vo2_kinetics for details.

Value

a tibble containing one row and the nested columns:

`data_fitted`	The data containing the time and VO2 columns, as well as the fitted data and its residuals for each data point.
`model`	A `nls` object. The model used in the VO2 kinetics fitting.
`model_summary`	The tidied summary of the `model`.
`model_residuals`	The residuals of the `model`.
`plot_model`	The final plot of the fitted `model`.
`plot_residuals`	The residuals plot for the `model` diagnostics.