Project

fit4ruby

0.03
There's a lot of open issues
No release in over a year
This library can read and write FIT files and convert them into a Ruby data structure for easy processing. This library was written for Garmin devices like the FR620, Fenix 3, Fenix 3 HR, Fenix 5 (s and X). Fit files from other devices may work as well but have not been tested.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 2.2
>= 0.14
~> 13.0
>= 3.12
~> 0.9.28

Runtime

~> 2.4.14
 Project Readme

Fit4Ruby

Fit4Ruby is a http://www.ruby-lang.org libary to read and write FIT files.

This libary is still work in progress and probably not yet ready to be used in your application. However, you are welcome to try it and send me comments and patches. It was developed to form the back-end of https://github.com/scrapper/postrunner.

Supported Devices

Tested devices: Garmin FR620, Fenix 3, Fenix 5, Fenix 5X, Fenix 6X

Other Garmin devices that generate FIT files may work as well. Since I don't have any other devices, I can't add support for them.

Supported Operating Systems

This library was developed and tested on Linux using Ruby 2.0 (MRI). Other operating systems that are Supported by Ruby 2.0 may probably work as well.

Usage

You can create an Activity.

require 'fit4ruby'

a = Fit4Ruby::Activity.new
a.total_timer_time = 30 * 60
a.new_user_profile({ :age => 33, :height => 1.78, :weight => 73.0,
                     :gender => 'male', :activity_class => 4.0,
                     :max_hr => 178 })

a.new_event({ :event => 'timer', :event_type => 'start_time' })
a.new_device_info({ :device_index => 0 })
a.new_device_info({ :device_index => 1, :battery_status => 'ok' })
ts = Time.now
0.upto(a.total_timer_time / 60) do |mins|
  ts += 60
  a.new_record({
    :timestamp => ts,
    :position_lat => 51.5512 - mins * 0.0008,
    :position_long => 11.647 + mins * 0.002,
    :distance => 200.0 * mins,
    :altitude => 100 + mins * 2,
    :speed => 3.1,
    :vertical_oscillation => 9 + mins * 0.02,
    :stance_time => 235.0 * mins * 0.01,
    :stance_time_percent => 32.0,
    :heart_rate => 140 + mins,
    :cadence => 75,
    :activity_type => 'running',
    :fractional_cadence => (mins % 2) / 2.0
  })

  if mins > 0 && mins % 5 == 0
    a.new_lap({ :timestamp => ts })
  end
end
a.new_session({ :timestamp => ts })
a.new_event({ :timestamp => ts, :event => 'recovery_time',
              :event_type => 'marker',
              :data => 2160 })
a.new_event({ :timestamp => ts, :event => 'vo2max',
              :event_type => 'marker', :data => 52 })
a.new_event({ :timestamp => ts, :event => 'timer',
              :event_type => 'stop_all' })
a.new_device_info({ :timestamp => ts, :device_index => 0 })
ts += 1
a.new_device_info({ :timestamp => ts, :device_index => 1,
                    :battery_status => 'low' })
ts += 120
a.new_event({ :timestamp => ts, :event => 'recovery_hr',
              :event_type => 'marker', :data => 132 })

Now you can have the accumulated data for laps and sessions computed.

a.aggregate

Save it to a file.

Fit4Ruby.write('TEST.FIT', a)

Or read an Activity from a file.

a = Fit4Ruby.read('TEST.FIT')

Then you can access the data in the file.

a.records.each do |r|
  puts "Latitude: #{r.get 'position_lat'}"
  puts "Longitude: #{r.get 'position_long'}"
end

Please see GlobalFitMessages.rb for the data fields that are supported for the various FIT record types.

License

See COPYING file.