import_ride: Ride file parsing
In jmackie4/elpatron: Bicycling Data Analysis with R

Description Usage Arguments Details Value Notes Acknowledgements See Also Examples

The generic import_ride dispatches methods based on the file extension of file_path. See Details for currently supported file formats. The default method (i.e. for unsupported formats) will raise an error.

import_ride(file_path, ...)

## S3 method for class 'fit'
import_ride(file_path, raw = FALSE, make_laps = TRUE, ...)

## S3 method for class 'pwx'
import_ride(file_path, ...)

## S3 method for class 'tcx'
import_ride(file_path, make_laps = TRUE, ...)

## S3 method for class 'gpx'
import_ride(file_path, ...)

## S3 method for class 'srm'
import_ride(file_path, ...)

`file_path`	character string; path to the file to be read. Can be absolute or relative.
`...`	further arguments passed to or from other methods.
`raw`	logical; if `TRUE` all data retrieved from the fit file is returned as a list. `raw = FALSE` (default) will just return formatted "records", which are generally what's expected/of interest.
`make_laps`	logical; append a lap column to the data (if available)?

These functions will do very little with the parsed data by default. This is to allow for more flexibility, but can cause headaches for batch analysing files of mixed formats (see clean_bikedata for a solution).

Timestamps are converted to POSIXct when available.

Currently supported formats are:

pwx:Training Peaks pwx files (an XML format).
fit:Garmin fit files (a binary format).
tcx:Garmin training center files (an XML format).
gpx:GPS Exchange Format (a lame XML format).
srm:SRM power control files (a binary format).

Tabular data are always returned as dplyr tbl objects. This ensures clean printing and makes data easier to work with.

With very few exceptions, these functions return data as a tbl_df, with the additional attribute "file_ext".

Garmin Fit files return positional coordinates in units of semicircles. These are converted to degrees by default (if raw = FALSE).

XML file formats are parsed using the pugixml C++ library.

SRM parsing code was adapted from the code in the Golden Cheetah repository (which can be found here).

clean_bikedata for creating consistent output from these functions.

## Not run: 
ride_files <- list.files(
  system.file("extdata", package = "elpatron"),
  full.names = TRUE)

(f <- sample(ride_files, 1))
import_ride(f)

## If you want all data from the .fit format...
f <- grep("fit$", ride_files, value = TRUE)
import_ride(f, raw = TRUE)

## End(Not run)