gooby 0.9.3 → 0.9.4

data/lib/gooby/cls_gooby_command.rb

@@ -14,17 +14,28 @@ module Gooby
       Gooby::Options.new(yaml_filename)
     end
 
-    def split_forerunner_xml(xml_filename, out_dir)  
+    def split_garmin_forerunner_logbook_xml(xml_filename, out_dir)  
       splitter = Gooby::ForerunnerXmlSplitter.new(xml_filename, out_dir)  
       splitter.split
     end
     
-    def parse_forerunner_xml(xml_filename)  
+    def split_garmin_training_center_xml(tcx_filename, out_dir)  
+      splitter = Gooby::TrainingCenterXmlSplitter.new(tcx_filename, out_dir)  
+      splitter.split
+    end
+        
+    def parse_garmin_forerunner_logbook_xml(xml_filename)  
       handler = Gooby::ForerunnerXmlParser.new     
       Document.parse_stream((File.new xml_filename), handler)
       handler.put_all_run_tkpt_csv(true)
     end
-
+    
+    def parse_garmin_training_center_xml(tcx_filename)  
+      handler = Gooby::TrainingCenterXmlParser.new     
+      Document.parse_stream((File.new tcx_filename), handler)
+      handler.put_all_run_tkpt_csv(true)
+    end
+    
     def generate_google_map(csv_filename, options_obj)  
       generator = Gooby::GoogleMapGenerator.new(csv_filename)  
       generator.generate_page(options_obj)

data/lib/gooby/cls_training_center_parser.rb

@@ -0,0 +1,183 @@
+module Gooby
+
+=begin rdoc
+  Instances of this class are used to parse a Garmin TrainingCenter XML file
+  in a SAX-like manner.  Instances of the model classes - History, Run, Track,
+  Trackpoint, etc. are created in this parsing process.  
+
+  See http://www.garmin.com/xmlschemas/TrainingCenterDatabasev2.xsd for the XML
+  Schema Definition for Garmin TrainingCenter XML.  
+=end
+  
+  class TrainingCenterXmlParser  
+  
+    DETAIL_TAGS = %w( Notes StartTime Duration Length Time
+                      TotalTimeSeconds DistanceMeters   
+                      LatitudeDegrees LongitudeDegrees AltitudeMeters BeginPosition EndPosition )
+  
+    include REXML::StreamListener
+  
+    attr_reader :history, :cvHash, :tagCount
+  
+    def initialize
+      @cvHash            = Hash.new("")
+      @tagCount          = 0
+      @runCount          = 0
+      @lapCount          = 0
+      @trackCount        = 0
+      @trackpoint_count  = 0
+      @currText          = "";
+      @history           = History.new
+      @currRun           = nil
+      @currLap           = nil
+      @currTrack         = nil
+      @currBeginPosition = nil
+      @currEndPosition   = nil
+    end
+  
+    public
+ 
+    # SAX API method; handles 'Activity', 'Lap', 'Track'.   
+    def tag_start(tagname, attrs) 
+      @tagCount += 1
+      @currTag = tagname
+      @cvHash[tagname] = ''
+    
+      if detail_tag?(tagname)
+        @inDetail = true
+      end
+    
+      if is_tag?('Activity', tagname)
+        @runCount = @runCount + 1
+        @lapCount = 0
+        @trackCount = 0
+        @currRun  = Run.new(@runCount)
+        @history.add_run(@currRun)
+        @cvHash['Notes'] = ''
+        return
+      end
+    
+      if is_tag?('Lap', tagname)
+        @lapCount = @lapCount + 1
+        @currLap  = Lap.new(@lapCount)
+        # TODO - capture value of 'StartTime' attribute.       
+        return
+      end
+    
+      if is_tag?('Track', tagname)
+        @trackCount = @trackCount + 1      
+        @currTrack  = Track.new(@trackCount)
+        @trackpoint_count = 0   
+        return   
+      end
+    
+    end
+
+    # SAX API method; handles 'Position', 'Trackpoint', 'Track', 'Lap', 'Run'. 
+    def tag_end(tagname) 
+      if @inDetail    
+        @cvHash[tagname] = @currText
+      else
+        if is_tag?('Position', tagname)
+          lat  = @cvHash['LatitudeDegrees']
+          long = @cvHash['LongitudeDegrees']
+          @currBeginPosition = Position.new(lat.strip, long.strip, '')
+          @currEndPosition   = Position.new(lat.strip, long.strip, '')       
+        end 
+        
+        if is_tag?('BeginPosition', tagname)
+          lat  = @cvHash['LatitudeDegrees']
+          long = @cvHash['LongitudeDegrees']
+          @currBeginPosition = Position.new(lat.strip, long.strip, '')      
+        end
+        
+        if is_tag?('EndPosition', tagname)
+          lat  = @cvHash['LatitudeDegrees']
+          long = @cvHash['LongitudeDegrees']
+          @currEndPosition = Position.new(lat.strip, long.strip, '')      
+        end
+              
+        if is_tag?('Trackpoint', tagname)
+          @trackpoint_count = @trackpoint_count + 1
+          lat  = @cvHash['LatitudeDegrees']
+          long = @cvHash['LongitudeDegrees']
+          alt  = @cvHash['AltitudeMeters']   
+          time = @cvHash['Time']                
+          tp   = Trackpoint.new(@trackpoint_count, lat, long, alt, time)
+          @currTrack.add_trackpoint(tp)
+        end
+      
+        if is_tag?('Track', tagname)
+          if @currRun != nil
+            @currRun.add_track(@currTrack)
+          end
+        end
+      
+        if is_tag?('Lap', tagname)
+          # TotalTimeSeconds DistanceMeters
+          # TODO - rework tnd of Lap for tcx
+          # @currLap.startTime = @cvHash['StartTime']
+          # @currLap.duration  = Duration.new(@cvHash['Duration'])
+          # @currLap.length    = @cvHash['Length']                          
+          # @currLap.beginPosition = @currBeginPosition
+          # @currLap.endPosition   = @currEndPosition        
+          @currRun.add_lap(@currLap)
+        end
+      
+        if is_tag?('Activity', tagname)
+          @currRun.notes =  @cvHash['Notes'] 
+        end
+      end
+    
+      @inDetail = false    
+      @currText = ""
+      @currTag  = ""                     
+    end
+
+    # SAX API method.
+    def text(txt)  
+      if @inDetail
+        @currText = @currText + txt   
+      end
+    end
+
+  # Iterate all parsed Run objects and print each with to_s.
+    def gdump()      
+      @history.runs().each { |run| puts run.to_s } 
+    end
+
+  # Iterate all parsed Run objects and print each with to_s.
+    def dump()        
+      @history.runs().each { |run| puts run.to_s } 
+    end
+
+  # Iterate all parsed Run objects and print each with put_csv.
+    def put_run_csv() 
+      @history.runs().each { |run| run.put_csv() } 
+    end
+
+  # Iterate all parsed Run objects and print each with put_tkpt_csv.
+    def put_all_run_tkpt_csv(with_header_comment) 
+      @history.runs.each { |run| 
+        run.put_tkpt_csv(with_header_comment)
+      } 
+    end
+
+    private 
+  
+    def is_tag?(tagname, value)
+      tagname == value
+    end
+  
+    def detail_tag?(tagname)
+      DETAIL_TAGS.each { |typ| 
+        if typ == tagname 
+          return true    
+        end
+      }
+      return false
+    end
+  
+  end
+
+end # end of module

data/lib/gooby/cls_training_center_splitter.rb

@@ -0,0 +1,109 @@
+module Gooby
+
+=begin rdoc
+  Instances of this class are used to split a large Garmin TrainingCenter
+  *.tcx file into individual 'activity_' files.
+=end
+  
+  class TrainingCenterXmlSplitter < GoobyObject 
+    
+    attr_reader :out_dir, :training_center_files, :out_files_hash
+    
+    def initialize(tcx_file, out_dir)
+      @out_dir = out_dir
+      @training_center_files = Array.new
+      @training_center_files << tcx_file
+      @out_files_hash   = Hash.new
+    end
+    
+    def split
+      @training_center_files.each { |f| process_file(f) }
+      write_files
+    end
+    
+    private 
+    
+    def process_file(training_center_tcx_file)
+      @file_name = training_center_tcx_file
+      @tcx_lines = read_lines(@file_name, false) 
+      @line_num  = 0
+      @activity_num   = 0
+      @curr_activity_lines = Array.new
+      @curr_activity_tkpts = 0
+      @start_line_num = 0
+      @end_line_num   = 0
+      @activity_start_time = nil
+    
+      @tcx_lines.each { |line|
+        @line_num = @line_num + 1              
+        if (line.match(/<Activity /))
+          @activity_num = @activity_num + 1
+          @start_line_num = @line_num
+          @curr_activity_lines = Array.new
+          @curr_activity_lines << line
+        elsif (line.match(/<Id>/)) # <Id>2007-03-03T15:58:57Z</Id>  <StartTime>2007-01-13T15:37:06Z</StartTime>
+          @curr_activity_lines << line   
+          if @activity_start_time == nil
+            clone = String.new(line)     
+            clone.gsub!(/[<>]/, ' ')  
+            clone.gsub!(/[-:T]/, '_')
+            clone.gsub!(/[Z]/, '') 
+            tokens = clone.split
+            @activity_start_time = tokens[1]
+          end          
+        elsif (line.match(/<Trackpoint>/)) 
+           @curr_activity_tkpts =  @curr_activity_tkpts + 1
+           @curr_activity_lines << line 
+        elsif (line.match(/<\/Activity/))
+          @end_line_num = @line_num 
+           @curr_activity_lines << line           
+          end_run 
+        elsif (@curr_activity_lines.size > 0)
+          @curr_activity_lines << line 
+        end
+      }
+    end
+  
+    def end_run
+      out_file = "#{@out_dir}/activity_#{@activity_start_time}.xml"
+      comment = "<!-- file: #{out_file}  lines: #{@curr_activity_lines.size} (#{@start_line_num} to #{@end_line_num})  tkpts: #{@curr_activity_tkpts} --> \n"
+      @curr_activity_lines.insert(0, comment)
+          
+      prev_entry = @out_files_hash[out_file]
+      if prev_entry
+        if (@curr_activity_lines.size >= prev_entry.size)
+          puts "previous entry overlaid for #{out_file}.  curr=#{@curr_activity_lines.size}  prev=#{prev_entry.size}"
+          @out_files_hash[out_file] = @curr_activity_lines
+        else
+          puts "previous entry retained for #{out_file}.  curr=#{@curr_activity_lines.size}  prev=#{prev_entry.size}"
+        end
+      else
+          puts "new entry for #{out_file}.  curr=#{@curr_activity_lines.size}"
+          @out_files_hash[out_file] = @curr_activity_lines          
+      end
+      
+      @curr_activity_lines   = Array.new
+      @curr_activity_tkpts   = 0
+      @start_line_num   = 0
+      @end_line_num     = 0
+      @activity_start_time = nil                
+    end
+    
+    def write_files
+      out_names = @out_files_hash.keys.sort
+      puts "Writing #{out_names.size} extract files..."
+      out_names.each { |out_name| 
+        lines = @out_files_hash[out_name]
+        out = File.new out_name, "w+"
+        lines.each { |line| out.write line }
+        out.flush
+        out.close
+        puts "File written: #{out_name}"
+      }
+      puts "output files written."
+    end
+    
+  end
+
+end # end of module
+

data/lib/gooby/mod_project_info.rb

@@ -12,7 +12,7 @@ module Gooby
 
   # Return a String version number, like '1.0.0'.
     def project_version_number   
-      '0.9.3'
+      '0.9.4'
     end
 
   # Return a String date, like '2007/02/25'.  

data/lib/gooby.rb

@@ -1,4 +1,4 @@
-# Packaged on Sat Mar 03 16:56:38 EST 2007 
+# Packaged on Fri Mar 09 06:03:09 EST 2007 
 
 =begin
 
@@ -34,7 +34,7 @@ module Gooby
 
   # Return a String version number, like '1.0.0'.
     def project_version_number   
-      '0.9.3'
+      '0.9.4'
     end
 
   # Return a String date, like '2007/02/25'.  
@@ -805,6 +805,293 @@ module Gooby
   end
 
 
+=begin rdoc
+  Instances of this class are used to parse a Garmin TrainingCenter XML file
+  in a SAX-like manner.  Instances of the model classes - History, Run, Track,
+  Trackpoint, etc. are created in this parsing process.  
+
+  See http://www.garmin.com/xmlschemas/TrainingCenterDatabasev2.xsd for the XML
+  Schema Definition for Garmin TrainingCenter XML.  
+=end
+  
+  class TrainingCenterXmlParser  
+  
+    DETAIL_TAGS = %w( Notes StartTime Duration Length Time
+                      TotalTimeSeconds DistanceMeters   
+                      LatitudeDegrees LongitudeDegrees AltitudeMeters BeginPosition EndPosition )
+  
+    include REXML::StreamListener
+  
+    attr_reader :history, :cvHash, :tagCount
+  
+    def initialize
+      @cvHash            = Hash.new("")
+      @tagCount          = 0
+      @runCount          = 0
+      @lapCount          = 0
+      @trackCount        = 0
+      @trackpoint_count  = 0
+      @currText          = "";
+      @history           = History.new
+      @currRun           = nil
+      @currLap           = nil
+      @currTrack         = nil
+      @currBeginPosition = nil
+      @currEndPosition   = nil
+    end
+  
+    public
+ 
+    # SAX API method; handles 'Activity', 'Lap', 'Track'.   
+    def tag_start(tagname, attrs) 
+      @tagCount += 1
+      @currTag = tagname
+      @cvHash[tagname] = ''
+    
+      if detail_tag?(tagname)
+        @inDetail = true
+      end
+    
+      if is_tag?('Activity', tagname)
+        @runCount = @runCount + 1
+        @lapCount = 0
+        @trackCount = 0
+        @currRun  = Run.new(@runCount)
+        @history.add_run(@currRun)
+        @cvHash['Notes'] = ''
+        return
+      end
+    
+      if is_tag?('Lap', tagname)
+        @lapCount = @lapCount + 1
+        @currLap  = Lap.new(@lapCount)
+        # TODO - capture value of 'StartTime' attribute.       
+        return
+      end
+    
+      if is_tag?('Track', tagname)
+        @trackCount = @trackCount + 1      
+        @currTrack  = Track.new(@trackCount)
+        @trackpoint_count = 0   
+        return   
+      end
+    
+    end
+
+    # SAX API method; handles 'Position', 'Trackpoint', 'Track', 'Lap', 'Run'. 
+    def tag_end(tagname) 
+      if @inDetail    
+        @cvHash[tagname] = @currText
+      else
+        if is_tag?('Position', tagname)
+          lat  = @cvHash['LatitudeDegrees']
+          long = @cvHash['LongitudeDegrees']
+          @currBeginPosition = Position.new(lat.strip, long.strip, '')
+          @currEndPosition   = Position.new(lat.strip, long.strip, '')       
+        end 
+        
+        if is_tag?('BeginPosition', tagname)
+          lat  = @cvHash['LatitudeDegrees']
+          long = @cvHash['LongitudeDegrees']
+          @currBeginPosition = Position.new(lat.strip, long.strip, '')      
+        end
+        
+        if is_tag?('EndPosition', tagname)
+          lat  = @cvHash['LatitudeDegrees']
+          long = @cvHash['LongitudeDegrees']
+          @currEndPosition = Position.new(lat.strip, long.strip, '')      
+        end
+              
+        if is_tag?('Trackpoint', tagname)
+          @trackpoint_count = @trackpoint_count + 1
+          lat  = @cvHash['LatitudeDegrees']
+          long = @cvHash['LongitudeDegrees']
+          alt  = @cvHash['AltitudeMeters']   
+          time = @cvHash['Time']                
+          tp   = Trackpoint.new(@trackpoint_count, lat, long, alt, time)
+          @currTrack.add_trackpoint(tp)
+        end
+      
+        if is_tag?('Track', tagname)
+          if @currRun != nil
+            @currRun.add_track(@currTrack)
+          end
+        end
+      
+        if is_tag?('Lap', tagname)
+          # TotalTimeSeconds DistanceMeters
+          # TODO - rework tnd of Lap for tcx
+          # @currLap.startTime = @cvHash['StartTime']
+          # @currLap.duration  = Duration.new(@cvHash['Duration'])
+          # @currLap.length    = @cvHash['Length']                          
+          # @currLap.beginPosition = @currBeginPosition
+          # @currLap.endPosition   = @currEndPosition        
+          @currRun.add_lap(@currLap)
+        end
+      
+        if is_tag?('Activity', tagname)
+          @currRun.notes =  @cvHash['Notes'] 
+        end
+      end
+    
+      @inDetail = false    
+      @currText = ""
+      @currTag  = ""                     
+    end
+
+    # SAX API method.
+    def text(txt)  
+      if @inDetail
+        @currText = @currText + txt   
+      end
+    end
+
+  # Iterate all parsed Run objects and print each with to_s.
+    def gdump()      
+      @history.runs().each { |run| puts run.to_s } 
+    end
+
+  # Iterate all parsed Run objects and print each with to_s.
+    def dump()        
+      @history.runs().each { |run| puts run.to_s } 
+    end
+
+  # Iterate all parsed Run objects and print each with put_csv.
+    def put_run_csv() 
+      @history.runs().each { |run| run.put_csv() } 
+    end
+
+  # Iterate all parsed Run objects and print each with put_tkpt_csv.
+    def put_all_run_tkpt_csv(with_header_comment) 
+      @history.runs.each { |run| 
+        run.put_tkpt_csv(with_header_comment)
+      } 
+    end
+
+    private 
+  
+    def is_tag?(tagname, value)
+      tagname == value
+    end
+  
+    def detail_tag?(tagname)
+      DETAIL_TAGS.each { |typ| 
+        if typ == tagname 
+          return true    
+        end
+      }
+      return false
+    end
+  
+  end
+
+
+=begin rdoc
+  Instances of this class are used to split a large Garmin TrainingCenter
+  *.tcx file into individual 'activity_' files.
+=end
+  
+  class TrainingCenterXmlSplitter < GoobyObject 
+    
+    attr_reader :out_dir, :training_center_files, :out_files_hash
+    
+    def initialize(tcx_file, out_dir)
+      @out_dir = out_dir
+      @training_center_files = Array.new
+      @training_center_files << tcx_file
+      @out_files_hash   = Hash.new
+    end
+    
+    def split
+      @training_center_files.each { |f| process_file(f) }
+      write_files
+    end
+    
+    private 
+    
+    def process_file(training_center_tcx_file)
+      @file_name = training_center_tcx_file
+      @tcx_lines = read_lines(@file_name, false) 
+      @line_num  = 0
+      @activity_num   = 0
+      @curr_activity_lines = Array.new
+      @curr_activity_tkpts = 0
+      @start_line_num = 0
+      @end_line_num   = 0
+      @activity_start_time = nil
+    
+      @tcx_lines.each { |line|
+        @line_num = @line_num + 1              
+        if (line.match(/<Activity /))
+          @activity_num = @activity_num + 1
+          @start_line_num = @line_num
+          @curr_activity_lines = Array.new
+          @curr_activity_lines << line
+        elsif (line.match(/<Id>/)) # <Id>2007-03-03T15:58:57Z</Id>  <StartTime>2007-01-13T15:37:06Z</StartTime>
+          @curr_activity_lines << line   
+          if @activity_start_time == nil
+            clone = String.new(line)     
+            clone.gsub!(/[<>]/, ' ')  
+            clone.gsub!(/[-:T]/, '_')
+            clone.gsub!(/[Z]/, '') 
+            tokens = clone.split
+            @activity_start_time = tokens[1]
+          end          
+        elsif (line.match(/<Trackpoint>/)) 
+           @curr_activity_tkpts =  @curr_activity_tkpts + 1
+           @curr_activity_lines << line 
+        elsif (line.match(/<\/Activity/))
+          @end_line_num = @line_num 
+           @curr_activity_lines << line           
+          end_run 
+        elsif (@curr_activity_lines.size > 0)
+          @curr_activity_lines << line 
+        end
+      }
+    end
+  
+    def end_run
+      out_file = "#{@out_dir}/activity_#{@activity_start_time}.xml"
+      comment = "<!-- file: #{out_file}  lines: #{@curr_activity_lines.size} (#{@start_line_num} to #{@end_line_num})  tkpts: #{@curr_activity_tkpts} --> \n"
+      @curr_activity_lines.insert(0, comment)
+          
+      prev_entry = @out_files_hash[out_file]
+      if prev_entry
+        if (@curr_activity_lines.size >= prev_entry.size)
+          puts "previous entry overlaid for #{out_file}.  curr=#{@curr_activity_lines.size}  prev=#{prev_entry.size}"
+          @out_files_hash[out_file] = @curr_activity_lines
+        else
+          puts "previous entry retained for #{out_file}.  curr=#{@curr_activity_lines.size}  prev=#{prev_entry.size}"
+        end
+      else
+          puts "new entry for #{out_file}.  curr=#{@curr_activity_lines.size}"
+          @out_files_hash[out_file] = @curr_activity_lines          
+      end
+      
+      @curr_activity_lines   = Array.new
+      @curr_activity_tkpts   = 0
+      @start_line_num   = 0
+      @end_line_num     = 0
+      @activity_start_time = nil                
+    end
+    
+    def write_files
+      out_names = @out_files_hash.keys.sort
+      puts "Writing #{out_names.size} extract files..."
+      out_names.each { |out_name| 
+        lines = @out_files_hash[out_name]
+        out = File.new out_name, "w+"
+        lines.each { |line| out.write line }
+        out.flush
+        out.close
+        puts "File written: #{out_name}"
+      }
+      puts "output files written."
+    end
+    
+  end
+
+
 =begin rdoc
   Instances of this class represent a the set of Geographic data defined in file geo.txt
 =end
@@ -2244,17 +2531,28 @@ HERE
       Gooby::Options.new(yaml_filename)
     end
 
-    def split_forerunner_xml(xml_filename, out_dir)  
+    def split_garmin_forerunner_logbook_xml(xml_filename, out_dir)  
       splitter = Gooby::ForerunnerXmlSplitter.new(xml_filename, out_dir)  
       splitter.split
     end
     
-    def parse_forerunner_xml(xml_filename)  
+    def split_garmin_training_center_xml(tcx_filename, out_dir)  
+      splitter = Gooby::TrainingCenterXmlSplitter.new(tcx_filename, out_dir)  
+      splitter.split
+    end
+        
+    def parse_garmin_forerunner_logbook_xml(xml_filename)  
       handler = Gooby::ForerunnerXmlParser.new     
       Document.parse_stream((File.new xml_filename), handler)
       handler.put_all_run_tkpt_csv(true)
     end
-
+    
+    def parse_garmin_training_center_xml(tcx_filename)  
+      handler = Gooby::TrainingCenterXmlParser.new     
+      Document.parse_stream((File.new tcx_filename), handler)
+      handler.put_all_run_tkpt_csv(true)
+    end
+    
     def generate_google_map(csv_filename, options_obj)  
       generator = Gooby::GoogleMapGenerator.new(csv_filename)  
       generator.generate_page(options_obj)

data/pkg/pkg.rb

@@ -152,6 +152,8 @@ module Gooby
       cls_duration.rb
       cls_forerunner_xml_parser.rb
       cls_forerunner_xml_splitter.rb
+      cls_training_center_parser.rb
+      cls_training_center_splitter.rb
       cls_geo_data.rb
       cls_google_map_generator.rb
       cls_history.rb

data/tests/tc_mod_project_info.rb

@@ -60,7 +60,7 @@ class TestModuleProjectInfo < Test::Unit::TestCase
   def test_module_GoobyProjectInfo_project_version_number
 
     obj = Gooby::GoobyObject.new    
-    assert_equal '0.9.3', obj.project_version_number
+    assert_equal '0.9.4', obj.project_version_number
   end
 
   def test_module_GoobyProjectInfo_project_year