postrunner 0.0.8 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 872ed3c3ac1e84cd92bd1bde445738e1a37b0654
-  data.tar.gz: 42ca82b63a31d004b6dd5d9feb237dc5ddf8013b
+  metadata.gz: 19aaff0f7f7586b68eb837bd1679ce7e31b9cfe7
+  data.tar.gz: a25b3ceb7a05e129edc6560d73ccb65a1ebe0e16
 SHA512:
-  metadata.gz: dcf8664d4e28f88e644e71094e6e6d94dbafd01dd837b73bfe5c3c26c7a40f84d865bb407aeafc2dbc816a61df6ddb5c4d92993d9bd6338892831c4602188df0
-  data.tar.gz: fc9dc455c07fd593343b25a58f830170db86138d219c61303a22cbe097f8aa68d484c6f6d84bb4b3fa1db1b1e8a91ff880c051fa02b8ed4e89bb9359acf37535
+  metadata.gz: e0abfc8cef81ebf908bbcedb7443eb2481537c0f4156502aa65e6730c2b58607117a0c0d58886907b042c049e38ec8043bc3c632e4fc2b3e2a965409a81e7962
+  data.tar.gz: 773ba376b663e6b8aaddbbbb3e84e968b9b57d1d5c5cb0b39d5e809725268afdcf9a667b5647f1e325bdce399198f58d575d1884725c71bac4f27bc240a6e57f

data/README.md

@@ -2,7 +2,8 @@
 
 PostRunner is an application to manage FIT files such as those
 produced by Garmin products like the Forerunner 620 (FR620). It allows you to
-import the files from the device and inspect them. 
+import the files from the device and inspect them. It can also update
+satellite orbit prediction data on the device to speed-up fix times.
 
 ## Installation
 
@@ -80,6 +81,22 @@ This will provide you with a lot more information contained in the FIT
 files that is not available through Garmin Connect or most other
 tools.
 
+When you upload your FIT data to the Garmin Connect site using WiFi or
+Garmin Software, your device will be updated with 7 days worth of
+Extended Prediction Orbit (EPO) data. The GPS receiver in your device
+can use this data to acquire GPS locks much faster during the next 7
+days. To fetch the current set of EPO data, just use the following
+command while you have your device mounted via USB.
+
+```
+$ postrunner update-gps
+```
+
+This was tested on the FR620 and will probably also work on the FR220.
+Other devices may work, but you use this at your own risk. This
+feature will download a file called EPO.BIN and copy it to
+GARMIN/REMOTESW/EPO.BIN.
+
 ### Viewing FIT file data in your web browser
 
 You can also view the full details of your activity in your browser.

data/lib/postrunner/ActivitiesDB.rb

@@ -76,9 +76,9 @@ module PostRunner
     # files. This method is idempotent and can be called even when directories
     # exist already.
     def create_directories
-      create_directory(@db_dir, 'data')
-      create_directory(@fit_dir, 'fit')
-      create_directory(@cfg[:html_dir], 'html')
+      @cfg.create_directory(@db_dir, 'data')
+      @cfg.create_directory(@fit_dir, 'fit')
+      @cfg.create_directory(@cfg[:html_dir], 'html')
 
       @auxilliary_dirs.each do |dir|
         create_auxdir(dir)
@@ -168,6 +168,12 @@ module PostRunner
 
     def set(activity, attribute, value)
       activity.set(attribute, value)
+      if %w( norecord type ).include?(attribute)
+        # If we have changed a norecord setting or an activity type, we need
+        # to regenerate all reports and re-collect the record list since we
+        # don't know which Activity needs to replace the changed one.
+        check
+      end
       sync
     end
 
@@ -344,17 +350,6 @@ module PostRunner
       ActivityListView.new(self).update_index_pages
     end
 
-    def create_directory(dir, name)
-      return if Dir.exists?(dir)
-
-      Log.info "Creating #{name} directory #{dir}"
-      begin
-        Dir.mkdir(dir)
-      rescue StandardError
-        Log.fatal "Cannot create #{name} directory #{dir}: #{$!}"
-      end
-    end
-
     def create_auxdir(dir)
       # This file should be in lib/postrunner. The 'misc' directory should be
       # found in '../../misc'.

data/lib/postrunner/Activity.rb

@@ -14,6 +14,8 @@ require 'fit4ruby'
 
 require 'postrunner/ActivitySummary'
 require 'postrunner/ActivityView'
+require 'postrunner/Schema'
+require 'postrunner/QueryResult'
 
 module PostRunner
 
@@ -26,7 +28,20 @@ module PostRunner
     @@CachedActivityValues = %w( sport sub_sport timestamp total_distance
                                  total_timer_time avg_speed )
     # We also store some additional information in the archive index.
-    @@CachedAttributes = @@CachedActivityValues + %w( fit_file name )
+    @@CachedAttributes = @@CachedActivityValues + %w( fit_file name norecord )
+
+    @@Schemata = {
+      'long_date' => Schema.new('long_date', 'Date',
+                                { :func => 'timestamp',
+                                  :column_alignment => :left,
+                                  :format => 'date_with_weekday' }),
+      'sub_type' => Schema.new('sub_type', 'Subtype',
+                               { :func => 'activity_sub_type',
+                                 :column_alignment => :left }),
+      'type' => Schema.new('type', 'Type',
+                           { :func => 'activity_type',
+                             :column_alignment => :left })
+    }
 
     ActivityTypes = {
       'generic' => 'Generic',
@@ -138,6 +153,8 @@ module PostRunner
         else
           if @@CachedActivityValues.include?(name_without_at)
             @unset_variables << name_without_at
+          elsif name_without_at == 'norecord'
+            @norecord = false
           else
             Log.fatal "Don't know how to initialize the instance variable " +
                       "#{name_without_at}."
@@ -159,6 +176,25 @@ module PostRunner
       end
     end
 
+    def query(key)
+      unless @@Schemata.include?(key)
+        raise ArgumentError, "Unknown key '#{key}' requested in query"
+      end
+
+      schema = @@Schemata[key]
+
+      if schema.func
+        value = send(schema.func)
+      else
+        unless instance_variable_defined?(key)
+          raise ArgumentError, "Don't know how to query '#{key}'"
+        end
+        value = instance_variable_get(key)
+      end
+
+      QueryResult.new(value, schema)
+    end
+
     def show
       generate_html_view #unless File.exists?(@html_file)
 
@@ -167,7 +203,7 @@ module PostRunner
 
     def summary
       @fit_activity = load_fit_file unless @fit_activity
-      puts ActivitySummary.new(@fit_activity, @db.cfg[:unit_system],
+      puts ActivitySummary.new(self, @db.cfg[:unit_system],
                                { :name => @name,
                                  :type => activity_type,
                                  :sub_type => activity_sub_type }).to_s
@@ -199,6 +235,11 @@ module PostRunner
                     ActivitySubTypes.values.join(', ')
         end
         @sub_sport = ActivitySubTypes.invert[value]
+      when 'norecord'
+        unless %w( true false).include?(value)
+          Log.fatal "norecord must either be 'true' or 'false'"
+        end
+        @norecord = value == 'true'
       else
         Log.fatal "Unknown activity attribute '#{attribute}'. Must be one of " +
                   'name, type or subtype'
@@ -207,6 +248,10 @@ module PostRunner
     end
 
     def register_records
+      # If we have the @norecord flag set, we ignore this Activity for the
+      # record collection.
+      return if @norecord
+
       distance_record = 0.0
       distance_record_sport = nil
       # Array with popular distances (in meters) in ascending order.
@@ -295,7 +340,7 @@ module PostRunner
 
       # Store the found records
       start_time = @fit_activity.sessions[0].timestamp
-      if @distance_record_sport
+      if distance_record_sport
         @db.records.register_result(self, distance_record_sport,
                                     distance_record, nil, start_time)
       end

data/lib/postrunner/ActivityListView.rb

@@ -92,8 +92,8 @@ module PostRunner
         t.row([
           i += 1,
           ActivityLink.new(a, true),
-          a.activity_type,
-          a.timestamp.strftime("%a, %Y %b %d %H:%M"),
+          a.query('type'),
+          a.query('long_date'),
           local_value(a.total_distance, 'm', '%.2f',
                       { :metric => 'km', :statute => 'mi' }),
           secsToHMS(a.total_timer_time),

data/lib/postrunner/ActivitySummary.rb

@@ -21,8 +21,9 @@ module PostRunner
 
     include Fit4Ruby::Converters
 
-    def initialize(fit_activity, unit_system, custom_fields)
-      @fit_activity = fit_activity
+    def initialize(activity, unit_system, custom_fields)
+      @activity = activity
+      @fit_activity = activity.fit_activity
       @name = custom_fields[:name]
       @type = custom_fields[:type]
       @sub_type = custom_fields[:sub_type]
@@ -54,9 +55,10 @@ module PostRunner
               local_value(session, 'total_distance', '%.2f %s',
                           { :metric => 'km', :statute => 'mi'}) ])
       t.row([ 'Time:', secsToHMS(session.total_timer_time) ])
-      if session.sport == 'running'
+      if @activity.sport == 'running' || @activity.sport == 'multisport'
         t.row([ 'Avg. Pace:', pace(session, 'avg_speed') ])
-      else
+      end
+      if @activity.sport != 'running'
         t.row([ 'Avg. Speed:',
                 local_value(session, 'avg_speed', '%.1f %s',
                             { :metric => 'km/h', :statute => 'mph' }) ])
@@ -86,6 +88,11 @@ module PostRunner
       t.row([ 'Avg. Stride Length:',
               local_value(session, 'avg_stride_length', '%.2f %s',
                           { :metric => 'm', :statute => 'ft' }) ])
+      rec_hr = @fit_activity.recovery_hr
+      end_hr = @fit_activity.ending_hr
+      t.row([ 'Recovery HR:',
+              rec_hr && end_hr ?
+              "#{rec_hr} bpm [#{end_hr - rec_hr} bpm]" : '-' ])
       rec_time = @fit_activity.recovery_time
       t.row([ 'Recovery Time:', rec_time ? secsToHMS(rec_time * 60) : '-' ])
       vo2max = @fit_activity.vo2max
@@ -100,7 +107,7 @@ module PostRunner
       t = FlexiTable.new
       t.head
       t.row([ 'Lap', 'Duration', 'Distance',
-              session.sport == 'running' ? 'Avg. Pace' : 'Avg. Speed',
+              @activity.sport == 'running' ? 'Avg. Pace' : 'Avg. Speed',
               'Stride', 'Cadence', 'Avg. HR', 'Max. HR' ])
       t.set_column_attributes(Array.new(8, { :halign => :right }))
       t.body
@@ -109,7 +116,7 @@ module PostRunner
         t.cell(secsToHMS(lap.total_timer_time))
         t.cell(local_value(lap, 'total_distance', '%.2f',
                            { :metric => 'km', :statute => 'mi' }))
-        if session.sport == 'running'
+        if @activity.sport == 'running'
           t.cell(pace(lap, 'avg_speed', false))
         else
           t.cell(local_value(lap, 'avg_speed', '%.1f',

data/lib/postrunner/ActivityView.rb

@@ -61,7 +61,7 @@ module PostRunner
           # The main area with the 2 column layout.
           doc.div({ :class => 'main' }) {
             doc.div({ :class => 'left_col' }) {
-              ActivitySummary.new(@activity.fit_activity, @unit_system,
+              ActivitySummary.new(@activity, @unit_system,
                                   { :name => @activity.name,
                                     :type => @activity.activity_type,
                                     :sub_type => @activity.activity_sub_type

data/lib/postrunner/ChartView.rb

@@ -15,7 +15,7 @@ module PostRunner
 
     def initialize(activity, unit_system)
       @activity = activity
-      @sport = activity.fit_activity.sessions[0].sport
+      @sport = activity.sport
       @unit_system = unit_system
       @empty_charts = {}
     end
@@ -33,9 +33,10 @@ module PostRunner
       }
 
       doc.script(java_script)
-      if @sport == 'running'
+      if @sport == 'running' || @sport == 'multisport'
         chart_div(doc, 'pace', "Pace (#{select_unit('min/km')})")
-      else
+      end
+      if @sport != 'running'
         chart_div(doc, 'speed', "Speed (#{select_unit('km/h')})")
       end
       chart_div(doc, 'altitude', "Elevation (#{select_unit('m')})")
@@ -44,6 +45,7 @@ module PostRunner
       chart_div(doc, 'vertical_oscillation',
                 "Vertical Oscillation (#{select_unit('cm')})")
       chart_div(doc, 'stance_time', 'Ground Contact Time (ms)')
+      chart_div(doc, 'temperature', 'Temperature (°C)')
     end
 
     private
@@ -94,9 +96,10 @@ EOT
       s = "$(function() {\n"
 
       s << tooltip_div
-      if @sport == 'running'
+      if @sport == 'running' || @sport == 'multisport'
         s << line_graph('pace', 'Pace', 'min/km', '#0A7BEE' )
-      else
+      end
+      if @sport != 'running'
         s << line_graph('speed', 'Speed', 'km/h', '#0A7BEE' )
       end
       s << line_graph('altitude', 'Elevation', 'm', '#5AAA44')
@@ -119,6 +122,7 @@ EOT
                          [ '#A0D488', 273 ],
                          [ '#F79666', 305 ],
                          [ '#EE3F2D', nil ] ])
+      s << line_graph('temperature', 'Temperature', 'C', '#444444')
 
       s << "\n});\n"
 
@@ -161,6 +165,9 @@ EOT
       min_value = nil
       @activity.fit_activity.records.each do |r|
         value = r.get_as(field, select_unit(unit))
+
+        next unless value
+
         if field == 'pace'
           # Slow speeds lead to very large pace values that make the graph
           # hard to read. We cap the pace at 20.0 min/km to keep it readable.

data/lib/postrunner/DeviceList.rb

@@ -18,6 +18,8 @@ module PostRunner
 
   class DeviceList
 
+    include Fit4Ruby::Converters
+
     def initialize(fit_activity)
       @fit_activity = fit_activity
     end
@@ -46,15 +48,19 @@ module PostRunner
         t.body
 
         t.cell('Manufacturer:', { :width => '40%' })
-        t.cell(device.manufacturer, { :width => '60%' })
+        t.cell(device.manufacturer.upcase, { :width => '60%' })
         t.new_row
 
-        if (product = device.product)
+        if (product = %w( garmin dynastream dynastream_oem ).include?(
+                       device.manufacturer) ?
+                         device.garmin_product : device.product)
+          # For unknown products the numerical ID will be returned.
+          product = product.to_s unless product.is_a?(String)
           t.cell('Product:')
-          rename = { 'fr620' => 'FR620', 'sdm4' => 'SDM4',
-                     'hrm_run_single_byte_product_id' => 'HRM Run',
+          # Beautify some product names. The others will just be upcased.
+          rename = { 'hrm_run_single_byte_product_id' => 'HRM Run',
                      'hrm_run' => 'HRM Run' }
-          product = rename[product] if rename.include?(product)
+          product = rename.include?(product) ? rename[product] : product.upcase
           t.cell(product)
           t.new_row
         end
@@ -87,6 +93,11 @@ module PostRunner
           t.cell(device.battery_status)
           t.new_row
         end
+        if device.cum_operating_time
+          t.cell('Cumulated Operating Time:')
+          t.cell(secsToDHMS(device.cum_operating_time))
+          t.new_row
+        end
 
         seen_indexes << device.device_index
       end

data/lib/postrunner/EPO_Downloader.rb

@@ -0,0 +1,153 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = EPO_Downloader.rb -- PostRunner - Manage the data from your Garmin sport devices.
+#
+# Copyright (c) 2015 by Chris Schlaeger <cs@taskjuggler.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+require 'uri'
+require 'net/http'
+
+module PostRunner
+
+  # This class can download the current set of Extended Prediction Orbit data
+  # for GPS satellites and store them in the EPO.BIN file format. Some Garmin
+  # devices pick up this file under GARMIN/GARMIN/REMOTESW/EPO.BIN.
+  class EPO_Downloader
+
+    @@URI = URI('http://omt.garmin.com/Rce/ProtobufApi/EphemerisService/GetEphemerisData')
+    # This is the payload of the POST request. It was taken from
+    # http://www.kluenter.de/garmin-ephemeris-files-and-linux/. It may contain
+    # a product ID or serial number.
+    @@POST_DATA = "\n-\n\aexpress\u0012\u0005de_DE\u001A\aWindows\"\u0012601 Service Pack 1\u0012\n\b\x8C\xB4\x93\xB8\u000E\u0012\u0000\u0018\u0000\u0018\u001C\"\u0000"
+    @@HEADER = {
+      'Garmin-Client-Name' => 'CoreService',
+      'Content-Type' => 'application/octet-stream',
+      'Content-Length' => '63'
+    }
+
+    # Create an EPO_Downloader object.
+    def initialize
+      @http = Net::HTTP.new(@@URI.host, @@URI.port)
+      @request = Net::HTTP::Post.new(@@URI.path, initheader = @@HEADER)
+      @request.body = @@POST_DATA
+    end
+
+    # Download the current EPO data from the Garmin server and write it into
+    # the specified output file.
+    # @param output_file [String] The name of the output file. Usually this is
+    #        'EPO.BIN'.
+    def download(output_file)
+      return false unless (epo = get_epo_from_server)
+      return false unless (epo = fix(epo))
+      return false unless check_epo_data(epo)
+      write_file(output_file, epo)
+      Log.info "Extended Prediction Orbit (EPO) data has been downloaded " +
+               "from Garmin site."
+
+      true
+    end
+
+    private
+
+    def get_epo_from_server
+      begin
+        res = @http.request(@request)
+      rescue => e
+        Log.error "Extended Prediction Orbit (EPO) data download error: " +
+                  e.message
+        return nil
+      end
+      if res.code.to_i != 200
+        Log.error "Extended Prediction Orbit (EPO) data download failed: #{res}"
+        return nil
+      end
+      res.body
+    end
+
+    # The downloaded data contains Extended Prediction Orbit data for 6 hour
+    # windows for 7 days. Each EPO set is 2307 bytes long, but the first 3
+    # bytes must be removed for the FR620 to understand it.
+    # https://forums.garmin.com/showthread.php?79555-when-will-garmin-express-mac-be-able-to-sync-GPS-EPO-bin-file-on-fenix-2&p=277398#post277398
+    # The 2304 bytes consist of 32 sets of 72 byte GPS satellite data.
+    # http://www.vis-plus.ee/pdf/SIM28_SIM68R_SIM68V_EPO-II_Protocol_V1.00.pdf
+    def fix(epo)
+      unless epo.length == 28 * 2307
+        Log.error "GPS data has unexpected length of #{epo.length} bytes"
+        return nil
+      end
+
+      epo_fixed = ''
+      0.upto(27) do |i|
+        offset = i * 2307
+        # The fill bytes always seem to be 0. Let's issue a warning in case
+        # this ever changes.
+        unless epo[offset].to_i == 0 &&
+               epo[offset + 1].to_i == 0 &&
+               epo[offset + 2].to_i == 0
+          Log.warning "EPO fill bytes are not 0 bytes"
+        end
+        epo_fixed += epo[offset + 3, 2304]
+      end
+
+      epo_fixed
+    end
+
+    def check_epo_data(epo)
+      # Convert EPO string into Array of bytes.
+      epo = epo.bytes.to_a
+      unless epo.length == 28 * 72 * 32
+        Log.error "EPO file has wrong length (#{epo.length})"
+        return false
+      end
+      date_1980_01_06 = Time.parse("1980-01-06T00:00:00+00:00")
+      now = Time.now
+      end_date = start_date = nil
+      # Split the EPO data into Arrays of 32 * 72 bytes.
+      epo.each_slice(32 * 72).to_a.each do |epo_set|
+        # For each of the 32 satellites we have 72 bytes of data.
+        epo_set.each_slice(72).to_a.each do |sat|
+          # The last byte is an XOR checksum of the first 71 bytes.
+          xor = 0
+          0.upto(70) { |i| xor ^= sat[i] }
+          unless xor == sat[71]
+            Log.error "Checksum error in EPO file"
+            return false
+          end
+          # The first 3 bytes of every satellite record look like a timestamp.
+          # I assume they are hours after January 6th, 1980 UTC. They probably
+          # indicate the start of the 6 hour window that the data is for.
+          hours_after_1980_01_06 = sat[0] | (sat[1] << 8) | (sat[2] << 16)
+          date = date_1980_01_06 + hours_after_1980_01_06 * 60 * 60
+          if date > now + 8 * 24 * 60 * 60
+            Log.warn "EPO timestamp (#{date}) is too far in the future"
+          elsif date < now - 24 * 60 * 60
+            Log.warn "EPO timestamp (#{date}) is too old"
+          end
+          start_date = date if start_date.nil? || date < start_date
+          end_date = date if end_date.nil? || date > end_date
+        end
+      end
+      Log.info "EPO data is valid from #{start_date} to " +
+               "#{end_date + 6 * 60 * 60}."
+
+      true
+    end
+
+    def write_file(output_file, data)
+      begin
+        File.write(output_file, data)
+      rescue IOError
+        Log.fatal "Cannot write EPO file '#{output_file}': #{$!}"
+      end
+    end
+
+  end
+
+end
+

data/lib/postrunner/Main.rb

@@ -17,6 +17,7 @@ require 'fit4ruby'
 require 'postrunner/version'
 require 'postrunner/RuntimeConfig'
 require 'postrunner/ActivitiesDB'
+require 'postrunner/EPO_Downloader'
 
 module PostRunner
 
@@ -115,51 +116,56 @@ EOT
 Commands:
 
 check [ <fit file> | <ref> ... ]
-          Check the provided FIT file(s) for structural errors. If no file or
-          reference is provided, the complete archive is checked.
+           Check the provided FIT file(s) for structural errors. If no file or
+           reference is provided, the complete archive is checked.
 
 dump <fit file> | <ref>
-          Dump the content of the FIT file.
+           Dump the content of the FIT file.
 
 import [ <fit file> | <directory> ]
-          Import the provided FIT file(s) into the postrunner database. If no
-          file or directory is provided, the directory that was used for the
-          previous import is being used.
+           Import the provided FIT file(s) into the postrunner database. If no
+           file or directory is provided, the directory that was used for the
+           previous import is being used.
 
 delete <ref>
-          Delete the activity from the archive.
+           Delete the activity from the archive.
 
 list
-          List all FIT files stored in the data base.
+           List all FIT files stored in the data base.
 
 records
-          List all personal records.
+           List all personal records.
 
 rename <new name> <ref>
-          For the specified activities replace current activity name with a
-          new name that describes the activity. By default the activity name
-          matches the FIT file name.
+           For the specified activities replace current activity name with a
+           new name that describes the activity. By default the activity name
+           matches the FIT file name.
 
 set <attribute> <value> <ref>
-          For the specified activies set the attribute to the given value. The
-          following attributes are supported:
+           For the specified activies set the attribute to the given value. The
+           following attributes are supported:
 
-          name: The activity name (defaults to FIT file name)
-          type: The type of the activity
-          subtype: The subtype of the activity
+           name:     The activity name (defaults to FIT file name)
+           norecord: Ignore all records from this activity (value must true
+                     or false)
+           type:     The type of the activity
+           subtype:  The subtype of the activity
 
 show [ <ref> ]
-          Show the referenced FIT activity in a web browser. If no reference
-          is provided show the list of activities in the database.
+           Show the referenced FIT activity in a web browser. If no reference
+           is provided show the list of activities in the database.
 
 summary <ref>
-          Display the summary information for the FIT file.
+           Display the summary information for the FIT file.
 
 units <metric | statute>
-          Change the unit system.
+           Change the unit system.
 
 htmldir <directory>
-          Change the output directory for the generated HTML files
+           Change the output directory for the generated HTML files
+
+update-gps Download the current set of GPS Extended Prediction Orbit (EPO)
+           data and store them on the device.
 
 
 <fit file> An absolute or relative name of a .FIT file.
@@ -239,6 +245,8 @@ EOT
         change_unit_system(args)
       when 'htmldir'
         change_html_dir(args)
+      when 'update-gps'
+        update_gps_data
       when nil
         Log.fatal("No command provided. " +
                   "See 'postrunner -h' for more information.")
@@ -352,6 +360,38 @@ EOT
       end
     end
 
+    def update_gps_data
+      epo_dir = File.join(@db_dir, 'epo')
+      @cfg.create_directory(epo_dir, 'GPS Data Cache')
+      epo_file = File.join(epo_dir, 'EPO.BIN')
+
+      if !File.exists?(epo_file) ||
+         (File.mtime(epo_file) < Time.now - (6 * 60 * 60))
+        # The EPO file only changes every 6 hours. No need to download it more
+        # frequently if it already exists.
+        if EPO_Downloader.new.download(epo_file)
+          unless (remotesw_dir = @cfg[:import_dir])
+            Log.error "No device directory set. Please import an activity " +
+                      "from your device first."
+            return
+          end
+          remotesw_dir = File.join(remotesw_dir, '..', 'REMOTESW')
+          unless Dir.exists?(remotesw_dir)
+            Log.error "Cannot find '#{remotesw_dir}'. Please connect and " +
+                      "mount your Garmin device."
+            return
+          end
+          begin
+            FileUtils.cp(epo_file, remotesw_dir)
+          rescue
+            Log.error "Cannot copy EPO.BIN file to your device at " +
+                      "'#{remotesw_dir}'."
+            return
+          end
+        end
+      end
+    end
+
     def handle_version_update
       if @cfg.get_option(:version) != VERSION
         Log.warn "PostRunner version upgrade detected."

data/lib/postrunner/PersonalRecords.rb

@@ -20,12 +20,16 @@ require 'postrunner/ActivityLink'
 
 module PostRunner
 
+  # The PersonalRecords class stores the various records. Records are grouped
+  # by specific year or all-time records.
   class PersonalRecords
 
     include Fit4Ruby::Converters
 
+    # List of popular distances for each sport.
     SpeedRecordDistances = {
       'cycling' => {
+        1000.0 => '1 km',
         5000.0 => '5 km',
         8000.0 => '8 km',
         9000.0 => '9 km',
@@ -38,6 +42,9 @@ module PostRunner
         18000.0 => '180 km',
       },
       'running' => {
+        400.0 => '400 m',
+        500.0 => '500 m',
+        800.0 => '800 m',
         1000.0 => '1 km',
         1609.0 => '1 mi',
         2000.0 => '2 km',
@@ -61,6 +68,7 @@ module PostRunner
         3860.0 => '2.4 mi'
       },
       'walking' => {
+        500.0 => '500 m',
         1000.0 => '1 km',
         1609.0 => '1 mi',
         5000.0 => '5 km',
@@ -70,6 +78,8 @@ module PostRunner
       }
     }
 
+    # The Record class stores a single speed or longest distance record. It
+    # also stores a reference to the Activity that contains the record.
     class Record
 
       include Fit4Ruby::Converters
@@ -86,7 +96,7 @@ module PostRunner
 
       def to_table_row(t)
         t.row((@duration.nil? ?
-               [ 'Longest Run', '%.1f m' % @distance, '-' ] :
+               [ 'Longest Distance', '%.3f km' % (@distance / 1000.0), '-' ] :
                [ PersonalRecords::SpeedRecordDistances[@sport][@distance],
                  secsToHMS(@duration),
                  speedToPace(@distance / @duration) ]) +
@@ -106,7 +116,7 @@ module PostRunner
       def initialize(sport, year)
         @sport = sport
         @year = year
-        @distance = nil
+        @distance_record = nil
         @speed_records = {}
         PersonalRecords::SpeedRecordDistances[@sport].each_key do |dist|
           @speed_records[dist] = nil
@@ -133,8 +143,9 @@ module PostRunner
           end
         else
           # We have a potential distance record.
-          if @distance.nil? || result.distance > @distance.distance
-            @distance = result
+          if @distance_record.nil? ||
+             @distance_record.distance < result.distance
+            @distance_record = result
             Log.info "New #{@year ? @year.to_s : 'all-time'} " +
                      "#{result.sport} distance record: #{result.distance} m"
             return true
@@ -145,8 +156,8 @@ module PostRunner
       end
 
       def delete_activity(activity)
-        if @distance && @distance.activity == activity
-          @distance = nil
+        if @distance_record && @distance_record.activity == activity
+          @distance_record = nil
         end
         PersonalRecords::SpeedRecordDistances[@sport].each_key do |dist|
           if @speed_records[dist] && @speed_records[dist].activity == activity
@@ -157,7 +168,7 @@ module PostRunner
 
       # Return true if no Record is stored in this RecordSet object.
       def empty?
-        return false if @distance
+        return false if @distance_record
         @speed_records.each_value { |r| return false if r }
 
         true
@@ -165,7 +176,7 @@ module PostRunner
 
       # Iterator for all Record objects that are stored in this data structure.
       def each(&block)
-        yield(@distance) if @distance
+        yield(@distance_record) if @distance_record
         @speed_records.each_value do |record|
           yield(record) if record
         end
@@ -200,7 +211,7 @@ module PostRunner
         t.body
 
         records = @speed_records.values.delete_if { |r| r.nil? }
-        records << @distance if @distance
+        records << @distance_record if @distance_record
 
         records.sort { |r1, r2| r1.distance <=> r2.distance }.each do |r|
           r.to_table_row(t)
@@ -328,6 +339,7 @@ module PostRunner
                                 "records-#{i}.html")
         RecordListPageView.new(@activities, record, max, i).
                                write(output_file)
+        i += 1
       end
     end
 

data/lib/postrunner/QueryResult.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = QueryResult.rb -- PostRunner - Manage the data from your Garmin sport devices.
+#
+# Copyright (c) 2015 by Chris Schlaeger <cs@taskjuggler.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+module PostRunner
+
+  # Queries provide an abstract interface to retrieve individual values from
+  # Activities, Laps and so on. The result of a query is returned as a
+  # QueryResult object.
+  class QueryResult
+
+    # Create a QueryResult object.
+    # @param value [any] Result of the query
+    # @param schema [Schema] A reference to the Schema of the queried
+    #        attribute.
+    def initialize(value, schema)
+      @value = value
+      @schema = schema
+    end
+
+    # Conver the result into a text String.
+    def to_s
+      @schema.to_s(@value)
+    end
+
+  end
+
+end

data/lib/postrunner/RecordListPageView.rb

@@ -55,7 +55,8 @@ module PostRunner
           ViewFrame.new("All-time #{@sport_name} Records",
                         frame_width, @records.all_time).to_html(@doc)
 
-          @records.yearly.each do |year, record|
+          @records.yearly.sort{ |y1, y2| y2[0] <=> y1[0] }.
+                          each do |year, record|
             next if record.empty?
             ViewFrame.new("#{year} #{@sport_name} Records",
                           frame_width, record).to_html(@doc)

data/lib/postrunner/RuntimeConfig.rb

@@ -56,6 +56,18 @@ module PostRunner
       save_options
     end
 
+    # Ensure that the requested directory exists.
+    def create_directory(dir, name)
+      return if Dir.exists?(dir)
+
+      Log.info "Creating #{name} directory #{dir}"
+      begin
+        Dir.mkdir(dir)
+      rescue StandardError
+        Log.fatal "Cannot create #{name} directory #{dir}: #{$!}"
+      end
+    end
+
     private
 
     def load_options

data/lib/postrunner/Schema.rb

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = Schema.rb -- PostRunner - Manage the data from your Garmin sport devices.
+#
+# Copyright (c) 2015 by Chris Schlaeger <cs@taskjuggler.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+module PostRunner
+
+  # A Schema provides a unified way to query and process diverse data types.
+  class Schema
+
+    attr_reader :key, :name,
+                :func, :column_alignment, :metric_unit, :imperial_unit
+
+    # Create a Schema object.
+    # @param key [Symbol] The globally unique identifier for the object
+    # @param name [String] A human readable name to describe the object
+    # @param opts [Hash] A Hash with values to overwrite the default values
+    #        of some instance variables.
+    def initialize(key, name, opts = {})
+      @key = key
+      @name = name
+
+      # Default values for optional variables
+      @func = nil
+      @format = nil
+      @column_alignment = :right
+      @metric_unit = nil
+      @imperial_unit = nil
+
+      # Overwrite the default value for optional variables that have values
+      # provided in opts.
+      opts.each do |on, ov|
+        if instance_variable_defined?('@' + on.to_s)
+          instance_variable_set('@' + on.to_s, ov)
+        else
+          raise ArgumentError, "Unknown instance variable '#{on}'"
+        end
+      end
+    end
+
+    def to_s(value)
+      value = send(@format, value) if @format
+      value.to_s
+    end
+
+    private
+
+    def date_with_weekday(timestamp)
+      timestamp.strftime('%a, %Y %b %d %H:%M')
+    end
+
+  end
+
+end
+

data/lib/postrunner/version.rb

@@ -11,5 +11,5 @@
 #
 
 module PostRunner
-  VERSION = "0.0.8"
+  VERSION = "0.0.9"
 end

data/postrunner.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
   spec.required_ruby_version = '>=2.0'
 
-  spec.add_dependency 'fit4ruby', '~> 0.0.5'
+  spec.add_dependency 'fit4ruby', '~> 0.0.6'
   spec.add_dependency 'nokogiri', '~> 1.6'
 
   spec.add_development_dependency 'bundler', '~> 1.6'

data/spec/ActivitySummary_spec.rb

@@ -13,11 +13,15 @@
 require 'postrunner/ActivitySummary'
 require 'spec_helper'
 
+class Activity < Struct.new(:fit_activity, :sport)
+end
+
 describe PostRunner::ActivitySummary do
 
   before(:each) do
-    @as = PostRunner::ActivitySummary.new(
-      create_fit_activity('2014-08-26-19:00', 30), :metric,
+    fa = create_fit_activity('2014-08-26-19:00', 30)
+    a = Activity.new(fa, 'running')
+    @as = PostRunner::ActivitySummary.new(a, :metric,
                           { :name => 'test', :type => 'Running',
                             :sub_type => 'Street' })
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: postrunner
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Chris Schlaeger
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-12 00:00:00.000000000 Z
+date: 2015-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fit4ruby
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.0.5
+        version: 0.0.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.0.5
+        version: 0.0.6
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -121,14 +121,17 @@ files:
 - lib/postrunner/BackedUpFile.rb
 - lib/postrunner/ChartView.rb
 - lib/postrunner/DeviceList.rb
+- lib/postrunner/EPO_Downloader.rb
 - lib/postrunner/FlexiTable.rb
 - lib/postrunner/HTMLBuilder.rb
 - lib/postrunner/Main.rb
 - lib/postrunner/NavButtonRow.rb
 - lib/postrunner/PagingButtons.rb
 - lib/postrunner/PersonalRecords.rb
+- lib/postrunner/QueryResult.rb
 - lib/postrunner/RecordListPageView.rb
 - lib/postrunner/RuntimeConfig.rb
+- lib/postrunner/Schema.rb
 - lib/postrunner/TrackView.rb
 - lib/postrunner/UserProfileView.rb
 - lib/postrunner/View.rb