update_gps_variables: add/replace ride data in all tbl pairs

In CraigMohn/bikeCadHr: Analyze Cycling Cadence Data From GPS .fit and .gpx Files

Description

update_gps_variables Add/replace ride data in .fit, .gpx and combined tbl pairs (summaries,tracks)

Usage

update_gps_variables(
  outdir,
  fitrootdir,
  gpxrootdir = NA,
  merge.files = list(c(NA, NA)),
  fitexcludes = c("bad", "short"),
  gpxexcludes = c("bad", "short", "nosegs"),
  prefer.gpx = c(""),
  rebuild.all.fit = FALSE,
  rebuild.all.gpx = FALSE,
  drawprofile = TRUE,
  drawprofile.both = FALSE,
  rgl = FALSE,
  maptype = "bing",
  drawmap = TRUE,
  drawmap.both = FALSE,
  cores = 4,
  loud = FALSE,
  usefitdc = FALSE,
  ...
)

Arguments

outdir	string containing location of output data pair files
fitrootdir	string containing location of root directory for gps .fit files
gpxrootdir	string containing location of root directory for gps .gpx files
merge.files	list of vectors (order matters within vectors) of .fit and .gpx files at the top level to be joined
fitexcludes	list of substrings within a file name which will cause the file to be ignored. occasionally .fit files will be unreadable by these routines and excluding them will be necessary
gpxexcludes	list of substrings within a file name which will cause the file to be ignored. occasionally .fit files will be unreadable by the routines in this package
prefer.gpx	vector of strings identifying times to use a .gpx file rather than the corresponding .fit file
rebuild.all.fit	if TRUE, will read all files in subdirectories of fitrootdir, but not in the directory itself
rebuild.all.gpx	if TRUE, will read all files in subdirectories of gpxrootdir, but not in the directory itself
drawprofile	create a .png file in the output directory profiling the ride
drawprofile.both	create a .png file in the output directory profiling the ride for both the .fit files and .gpx files
rgl	if TRUE use rgl to draw 3D track in viewer
maptype	map to use as background ("maptoolkit-topo" or "bing" or "osm" or "stamen-terrain" or "esri-topo" or "stamen-watercolor" or "mapbox" or "esri" or "osm-public-transport" or "opencyclemap" or "apple-iphoto" or "skobbler")
drawmap	create a .tiff file in the output directory mapping the ride with speed-varying color
drawmap.both	create a .tiff file in the output directory mapping the ride with speed-varying color for both the .fit files and the .gox files
cores	numer of cores (default is #CPUs - 1)
loud	display summary of re/segmenting
usefitdc	use package fitdc to read fit files instead of fitparse
...	parameters passed for track cleaning, output production

Details

Update existing (summaries,tracks) pairs for .fit and .gpx files structured with new files at the top level, and files already included in the pairs of tbls summarizing the rides are in subdirectories below them. there are 3 file pairs created: (fitsummary,fittracks), (gpxsummary,gpxtracks) and (gpssummary,gpstracks) the last pair contains data from both joined, with preference given to .fit-sourced data

Value

a tbl contining the combined summaries and tracks, with preference given to data from .fit files over the corresponding .gpx file, with specified exceptions

See Also

read_ride

CraigMohn/bikeCadHr documentation built on Dec. 3, 2020, 2:31 a.m.