tcxread -- A parser for TCX files written in Ruby

📦 Installation • 🚀 Basic run example • 💾 Datasets • 📖 Further read • 🔗 Related packages/frameworks • 🔑 License

tcxread is a Ruby package designed to simplify the process of reading and processing .tcx files, commonly used by Garmin devices and other GPS-enabled fitness devices to store workout data.

📦 Installation

$ gem install tcxread

🚀 Basic run example

require 'tcxread'

data = TCXRead.load_file('23.tcx')

puts [
  "Distance meters: #{data.total_distance_meters}",
  "Time seconds: #{data.total_time_seconds}",
  "Calories: #{data.total_calories}",
  "Total ascent: #{data.total_ascent}",
  "Total descent: #{data.total_descent}",
  "Max altitude: #{data.max_altitude}",
  "Average heart rate: #{data.average_heart_rate}",
  "Average watts: #{data.average_watts}",
  "Max watts: #{data.max_watts}",
  "Average speed: #{data.average_speed_all}",
  "Average speed (moving): #{data.average_speed_moving}",
  "Average cadence (moving): #{data.average_cadence_biking}",
  "Average cadence: #{data.average_cadence_all}"
].join("\n")

Use TCXRead.parse(data) to parse raw TCX data.

💾 Datasets

Datasets available and used in the examples on the following links: DATASET1, DATASET2, DATASET3.

📖 Further read

[1] Awesome Computational Intelligence in Sports

🔗 Related packages/frameworks

[1] tcxreader: Python reader/parser for Garmin's TCX file format.

[2] sport-activities-features: A minimalistic toolbox for extracting features from sports activity files written in Python

[3] TCXReader.jl: Julia package designed for parsing TCX files

[4] TCXWriter: A Tiny Library for writing/creating TCX files on Arduino

🔑 License

This package is distributed under the MIT License. This license can be found online at http://www.opensource.org/licenses/MIT.

Disclaimer

This framework is provided as-is, and there are no guarantees that it fits your purposes or that it is bug-free. Use it at your own risk!