LoginSign Up
← Back to all sparks
S

spiro

ANALYTICS
Velocity0.0

Work with data from cardiopulmonary exercise testing

github.com/ropensci/spiro ↗

Cardiopulmonary exercise test data in R, one metabolic cart vendor at a time.

exercise-physiologydata-importsports-scienceropenscir-package
◆Current state
spiro imports and processes cardiopulmonary exercise testing data in R, handling the file formats that metabolic carts from Cosmed, Cortex, Vyntus, and ZAN emit, then interpolating, smoothing, and summarizing them into comparable variables. The bulk of ongoing work is vendor format compatibility rather than analysis features — 0.2.4 fixed Cosmed imports failing in rare cases and Cortex imports on newer devices, and 0.2.2 added English-language Vyntus files after 0.1.2 added French ones. The analysis side, spiro_max(), spiro_smooth() and spiro_plot(), has been stable for some time.
◆Where it's heading
This is a mature rOpenSci package whose remaining work is dictated by other people's file formats. Each device firmware revision, each regional language variant, and each ggplot2 release generates maintenance, and that is what fills the changelog. The API itself settled early, with the 0.1.0 rOpenSci review pass renaming the protocol helpers to the pt_* prefix and 0.2.0 replacing the confusingly named spiro_import() with spiro_raw().
◆Prediction
Expect the pattern to continue: import fixes as vendor formats shift and periodic plotting updates tracking ggplot2, with no indication of new analysis capability.

◆Recent moves

  1. 1mo ago

    Cosmed and Cortex import fixes for newer devices

    Two import fixes: a rare Cosmed failure and Cortex files from newer devices. Routine vendor-format maintenance, though for a package whose entire entry point is file import these are the failures users actually hit.

    View source ↗
  2. 1y ago

    English-language Vyntus files supported

    Adds import support for English-language Vyntus files, extending the localization work that began with French in 0.1.2, and improves German Cosmed handling. Two ZAN import bugs are fixed — multiple dead space parameters and special characters in metadata — and spiro_plot() tracks ggplot2 3.5.

    View source ↗
  3. 3y ago

    R-devel compatibility and data frame printing fix

    An internal fix for R-devel changes plus a printing bug when non-numeric columns were manually added to spiro data frames. No functional change.

    View source ↗
  4. 3y ago

    spiro_raw() replaces the misleading spiro_import()

    Introduces spiro_raw() for accessing raw data and deprecates spiro_import(), whose name implied a general import function it never was. spiro_plot() gains style_args for point and line styling and vert_lines for marking warm-up and load boundaries, plus three import fixes covering Cortex headers, millisecond timestamps, and invalid raw time values.

    View source ↗
  5. 3y ago

    French Vyntus support and protocol duration control

    Adds French-language Vyntus import and a last.duration argument to pt_steps() and pt_const() for protocol definition. Also allows importing files missing body mass without forcing a substitute value, and improves post-exercise measurement detection during automated protocol detection.

    View source ↗
  6. 3y ago

    spiro 0.1.1

    The first CRAN release, consisting of documentation fixes made to satisfy submission requirements. A distribution milestone rather than a functional change.

    View source ↗