tcx_reader 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1308f81eb3c67bf9031b93bbb16bc47b6669f332
+  data.tar.gz: 04e6c79ab0b2e032e01a07119fcb719c1227dcc0
+SHA512:
+  metadata.gz: 30fa0551cddf922fe542503cb7f2c787974517d14820762e9c7ff45becf5131371444c949c3e02bebfe498df0e236c17341eb07c9d586fd4c110ac6980cd9ebf
+  data.tar.gz: 7e91eabad55eedef4a439cf0d5460b2c736d9366ead3bc159d73281bc4facc87d8373f7d374b2d52ce1023abf633579740eafe5541c778b53df7371359a5b0e3

data/.gitignore

@@ -0,0 +1,23 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.DS_Store

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in tcx_reader.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Nicolas Aguttes
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,49 @@
+# TcxReader
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'tcx_reader'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install tcx_reader
+
+## Usage
+
+  tcx_reader accept a file as argument or a string.
+
+  To read a tcx file just call @tcx = TCXReader::Tcx.new(file) or @tcx = TCXReader::Tcx.new(string)
+
+  Then use it as follow:
+
+  - @tcx.activities   => activities in the tcx
+    - activity.sport        => activity type
+    - activity.activity_id  => activity id (usually the time)
+    - activity.laps         => array of laps
+      - lap.start_time        => start time of the lap
+      - lap.time_seconds      => time in seconds for the lap
+      - lap.distance_meter    => distance of the lap
+      - lap.max_speed         => max speed of the lap
+
+## Notes
+
+This gem has been written for my own needs, if you feel something is missing don't hesitate to ask
+
+
+## TODO
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/tcx_reader/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/tcx_reader.rb

@@ -0,0 +1,34 @@
+#--
+# Copyright (c) 2014 Nicolas Aguttes
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+$:.unshift(File.dirname(__FILE__))
+require "tcx_reader/version"
+require "nokogiri"
+
+require 'date'
+require 'time'
+require 'tcx_reader/tcx'
+require 'tcx_reader/activity'
+require 'tcx_reader/lap'
+require 'tcx_reader/track'
+require 'tcx_reader/point'
+

data/lib/tcx_reader/activity.rb

@@ -0,0 +1,37 @@
+#--
+# Copyright (c) 2014 Nicolas Aguttes
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+module TCXReader
+  class Activity
+    attr_accessor :sport, :laps, :activity_id
+
+    def initialize(activity)
+      @sport        = activity["Sport"] rescue ""
+      @activity_id  = activity.at_css("Id")
+      @laps         = []
+      activity.css("Lap").each do |lap|
+        lap = Lap.new(lap)
+        @laps << lap
+      end
+    end
+  end
+end

data/lib/tcx_reader/lap.rb

@@ -0,0 +1,44 @@
+#--
+# Copyright (c) 2014 Nicolas Aguttes
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+module TCXReader
+  class Lap
+    attr_accessor :tracks,:start_time, :time_seconds, :distance_meter, :max_speed, :calories, :avg_hr, :max_hr, :intensity, :trigger_method
+
+    def initialize(lap)
+      @start_time     = Time.parse(lap["StartTime"])
+      @time_seconds   = lap.at_css("TotalTimeSeconds").text.to_f rescue nil
+      @distance_meter = lap.at_css("DistanceMeters").text.to_f rescue nil
+      @max_speed      = lap.at_css("MaximumSpeed").text.to_f rescue nil
+      @calories       = lap.at_css("Calories").text.to_i rescue nil
+      @avg_hr         = lap.at_css("AverageHeartRateBpm Value").text.to_i rescue nil
+      @max_hr         = lap.at_css("MaximumHeartRateBpm Value").text.to_i rescue nil
+      @intensity      = lap.at_css("Intensity").text rescue nil
+      @trigger_method = lap.at_css("TriggerMethod").text rescue nil
+      @tracks = []
+      lap.css("Track").each do |trk|
+        trk     = Track.new(trk)
+        @tracks << trk
+      end
+    end
+  end
+end

data/lib/tcx_reader/point.rb

@@ -0,0 +1,37 @@
+#--
+# Copyright (c) 2014 Nicolas Aguttes
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+module TCXReader
+  class Point
+    attr_accessor :time,:lat, :lon, :hr, :distance, :speed, :cadence
+
+    def initialize(point)
+      @time     = Time.parse(point.at_css("Time"))
+      @lat      = point.at_css("Position LatitudeDegrees").text.to_f rescue nil
+      @lon      = point.at_css("Position LongitudeDegrees").text.to_f rescue nil
+      @hr       = point.at_css("HeartRateBpm Value").text.to_i rescue nil
+      @distance = point.at_css("DistanceMeters").text.to_f rescue nil
+      @speed    = point.at_css("Speed").text.to_f rescue nil
+      @cadence  = point.at_css("RunCadence").text.to_i rescue nil
+    end
+  end
+end

data/lib/tcx_reader/tcx.rb

@@ -0,0 +1,43 @@
+  #--
+# Copyright (c) 2014 Nicolas Aguttes
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+module TCXReader
+  class Tcx
+    attr_accessor :activities
+      # read the file containing the tracks
+      # get the different information of the file
+      # get the tracks
+      # NOTE: removing name space may lead to some ambiguities
+      def initialize(file)
+        if file.is_a?(File)
+          @tcx=Nokogiri::XML(File.open(file)).remove_namespaces!
+        else
+          @tcx=Nokogiri::XML(file).remove_namespaces!
+        end
+        @activities = []
+        @tcx.css("Activity").each do |act|
+           act = Activity.new(act)
+           @activities << act
+        end
+      end
+  end
+end

data/lib/tcx_reader/track.rb

@@ -0,0 +1,35 @@
+#--
+# Copyright (c) 2014 Nicolas Aguttes
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+module TCXReader
+  class Track
+    attr_accessor :points
+
+    def initialize(trk)
+      @points = []
+      trk.css("Trackpoint").each do |pt|
+        point   = Point.new(pt)
+        @points << point
+      end
+    end
+  end
+end

data/lib/tcx_reader/version.rb

@@ -0,0 +1,3 @@
+module TcxReader
+  VERSION = "0.2.0"
+end

data/tcx_reader.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'tcx_reader/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "tcx_reader"
+  spec.version       = TcxReader::VERSION
+  spec.authors       = ["Nicolas Aguttes"]
+  spec.email         = ["nicolas.aguttes@gmail.com"]
+  spec.name          = "tcx_reader"
+  spec.version       = TcxReader::VERSION
+  spec.authors       = ["Nicolas Aguttes"]
+  spec.email         = ["nicolas.aguttes@gmail.com"]
+  spec.description   = %q{Gem to parse a tcx file or string}
+  spec.summary       = %q{tcx (garmin) reader}
+  spec.homepage      = "https://github.com/tranquiliste/tcx_reader"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_dependency "nokogiri", "1.6.1"
+end

data/tests/big_file.rb

@@ -0,0 +1,62 @@
+require 'test/unit'
+require File.expand_path('../.') + '/tcx_reader/lib/tcx_reader'
+
+class TCXBigFileTest < Test::Unit::TestCase
+
+  BIG_FILE = File.join(File.dirname(__FILE__), "tcx_files/big_file.tcx")
+
+  def test_big_file
+    tcx = TCXReader::Tcx.new(File.open(BIG_FILE))
+    assert_equal(1, tcx.activities.size)
+    assert_equal(3, tcx.activities.first.laps.size)
+    assert_equal("Other", tcx.activities.first.sport)
+    # first lap
+    assert_equal(9700.825, tcx.activities.first.laps[0].time_seconds)
+    assert_equal(Time.parse("2014-02-20 08:42:59 UTC"), tcx.activities.first.laps[0].start_time)
+    assert_equal(5201.66, tcx.activities.first.laps[0].distance_meter)
+    assert_equal(3.7309999465942383, tcx.activities.first.laps[0].max_speed)
+    assert_equal(1094, tcx.activities.first.laps[0].calories)
+    assert_equal(124, tcx.activities.first.laps[0].avg_hr)
+    assert_equal(148, tcx.activities.first.laps[0].max_hr)
+      assert_equal(1, tcx.activities.first.laps[0].tracks.size)
+      assert_equal(2619, tcx.activities.first.laps[0].tracks[0].points.size)
+      # first track
+        # points
+        assert_equal(Time.parse("2014-02-20 08:42:59 UTC"), tcx.activities.first.laps[0].tracks[0].points[0].time)
+        assert_equal(46.03442206978798, tcx.activities.first.laps[0].tracks[0].points[0].lat)
+        assert_equal(6.934360396116972, tcx.activities.first.laps[0].tracks[0].points[0].lon)
+        assert_equal(91, tcx.activities.first.laps[0].tracks[0].points[0].hr)
+        assert_equal(2.609999895095825, tcx.activities.first.laps[0].tracks[0].points[0].distance)
+        assert_equal(2.385999917984009, tcx.activities.first.laps[0].tracks[0].points[0].speed)
+        assert_equal(nil, tcx.activities.first.laps[0].tracks[0].points[0].cadence)
+        assert_equal(Time.parse("2014-02-20 08:43:00 UTC"), tcx.activities.first.laps[0].tracks[0].points[1].time)
+        assert_equal(46.03444067761302, tcx.activities.first.laps[0].tracks[0].points[1].lat)
+        assert_equal(6.93439643830061, tcx.activities.first.laps[0].tracks[0].points[1].lon)
+        assert_equal(91, tcx.activities.first.laps[0].tracks[0].points[1].hr)
+        assert_equal(5.920000076293945, tcx.activities.first.laps[0].tracks[0].points[1].distance)
+        assert_equal(2.6510000228881836, tcx.activities.first.laps[0].tracks[0].points[1].speed)
+        assert_equal(nil, tcx.activities.first.laps[0].tracks[0].points[1].cadence)
+    # second lap 
+    assert_equal(1, tcx.activities.first.laps[1].tracks.size)
+    assert_equal(224, tcx.activities.first.laps[1].tracks[0].points.size)
+    assert_equal(569.351, tcx.activities.first.laps[1].time_seconds)
+    assert_equal(Time.parse("2014-02-20 11:24:39 UTC"), tcx.activities.first.laps[1].start_time)
+    assert_equal(1096.79, tcx.activities.first.laps[1].distance_meter)
+    assert_equal(10.222000122070312, tcx.activities.first.laps[1].max_speed)
+    assert_equal(21, tcx.activities.first.laps[1].calories)
+    assert_equal(98, tcx.activities.first.laps[1].avg_hr)
+    assert_equal(124, tcx.activities.first.laps[1].max_hr)
+    # third lap 
+    assert_equal(1, tcx.activities.first.laps[2].tracks.size)
+    assert_equal(646, tcx.activities.first.laps[2].tracks[0].points.size)
+    assert_equal(1135.273, tcx.activities.first.laps[2].time_seconds)
+    assert_equal(Time.parse("2014-02-20 11:34:08 UTC"), tcx.activities.first.laps[2].start_time)
+    assert_equal(4942.11, tcx.activities.first.laps[2].distance_meter)
+    assert_equal(10.625, tcx.activities.first.laps[2].max_speed)
+    assert_equal(41, tcx.activities.first.laps[2].calories)
+    assert_equal(95, tcx.activities.first.laps[2].avg_hr)
+    assert_equal(114, tcx.activities.first.laps[2].max_hr)
+    end
+
+
+end