Columbus3

A gem to manage GPS tracks generated by the Columbus V900 and V990 GPS trackers.

This gem:

  • generates a sidecar file for each columbus track you process. The sidecar file contains information about date, start location, end location, max speed, etc.
  • allows to search tracks using complex queries. For instance, "get me all tracks with max speed less than 10 kilometers per hours"
  • allows to show one or more tracks on a map, using leaflet.js
  • it is "pipe friendly", so that you can search for all track matching a given criteria and show them on a map

Installation

Add this line to your application's Gemfile:

ruby
gem 'columbus3'

And then execute:

$ bundle

Or install it yourself as:

$ gem install columbus3

Usage

Get detailed instructions with:

columbus3 man

You can also view the manual online: manual.

A console is also available for simplifying interaction. Invoke it with:

columbus3 console

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in `version.rb`, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/\[USERNAME\]/columbus3.

Version History

0.5.0

  • Fixed a bug with searches on dates
  • Added converter from GPX to Columbus V900
  • Bumped leaflet and leaflet providers; updated map layers used by the show command
  • More informative messages when running commands
  • Added a console: launch it with columbus3 console
  • Fixed a bug with graph (call to sanitize failed)
  • Added Changelog File, which I am using to help mantaining this list of changes

0.4.0

  • Improved syntax for search:
    • new option -r searches in sub-directories
    • new option --fields allows to specify the fields to look for

0.3.0

  • Added documentation for search command; added this README file
  • New command graph plots data about a track (look for _graph.html in the current directory)
  • Added --force option to process
  • Internals: fixes to the sidecar class

0.2.1

  • Fixed bug in time parsing

0.2.0

  • Fixes to syntax
  • Print man page if not arguments are provided
  • Added --filename option to show command

0.1.0

  • Initial release

License

The original code of this gem is available as open source under the terms of the MIT License.

The gem ships wih the following javascript libraries, which are distributed according to their licenses: