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.new('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}"

💾 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!