# ------------------------------------------------
# CITATION.cff file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# ------------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "metrictrails" in publications use:'
type: software
license: MIT
title: 'metrictrails: Processing of GNSS Streams from Sports Watches'
version: 1.0.0
identifiers:
- type: doi
  value: 10.32614/CRAN.package.metrictrails
abstract: Tools to read, clean and standardise GNSS (Global Navigation Satellite System)
  streams recorded by sports watches and similar devices, with a focus on trail and
  mountain running. The pipeline reads GPX files, applies a naming convention, sanitises
  coordinates (Kalman, LOESS, Gaussian kernel or Savitzky-Golay smoothing, and red
  flags for implausible readings), resamples the trajectory to a uniform spatial resolution
  derived from the Nyquist criterion, and replaces elevation with values from a Digital
  Elevation Model. Derived measures include speed, slope, elevation gain and kilometre-effort,
  Tobler hiking function parameters fitted by quantile regression, comparison between
  streams, detection of passes along a route and map matching to a known reference
  trail by dynamic programming. Methods follow Sanchez and Villena (2020) <https://doi.org/10.1177/1754337120918975>,
  Sanchez et al. (2024) <https://doi.org/10.1109/ICECET61485.2024.10698606>, Sanchez
  et al. (2025) <https://doi.org/10.1177/17543371251341660> and Martinez, Sanchez
  and Diaz (2026) <https://doi.org/10.1109/ICECET65726.2026.11632531>.
authors:
- family-names: Sanchez
  given-names: Raimundo
  email: raimundosanchezu@gmail.com
  orcid: https://orcid.org/0000-0003-2242-1335
preferred-citation:
  type: manual
  title: 'metrictrails: Processing of GNSS Streams from Sports Watches'
  authors:
  - family-names: Sanchez
    given-names: Raimundo
    email: raimundosanchezu@gmail.com
    orcid: https://orcid.org/0000-0003-2242-1335
  year: '2026'
  notes: R package version 0.1.0
  url: https://github.com/raimun2/metrictrails
repository: https://raimun2.r-universe.dev
repository-code: https://github.com/raimun2/metrictrails
commit: 240bbf5d9dbe19e98892cc8df438de728d9ed22b
url: https://github.com/raimun2/metrictrails
date-released: '2026-10-23'
contact:
- family-names: Sanchez
  given-names: Raimundo
  email: raimundosanchezu@gmail.com
  orcid: https://orcid.org/0000-0003-2242-1335
references:
- type: article
  title: 'How fractal complexity distorts distance and elevation gain in trail and
    mountain running: The case for course measurement standardization'
  authors:
  - family-names: Sanchez
    given-names: Raimundo
  - family-names: Egli
    given-names: Pascal E.
  - family-names: Jornet
    given-names: Kilian
  - family-names: Duggan
    given-names: Michael
  - family-names: Besomi
    given-names: Manuela
  journal: 'Proceedings of the Institution of Mechanical Engineers, Part P: Journal
    of Sports Engineering and Technology'
  year: '2025'
  doi: 10.1177/17543371251341660