silva 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/README.md

@@ -0,0 +1,36 @@
+What is Silva?
+=============
+A RubyGem which provides utilities to convert between the WGS84 standard for location information (as used by Google Maps, the GPS system, etc.) and the UK Ordnance Survey's OSGB36 datum, easting/northing format and standard grid references.
+
+How do I use it?
+================
+`gem install silva`
+
+`require 'silva'`
+
+`Silva::Location.from(:wgs84, :lat => 52.658008, :long => 1.716077).to(:gridref)`
+
+`"TG51411318"``
+
+What else can it do?
+===================
+Silva works with four different location systems:
+
+- WGS84 `(:wgs84, :lat => [latitude], :long => [longitude], :alt => [optional altitude])`
+- OSGB36 `(:osgb36, params as above)`
+- EN `(:en, :easting => [easting], :northing => [northing])`
+- GridRef `(:gridref, :gridref => [gridref] OR :easting => [easting], :northing => [northing])`
+
+It can convert freely among each of them using the syntax Silva::Location.from(:system, params).to(:system, params).
+
+Why did you write it?
+=====================
+I needed to convert between WGS84 co-ordinates and Ordnance Survey grid references, and nothing out there quite did what I wanted (although see below). I'm also beginning with Ruby and wanted to get familiar with the idioms and best practices, so creating a gem seemed like a good way to do that.
+
+Anything else?
+=============
+I began with code written by (Harry Wood)[http://www.harrywood.co.uk/blog/2010/06/29/ruby-code-for-converting-to-uk-ordnance-survey-coordinate-systems-from-wgs84], who adapted code written by (Chris Veness)[http://www.movable-type.co.uk/scripts/latlong-convert-coords.html]. I subsequently went back over the maths to make sure I understood it reasonably well, and clarified it so that it's easy to check against the resources supplied by the Ordnance Survey. Some of Chris's and Harry's code is probably still lurking in there.
+
+It should be accurate to about 5 to 10 metres.
+
+Silva was written as part of my (MSc Project)[http://rdallsgray.github.com/archie-blog], of which more later.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/silva/version.rb

@@ -0,0 +1,3 @@
+module Silva
+  VERSION = "0.0.1"
+end

data/lib/silva.rb

@@ -0,0 +1,5 @@
+require "silva/version"
+
+module Silva
+  # Your code goes here...
+end

data/silva.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/silva/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Robert Dallas Gray"]
+  gem.email         = ["mail@robertdallasgray.com"]
+  gem.summary         = "Convert between the GPS (WGS84) location standard and UK Ordnance Survey standards."
+  gem.description     = "Silva converts location data to and from WGS84, OSGB36, eastings/northings and standard OS grid references."
+  gem.homepage        = "http://github.com/rdallasgray/silva"
+  gem.license         = "FreeBSD"
+  gem.required_ruby_version      = ">= 1.9"
+  gem.add_development_dependency "test/unit"
+
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "silva"
+  gem.require_paths = ["lib"]
+  gem.version       = Silva::VERSION
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: silva
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Robert Dallas Gray
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: test/unit
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Silva converts location data to and from WGS84, OSGB36, eastings/northings
+  and standard OS grid references.
+email:
+- mail@robertdallasgray.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- lib/silva.rb
+- lib/silva/version.rb
+- silva.gemspec
+homepage: http://github.com/rdallasgray/silva
+licenses:
+- FreeBSD
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Convert between the GPS (WGS84) location standard and UK Ordnance Survey
+  standards.
+test_files: []
+has_rdoc: