global_convert 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YzIwNGU0NDc3YzYwZmI1YzY3MDVhZjIwMDhkYWM0YjRlY2U0YWY2Ng==
+  data.tar.gz: !binary |-
+    Y2UyYmUwY2RhYWY4NmRiYWI1ZjFkMDI2ODgzYjk0ZWNmZGE5Mjg2Mg==
+SHA512:
+  metadata.gz: !binary |-
+    MjRhMzhlMjI0NmI5NDNiYmQ4ZDFkNGZhNDQ0ODBkZWEyNWJjMTI5NWZmMDk0
+    NmMxMzc3NTIzNGVmOTRkNTYxMWFiOWE1ZjAyNjhiMGZlZWJhODY3ZDc0Y2Y4
+    M2MxZGI1NDU1OGMwMTllNTZiZDFlMGFhMjljNzkyOTgwOTJkYzE=
+  data.tar.gz: !binary |-
+    YjEwYTc1NjdkMWJjN2JiMWFjOGU1YTFjYTNjMTYxNzVhN2IyNGE2MDAxZjNi
+    NGYxNmVkODA0MGU4NGVlYzAxYzIyMzM2MGRjZDAyOTgzMzBhNjJhODliMTdi
+    ZmJlMmE3YWJmZjg4ZTgxYjI0NjEyMmIzZmRmYmI0ZTJjMThhZWM=

data/LICENSE

@@ -0,0 +1,24 @@
+Global Convert
+
+Copyright (c) 2014 Rob Nichols
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,47 @@
+= Global Convert
+
+Tool for converting coordinates between different global charting systems.
+
+This tool uses {PROJ.4}[http://trac.osgeo.org/proj/] 
+via the {proj4rb gem}[https://github.com/cfis/proj4rb]
+to convert coordinates between global charting systems with different projections.
+
+Global Convert was greatly influenced by Peter Hick's blog: 
+{Converting OSGB36 (Eastings/Northings) to WGS84 (Longitude/Latitude) in Ruby}[http://blog.poggs.com/index.php/2010/09/converting-osgb36-eastingsnorthings-to-wgs84-longitudelatitude-in-ruby/]
+
+== UK Ordinance Survey National Grid references to Longitude / Latitude
+
+    require 'global_convert'
+
+    easting = 529978
+    northing = 186491
+
+    location = Location.new(
+      input: {
+        projection: :osgb36,
+        lon: easting,
+        lat: northing
+      },
+      output: {
+        projection: :wgs84
+      }
+    )
+
+    puts "Latitude = #{location.lat} in radians."
+    puts "Longitude = #{location.lon} in radians."
+
+== Projections
+
+Projections are defined via /data/projections.yml. This contains a labelled list of
+PROJ.4 projection configurations. To use an alternative set of projections, define
+your own projections using the same format as projections.yml and register that
+with GlobalConvert.
+
+    GlobalConvert.projection_file_path = 'path/to/alternative/projections.yml'
+
+Additional projection configurations can be found at:
+
+* http://spatialreference.org/
+* http://www.remotesensing.org/geotiff/proj_list/
+
+The options are documented on the {PROJ.4 site}[http://trac.osgeo.org/proj/].

data/Rakefile

@@ -0,0 +1,28 @@
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rdoc/task'
+require 'rake/testtask'
+
+task :default => :test
+
+Rake::RDocTask.new do |rdoc|
+  files =['README.rdoc', 'LICENSE', 'lib/**/*.rb']
+  rdoc.rdoc_files.add(files)
+  rdoc.main = "README.rdoc" # page to start on
+  rdoc.title = "Global Convert Docs"
+  rdoc.rdoc_dir = 'doc/rdoc' # rdoc output folder
+  rdoc.options << '--line-numbers'
+end
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/**/*.rb']
+end
+
+task :console do
+  require 'irb'
+  require 'irb/completion'
+  require 'global_convert'
+  ARGV.clear
+  IRB.start
+end

data/lib/global_convert/location.rb

@@ -0,0 +1,37 @@
+module GlobalConvert
+  class Location
+    attr_reader :input_projection_name, :output_projection_name, :input_lon, :input_lat
+
+    def initialize(args = {})
+      @input_projection_name = args[:input][:projection]
+      @output_projection_name = args[:output][:projection]
+      @input_lon = args[:input][:lon]
+      @input_lat = args[:input][:lat]
+    end
+
+    def lat
+      output_point.lat
+    end
+
+    def lon
+      output_point.lon
+    end
+
+    def input_projection
+      @input_projection ||= Projection.new input_projection_name
+    end
+
+    def output_projection
+      @output_projection ||= Projection.new output_projection_name
+    end
+
+    def input_point
+      @point ||= Proj4::Point.new(input_lon, input_lat)
+    end
+
+    def output_point
+      @outpoint_point ||= input_projection.transform(output_projection, input_point)
+    end
+
+  end
+end

data/lib/global_convert/projection.rb

@@ -0,0 +1,16 @@
+require 'yaml'
+
+module GlobalConvert
+  class Projection < Proj4::Projection
+    def initialize(name)
+      raise 'Projection not found' unless settings = projections[name.to_s]
+      super(settings['projection'])
+    end
+
+    private
+    def projections
+      YAML::load_file(GlobalConvert.projection_file_path)
+    end
+
+  end
+end

data/lib/global_convert/version.rb

@@ -0,0 +1,9 @@
+module GlobalConvert
+  VERSION = '0.0.1'
+end
+
+# History
+# =======
+#
+# 0.0.1 - First build
+#

data/lib/global_convert.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+gem 'proj4rb'
+require 'proj4'
+
+require_relative 'global_convert/projection'
+require_relative 'global_convert/location'
+
+module GlobalConvert
+
+  class << self
+    attr_writer :projection_file_path
+
+    def projection_file_path
+      @projection_file_path ||= File.expand_path('../data/projections.yml', File.dirname(__FILE__))
+    end
+  end
+    
+end

data/test/data/projections.yml

@@ -0,0 +1,9 @@
+wgs84:
+  name: WGS84 (Longitude/Latitude)
+  projection: +proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs
+  output_units: radians
+
+osgb36:
+  name: OSGB36 (UK Ordinance Survey Eastings/Northings)
+  projection: +proj=tmerc +lat_0=49 +lon_0=-2 +k=0.9996012717 +x_0=400000 +y_0=-100000 +ellps=airy +datum=OSGB36 +units=m +no_defs
+  output_units: metres

data/test/test_helper.rb

@@ -0,0 +1,8 @@
+$:.unshift File.join(File.dirname(__FILE__),'..','lib')
+
+require 'minitest/autorun'
+require 'global_convert'
+
+GLOBAL_CONTRACT_PROJECTION_PATH = File.join(File.dirname(__FILE__),'data','projections.yml')
+
+GlobalConvert.projection_file_path = GLOBAL_CONTRACT_PROJECTION_PATH

data/test/units/global_convert/location_test.rb

@@ -0,0 +1,45 @@
+require_relative '../../test_helper'
+
+module GlobalConvert
+  class LocationTest < MiniTest::Unit::TestCase
+
+    def test_easting_northing_to_lat_long
+      location = Location.new(
+        input: {
+          projection: :osgb36,
+          lon: easting,
+          lat: northing
+        },
+        output: {
+          projection: :wgs84
+        }
+      )
+      assert_equal dst_point.lat, location.lat
+      assert_equal dst_point.lon, location.lon
+    end
+
+    def long_lat_projection
+      Projection.new :wgs84
+    end
+    
+    def os_projection
+      Projection.new :osgb36
+    end
+
+    def dst_point
+      @dst_point ||= os_projection.transform(long_lat_projection, src_point)
+    end
+    
+    def src_point
+      Proj4::Point.new(easting, northing)
+    end
+
+    def easting
+      529978
+    end
+
+    def northing
+      186491
+    end
+  end
+end

data/test/units/global_convert/projection_test.rb

@@ -0,0 +1,16 @@
+require_relative '../../test_helper'
+
+module GlobalConvert
+  class ProjectionTest < MiniTest::Unit::TestCase
+
+    def test_new
+      assert_equal proj4_projection.to_s, Projection.new(:wgs84).to_s
+    end
+
+
+    def proj4_projection
+      @proj4_projection ||= Proj4::Projection.new('+proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs')
+    end
+
+  end
+end

data/test/units/global_convert_test.rb

@@ -0,0 +1,14 @@
+require_relative '../test_helper'
+
+class GlobalConvertTest < MiniTest::Unit::TestCase
+
+  def teardown
+    GlobalConvert.projection_file_path = GLOBAL_CONTRACT_PROJECTION_PATH
+  end
+
+  def test_projection_file_path
+    path = 'foo/bar'
+    GlobalConvert.projection_file_path = path
+    assert_equal path, GlobalConvert.projection_file_path
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: global_convert
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Rob Nichols
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: proj4rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Simplifies converting from longitudes and latitudes, to eastings and
+  northings.
+email:
+- rob@undervale.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/global_convert/location.rb
+- lib/global_convert/version.rb
+- lib/global_convert/projection.rb
+- lib/global_convert.rb
+- LICENSE
+- Rakefile
+- README.rdoc
+- test/units/global_convert_test.rb
+- test/units/global_convert/projection_test.rb
+- test/units/global_convert/location_test.rb
+- test/data/projections.yml
+- test/test_helper.rb
+homepage: https://github.com/reggieb/global_convert
+licenses:
+- LICENSE
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.10
+signing_key: 
+specification_version: 4
+summary: Tool for converting coordinates between different global charting systems
+test_files:
+- test/units/global_convert_test.rb
+- test/units/global_convert/projection_test.rb
+- test/units/global_convert/location_test.rb
+- test/data/projections.yml
+- test/test_helper.rb