read_ride: read and clean a gps data file

In CraigMohn/rideReadGPS: Read GPS Track Files (fit or gpx)

Description

read_ride processes a gps .fit and/or .gpx track file to create summary and detail data tibbles for modeling or graphical summary. Track segments are adjusted to remove many false autostop-start and startline delay sequences. Several measures of cadence are calculated (including zeros, excluding zeros, and midsegment),spurious and missing cadence values are repaired, and summary stats are calculated for analysis.

Usage

read_ride(
  ridefile,
  tz,
  stopSpeed = 0,
  fixDistance = FALSE,
  loud = FALSE,
  loudSegment = FALSE,
  readpkg = "fitdecodeR",
  lutzmethod = "fast",
  ...
)

Arguments

ridefile	a filenames (.fit or .gpx extension) to process
tz	string containing the timezone for the track data frame
stopSpeed	- speed in m/s below which the bike is considered stopped for time and cadence calculations
fixDistance	repair nonmonotonicities in distance which are on segment breaks - this occurs when power is lost or on some device lockups
loud	print information about hr/cadence data issues/fixes
loudSegment	print information about re/segmenting track data
readpkg	which package reads the fit file - valid options are "fitdc","fitdecodeR", or "FITfileR"
lutzmethod	method to use to locate timezone, see package lutz
...	parameters for processSegments, repairSensorDropOut, repairHR, repairCadence, repairPower, statsHeartRate, statsCadence, statsPower, statsGearing, statsGrade, statsSession, statsStops, statsTemp

Value

a list of three data tibbles: summary and trackpoints and session These are linked by integer fields startbutton.date and startbutton.time

See Also

read_ridefiles, processSegments, repairSensorDropOut, repairHR, repairCadence, repairPower, statsCadence, statsPower, statsHeartRate, statsGearing, statsGrade, statsSession, statsStops

CraigMohn/rideReadGPS documentation built on March 20, 2021, 11:57 a.m.