columbus3 0.4.0 → 0.5.0

data/bower_components/leaflet/docs/reference-tpl.html

@@ -0,0 +1,89 @@
+<!-- Snippets to use for docs -->
+
+<!-- Argument -->
+
+<nobr>&lt;<a href="#foo">Foo</a>&gt; <i>name</i></nobr>
+
+
+<!-- Class -->
+
+<h2 id="[class-anchor]">[class-name]</h2>
+
+<p>[description]</p>
+
+<pre><code>[code-example]</code></pre>
+
+
+<!-- constructor -->
+
+<h3>Constructor</h3>
+
+<table>
+	<tr>
+		<th>Constructor</th>
+		<th>Usage</th>
+		<th>Description</th>
+	</tr>
+	<tr>
+		<td><code>[constructor]( [arguments]&nbsp;)</code></td>
+		<td class="factory-usage">
+			<code><span class='keyword'>new</span> L.Map(<span class="comment">&hellip;</span>)</code><br />
+			<code>L.map(<span class="comment">&hellip;</span>)</code>
+		</td>
+		<td>[description]</td>
+	</tr>
+</table>
+
+
+<!-- methods -->
+
+<h3>Methods</h3>
+<table>
+	<tr>
+		<th>Method</th>
+		<th>Returns</th>
+		<th>Description</th>
+	</tr>
+	<tr>
+		<td><code><b>[method]</b>(<nobr>&lt;type&gt;</nobr> <i>argument</i>, <nobr>&lt;type&gt; <i>argument</i>)</nobr></code></td>
+		<td><code>[return-type]</code></td>
+		<td>[description]</td>
+	</tr>
+</table>
+
+
+<!-- options -->
+
+<h3 id="[class-anchor]-options">Options</h3>
+
+<table>
+	<tr>
+		<th>Option</th>
+		<th>Type</th>
+		<th>Default value</th>
+		<th>Description</th>
+	</tr>
+	<tr>
+		<td><code><b>[name]</b></code></td>
+		<td><code>[type]</code></td>
+		<td><code>[default]</code></td>
+		<td>[description]</td>
+	</tr>
+</table>
+
+<!-- events -->
+
+<h3>Events</h3>
+
+<table>
+	<tr>
+		<th>Event</th>
+		<th>Data</th>
+		<th>Description</th>
+	</tr>
+	<tr>
+		<td><code><b>[name]</b></code></td>
+		<td><code><a href="[link]">[type]</a></code></td>
+		<td>[description]</td>
+	</tr>
+</table>

data/bower_components/leaflet/docs/reference-versions.html

@@ -0,0 +1,16 @@
+---
+layout: v2
+title: Documentation
+bodyclass: api-page
+---
+
+<h2>Available API References</h2>
+
+<p>This page lists the API references for several Leaflet versions.</p>
+
+<p><ul>
+	<li><a href='reference-0.7.7.html'>API reference for 0.7.x</a>
+	<li><a href='reference-1.0.0.html'>API reference for 1.0.0 and 1.0.1</a>
+	<li><a href='reference-1.0.2.html'>API reference for 1.0.2</a>
+	<li><a href='reference-1.0.3.html'>API reference for 1.0.3</a>
+</ul></p>

data/bower_components/leaflet/docs/reference.html

@@ -0,0 +1,3 @@
+---
+redirect_to: reference-1.0.3.html
+---

data/bower_components/leaflet/package.json

@@ -1,26 +1,86 @@
 {
   "name": "leaflet",
-  "version": "0.7.3",
+  "version": "1.1.0",
   "description": "JavaScript library for mobile-friendly interactive maps",
   "devDependencies": {
-    "jake": "~0.7.4",
-    "jshint": "~2.3.0",
-    "uglify-js": "~2.4.3",
-    "mocha": "~1.14.0",
-    "happen": "~0.1.3",
-    "karma": "~0.12.0",
-    "karma-mocha": "~0.1.1",
-    "karma-coverage": "~0.2.0",
-    "karma-phantomjs-launcher": "^0.1.2",
-    "karma-chrome-launcher": "^0.1.2",
-    "tin": "^0.4.0",
-    "copyfiles": "0.0.1"
+    "eslint": "^3.5.0 <3.6.0",
+    "eslint-config-mourner": "^2.0.1",
+    "git-rev-sync": "^1.8.0",
+    "happen": "~0.3.1",
+    "jake": "~8.0.12",
+    "karma": "^1.3.0",
+    "karma-chrome-launcher": "^2.0.0",
+    "karma-coverage": "~1.1.1",
+    "karma-firefox-launcher": "~1.0.0",
+    "karma-mocha": "^1.2.0",
+    "karma-phantomjs-launcher": "^1.0.2",
+    "karma-rollup-plugin": "^0.2.4",
+    "karma-safari-launcher": "~1.0.0",
+    "leafdoc": "^1.4.1",
+    "mocha": "^3.1.0",
+    "phantomjs-prebuilt": "^2.1.12",
+    "prosthetic-hand": "^1.3.1",
+    "rollup": "^0.41.4",
+    "rollup-plugin-git-version": "0.2.1",
+    "rollup-plugin-json": "^2.1.0",
+    "rollup-watch": "^2.5.0",
+    "source-map": "^0.5.6",
+    "ssri": "^4.1.2",
+    "uglify-js": "~2.7.3"
   },
   "main": "dist/leaflet-src.js",
+  "style": "dist/leaflet.css",
   "scripts": {
+    "test-jake": "jake test",
     "test": "jake test",
-    "prepublish": "jake build",
-    "publish": "./build/publish.sh"
+    "build-jake": "jake build",
+    "build": "npm run rollup && npm run uglify",
+    "release": "./build/publish.sh",
+    "lint": "eslint src; eslint spec/suites",
+    "lintfix": "eslint src --fix; eslint spec/suites --fix; ",
+    "rollup": "rollup -c build/rollup-config.js",
+    "watch": "rollup -w -c build/rollup-watch-config.js",
+    "uglify": "uglifyjs dist/leaflet-src.js -c -m -o dist/leaflet.js --source-map dist/leaflet.js.map --in-source-map dist/leaflet-src.js.map --source-map-url leaflet.js.map",
+    "integrity": "nodejs ./build/integrity.js"
+  },
+  "eslintConfig": {
+    "root": true,
+    "globals": {
+      "L": true
+    },
+    "env": {
+      "commonjs": true,
+      "amd": true,
+      "node": false
+    },
+    "extends": "mourner",
+    "parserOptions": {
+      "ecmaVersion": 6,
+      "sourceType": "module"
+    },
+    "rules": {
+      "linebreak-style": [
+        0,
+        "unix"
+      ],
+      "no-mixed-spaces-and-tabs": [
+        2,
+        "smart-tabs"
+      ],
+      "indent": [
+        2,
+        "tab",
+        {
+          "VariableDeclarator": 0
+        }
+      ],
+      "curly": 2,
+      "spaced-comment": 2,
+      "strict": 0,
+      "wrap-iife": 0,
+      "key-spacing": 0,
+      "consistent-return": 0
+    }
   },
   "repository": {
     "type": "git",
@@ -29,5 +89,6 @@
   "keywords": [
     "gis",
     "map"
-  ]
+  ],
+  "license": "BSD-2-Clause"
 }

data/columbus3.gemspec

@@ -23,6 +23,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "minitest"
 
-  spec.add_dependency "slop", "~> 3.6.0"
+  spec.add_dependency "slop", "~> 4.3.0"
   spec.add_dependency "geocoder"
 end

data/doc/ChangeLog.org

@@ -0,0 +1,10 @@
+Archived entries from file /home/adolfo/Documents/Sources/ruby/columbus3/doc/todo.org
+
+* DONE GPX import
+  :PROPERTIES:
+  :ARCHIVE_TIME: 2017-07-26 Wed 15:15
+  :ARCHIVE_FILE: ~/Documents/Sources/ruby/columbus3/doc/todo.org
+  :ARCHIVE_OLPATH: Rails: columbus3
+  :ARCHIVE_CATEGORY: todo
+  :ARCHIVE_TODO: DONE
+  :END:

data/doc/manual.txt

@@ -0,0 +1,122 @@
+NAME
+  columbus3 -- manage Columbus V900 and V990 tracks from the command line
+
+SYNOPSYS
+  columbus3 [-h|-v]
+  columbus3 command [options] [args]
+
+DESCRIPTION
+
+columbus3 manages Columbus V900 and V990 tracks from the command line,
+allowing a user to associate a sidecar file with the main information
+about a track, searching tracks (through sidecar files), displaying
+tracks on a map. 
+
+EXAMPLES
+
+    columbus3 -h                            # get syntax of each command
+    columbus3 process 11010101.CSV           # generate a sidecar file
+    columbus3 search 'location ~ "USA"'      # get tracks in the USA
+    columbus3 show 11010101.CSV 11010201.CSV # show tracks on a map (_show.html)
+    columbus3 graph 11010101.CSV             # show info about a track (_graph.html)
+
+if you do not want to type columbus3 each type, you can invoke a console:
+
+    columbus3 console
+    columbus3:000> process 11010101.CSV
+    columbus3:001> show 11010101.CSV
+    columbus3:002>
+
+columbus3 also has a function to convert a GPX into a bunch of CSV
+files (which you can then process with the other commands), with some
+limitations (see below).
+
+The command is useful if you are using different loggers for generating your
+tracks:
+
+    columbus3 convert file.gpx
+
+will generate
+
+     file-1.csv
+     file-2.csv
+     ...
+
+one per track in the GPX file.
+
+**CSV export limitations** The Columbus V900 format has fields with fixed width,
+and uses ^@ as a filler.  The CSV file generated by the convert command generates fields
+of variable width (standard CSV files, I dare say).  The heading field is not computed
+and the field is filled with -1.
+
+Piping commands. You can pipe the output of a search command to show, using
+the following syntax:
+
+  columbus3 search 'location ~ "USA"' --fields path | columbus3 show --sidecar
+
+The option --fields shows only the pathname of the files found; the option
+--sidecar removes the .yaml extension from the list of files found.
+
+SEARCH SYNTAX
+
+  >>> DON'T FORGET TO EMBED YOUR QUERY IN SINGLE QUOTES <<<
+
+Terms you can search for:
+
+  location, start_location, end_location
+  date, start_date, end_date
+  year
+  duration
+  max_speed
+  min_height
+  max_height
+
+Numerical operators:  
+  <, <=, ==, >=, >
+
+String operators (locations):
+  ~ (contains), == (is exactly)
+
+Complex Terms:
+  Use "and" and "or" to build complex queries
+
+Examples of simple searches
+  'location ~ "USA"'     any track whose start or end location contains USA
+  'date > 2015-02-14'    any track whose start or end date is after Feb 14, 2015
+  'year == 2015'         any track whose start or end date is in 2015
+  'duration <= 01:02:03' any track with a duration of less than 1h, 2min, and 3secs
+  'max_speed > 120'      any track with a max speed greater than 120 km/h
+  'min_height == 10'     any track with a min height lower than 10 meters
+
+Examples of complex searches
+  'location ~ "USA" and start_date >= 2015-01-01' tracks in the USA after or on Jan 1, 2015
+  'start_location ~ "Trenton" and end_location ~ "New York"'  trips from Trenton to New York
+
+List of supported fields in output
+  path           -> relative path of the CSV file
+  filename       -> basename of the CSV file
+  start_location -> start location
+  end_location   -> end location
+  start_date     -> start date (and time)
+  end_date       -> end date (and time)
+  duration       -> duration in seconds
+  min_speed      -> minimum speed in km/h
+  max_speed      -> maximum speed in km/h
+  min_height     -> minimum height in meters
+  max_height     -> maximum height in meters
+
+VERSION
+  This is version 0.5.0
+
+LICENSE
+  MIT
+
+  Columbus3 uses leaflet, leafleft-providers, flot, and jquery.  They
+  are distributed under a different license: see their websites for more
+  details (or have a look at the license file shipped with the Gem)
+
+SEE ALSO
+  If you are looking for a full graphical client, you might want to
+  download Columbus from http://www.minimalbit.com
+
+  https://github.com/avillafiorita/columbus3

data/doc/todo.org

@@ -0,0 +1,63 @@
+#+TITLE: Columbus3 Todos
+#+FILETAGS: :columbus3:
+#+ARCHIVE: ChangeLog.org::
+#+STARTUP: showall
+
+* Rails: columbus3
+** TODO integrate manual generation (manual.txt) in the deployment process
+** FEATURE be more informative about what is going on
+   Many commands succeed silently.  They could probably print some
+   informative messages
+** FEATURE As a user I want to be able to view the individual points
+   Performance is an issue, here.  Maybe activate the layer on a need-basis.
+   Also: it would be nice to produce a single GeoJSON set of data (e.g., the
+   point of a track and present it in different ways, e.g., line and points)
+   #+BEGIN_SRC ruby
+          <% @track.range.each do |i| %>
+          { "type": "Feature",
+            "geometry": {
+                "type": "Point",
+                "coordinates": <%= @track[i].lon_lat %>
+            },
+            "properties": {
+                "index": <%= i %>,
+                "time": "<%= @track[i].time %>",
+                "speed": <%= @track[i].speed %>,
+                "height": <%= @track[i].height %>,
+                <% [:max_speed, :min_height, :max_height].each do |x| %>
+                  <%= i == @track.send(x.to_s + "_idx") ? '"#{x}": "yes",' : ""%>
+                <% end %>
+            }
+          },
+          <% end %>
+   #+END_SRC
+   #+BEGIN_SRC javascript
+   pointToLayer: function (feature, latlng) {
+        if (feature.properties....) 
+				return L.circleMarker(latlng, {
+					radius: 8,
+					fillColor: "#ff7800",
+					color: "#000",
+					weight: 1,
+					opacity: 1,
+					fillOpacity: 0.8
+				});
+    }
+   #+END_SRC
+
+** FEATURE As a user I want to identify the time/index of individual points
+   This is useful for track splitting
+** FEATURE As a user I want to have an idea of the direction and other info such as speed and height
+   Some possible solutions include: color dots, put height and speed plot on the same page)
+** FEATURE As a user I want to split a track at point
+   Pass the index as argument and generate two files out of the existing one
+   Give the option to delete the old file and to process the new files
+** FEATURE GPX export for DarkTable and GoogleEarth
+** FEATURE As a user I want to be able to add custom fields
+   Allow users to specify custom fields in the sidecar file
+** FEATURE As a user I want to filter values with wrong precision
+** FEATURE As a user I do not want to view data only in ZULU time
+   - get the local timezone (or let the user specify a timezone)
+   - use the timezone of the starting point
+** FEATURE Make it into a sinatra app?
+

data/exe/columbus3

@@ -1,249 +1,5 @@
 #!/usr/bin/env ruby
 
-require "slop"
-require "columbus3"
-require "find"
+require 'columbus3'
 
-appname = "columbus3"
-version = Columbus3::VERSION
-usage = "#{appname} [-h|-v]\n#{appname} command [options] [args]"
-man = <<EOS
-NAME
-  #{appname} -- manage Columbus V900 and V990 tracks from the command line
-
-SYNOPSYS
-  #{appname} [-h|-v]
-  #{appname} command [options] [args]
-
-DESCRIPTION
-
-columbus3 manages Columbus V900 and V990 tracks from the command line,
-allowing a user to associate a sidecar file with the main information
-about a track, searching tracks (through sidecar files), displaying
-tracks on a map. 
-
-EXAMPLES
-  #{appname} -h                            # get syntax of each command
-  columbus3 process 11010101.CSV           # generate a sidecar file
-  columbus3 search 'location ~ "USA"'      # track in the USA
-  columbus3 show 11010101.CSV 11010201.CSV # show tracks on a map (_show.html)
-  columbus3 graph 11010101.CSV             # show info about a track (_graph.html)
-
-SEARCH SYNTAX
-
-  >>> DON'T FORGET TO EMBED YOUR QUERY IN SINGLE QUOTES <<<
-
-Terms you can search for:
-  location, start_location, end_location
-  date, start_date, end_date
-  year
-  duration
-  max_speed
-  min_height
-  max_height
-
-Numerical operators:  
-  <, <=, ==, >=, >
-
-String operators (locations):
-  ~ (contains), == (is exactly)
-
-Complex Terms:
-  Use "and" and "or" to build complex queries
-
-Examples of simple searches
-  'location ~ "USA"'     any track whose start or end location contains USA
-  'date > 2015-02-14'    any track whose start or end date is after Feb 14, 2015
-  'year == 2015'         any track whose start or end date is in 2015
-  'duration <= 01:02:03' any track with a duration of less than 1h, 2min, and 3secs
-  'max_speed > 120'      any track with a max speed greater than 120 km/h
-  'min_height == 10'     any track with a min height lower than 10 meters
-
-Examples of complex searches
-  'location ~ "USA" and start_date >= 2015-01-01' tracks in the USA after or on Jan 1, 2015
-  'start_location ~ "Trenton" and end_location ~ "New York"'  trips from Trenton to New York
-
-List of supported fields in output
-  path           -> relative path of the CSV file
-  filename       -> basename of the CSV file
-  start_location -> start location
-  end_location   -> end location
-  start_date     -> start date (and time)
-  end_date       -> end date (and time)
-  duration       -> duration in seconds
-  min_speed      -> minimum speed in km/h
-  max_speed      -> maximum speed in km/h
-  min_height     -> minimum height in meters
-  max_height     -> maximum height in meters
-
-VERSION
-  This is version #{version}
-
-LICENSE
-  MIT
-
-  Columbus3 uses leaflet, leafleft-providers, flot, and jquery.  They
-  are distributed under a different license: see their websites for more
-  details (or have a look at the license file shipped with the Gem)
-
-SEE ALSO
-  If you are looking for a full graphical client, you might want to
-  download Columbus from http://www.minimalbit.com
-
-  https://github.com/avillafiorita/columbus3
-EOS
-
-#
-# Main App Starts Here!
-#
-cmd = nil
-opts = Slop.parse :help => true do
-  banner usage
-  
-  ##############################################################################
-  on "-v", "--version", 'Print version information' do
-    cmd ="version"
-    puts "#{appname} version #{version}"
-  end
-
-  ##############################################################################
-  command :man do
-    banner "#{appname} man"
-    description "Print man page for #{appname}"
-
-    run do |_, _|
-      cmd ="man"
-      puts man
-    end
-  end
-
-  ##############################################################################
-  command :process do
-    banner "#{appname} process [--help] [track ...]"
-    description "Generate a sidecar file for the specified tracks"
-
-    on "--force", "Overwrite existing sidecar files"
-    
-    run do |opts, args|
-      cmd ="process"
-      force = opts.to_hash[:force]
-      
-      args.each do |arg|
-        track = V900Track.new arg
-        sidecar = Columbus3::Sidecar.new arg
-        if sidecar.exist? and not force
-          puts "Sidecar file for #{track} already exists. Use --force if you want to overwrite it."
-        else
-          sidecar.metadata = track.metadata
-          sidecar.save
-        end
-      end
-    end
-  end
-
-  ##############################################################################
-  command :search do
-    banner "#{appname} search [--help] [-r] [--dir directory] [--fields fields] query"
-    description "Search dir for tracks matching query"
-
-    on "--debug", "Show how the query is processed"
-    on "-r", "--recurse", "Recurse in subdirectories"
-    on "-d", "--dir=", "Directory with sidecar files"
-    on "-fields=", "Comma separated list of fields to show"
-
-    run do |opts, args|
-      cmd ="search"
-
-      debug = opts.to_hash[:debug]
-      directory = opts.to_hash[:dir] || "."
-      recurse = opts.to_hash[:recurse]
-      fields_opt = opts.to_hash[:fields]
-
-      if fields? then
-        fields = fields_opt.split(",").map { |x| x.to_sym }
-      else
-        fields = [:path, :filename, :start_location, :end_location, :start_date, :end_date, :duration, :min_speed, :max_speed, :min_height, :max_height]
-      end
-      
-      if recurse then
-        files = Find.find(directory).select { |e| File.extname(e) == ".yaml" }
-      else
-        files = Dir.glob(File.join(directory, "*.yaml"))
-      end
-      query = QueryParser.new.parse(args.join(" "))
-
-      if debug then
-        puts "Searched files: #{files.join(",")}"
-        puts "Searched files count: #{files.size}"
-        puts "Processed query: #{query}"
-      else
-        sidecar_search = Columbus3::SidecarSearch.new
-        sidecar_search.load files
-        match = sidecar_search.search query
-        match.each do |m|
-          string = fields.map { |x| "#{m[x]}"}.join("\t")
-          puts string
-        end
-      end
-    end
-  end
-
-  ##############################################################################
-  command :show do
-    banner "#{appname} show [--help] [--filename filename] [--force] [track ...]"
-    description "View tracks"
-
-    on "-f", "--filename=", "Output filename (default is _show.html)"
-    on "--force", "Force rewriting of the js file, even if it already exists"
-
-    run do |opts, args|
-      cmd ="show"
-
-      filename = opts.to_hash[:filename] || "_show.html"
-      force = opts.to_hash[:force]
-
-      args.each do |arg|
-        Columbus3::LeafletRenderer::to_leaflet arg, force
-      end
-      (Columbus3::LeafletRenderer::show filename, args) if args != []
-    end
-  end
-
-  ##############################################################################
-  command :graph do
-    banner "#{appname} show [--help] [--filename filename] [--force] track"
-    description "Plot speed and height profile of track"
-
-    on "--force", "Force rewriting of the js file, even if it already exists"
-
-    run do |opts, args|
-      cmd ="graph"
-
-      filename = opts.to_hash[:filename] || "_graph.html"
-      force = opts.to_hash[:force]
-
-      input_filename = args[0]
-      if input_filename
-        Columbus3::FlotRenderer::to_graph_data input_filename, force
-        Columbus3::FlotRenderer::show filename, input_filename
-      else
-        puts "Error: please specify a track file"
-      end
-    end
-  end
-
-  ##############################################################################
-  command :export do
-    banner "#{appname} export [--help] [track ...]"
-    description "Export track to GPX"
-
-    run do |opts, args|
-      cmd ="export"
-      puts "Not implemented yet. Use GPSBabel in the meantime."
-    end
-  end
-end
-
-if not cmd then
-  puts opts
-end
+Columbus3::CommandSemantics.reps Columbus3::CommandSyntax.commands, ARGV