Description Usage Arguments Details Value Functions Examples
Read data from a cycling head unit into the R environment; optionally formatting it for use with other functions in this package. Critical power and session RPE metrics can also be associated with the data and used by other functions (e.g. summary.cycleRdata).
1 2 3 4 5 6 7 8 9 | read_ride(file = file.choose(), format = TRUE, CP = NULL, sRPE = NULL)
read_fit(file = file.choose(), format = TRUE, CP = NULL, sRPE = NULL)
read_pwx(file = file.choose(), format = TRUE, CP = NULL, sRPE = NULL)
read_srm(file = file.choose(), format = TRUE, CP = NULL, sRPE = NULL)
read_tcx(file = file.choose(), format = TRUE, CP = NULL, sRPE = NULL)
|
file |
character; path to the file. |
format |
logical; should data be formatted? |
CP, sRPE |
optional; critical power and session RPE values to be
associated with the data. Ignored if |
Note that most functions within this package depend on imported data being
formatted; i.e. read*("file_path", format = TRUE)
. Hence, unless the
raw data is of particular interest and/or the user wants to process it
manually, the format argument should be TRUE (default). When working with a
formatted dataset, do not change existing column names. The formatted data
structure is described in detail in ridedata.
Garmin .fit file data is parsed with the java command line tool provided in the FIT SDK. The latest source code and licensing information can be found at the previous link.
SRM device files (.srm) are also parsed at the command line, provided Rainer Clasen's srmio library is installed and available. The associated GitHub repo' can be found here.
a data frame object.
read_ride
: A wrapper for read_* functions that chooses the
appropriate function based on file extension.
read_fit
: Read a Garmin (Ltd) device .fit file. This invokes
system2
to execute the FitCSVTool.jar command line tool
(see FIT SDK). Hence, this
function requires that Java (JRE/JDK) binaries be on the system path.
read_pwx
: Read a Training Peaks .pwx file. Requires the "xml2" package
to be installed.
read_srm
: Read an SRM (.srm) file. This requires
Rainer Clasen's srmio library to
be installed and on the system path.
read_tcx
: Read a Garmin .tcx file. Requires the "xml2" package to be
installed.
1 2 3 4 5 6 7 8 9 10 11 | ## Not run:
fl <- system.file("extdata/example_files.tar.gz",
package = "cycleRtools")
fls <- untar(fl, list = TRUE)
untar(fl) # Extract to working directory.
dat <- lapply(fls, read_ride, format = TRUE, CP = 300, sRPE = 5)
file.remove(fls)
## End(Not run)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.