haversine_distance 0.9.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

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

data/README

@@ -0,0 +1,57 @@
+Haversine is a formula to calculate the great-circle distance between two points
+================================================================================
+
+Haversine is Ruby library for haversine a formula to calculate distance between
+two GEO Location. Because Earth is not flat!
+
+References
+-------------------------------------------------------
+Inspired by Landon Cox at http://www.esawdust.com/blog/gps/files/HaversineFormulaInRuby.html
+And http://www.movable-type.co.uk/scripts/latlong.html
+
+You can totally install it as a Gem
+-----------------------------------
+
+Haversine is readily available as a Ruby gem.
+
+    $ [sudo] gem install haversine
+
+The Haversine source is available at GitHub:
+
+    $ git clone git://github.com/jirapong/haversine.git
+
+Feedback & Patch are welcome.
+
+And how to use
+------------------------------------
+    require 'haversine'
+
+    lat_a = 51.885
+    lng_a = 0.235
+
+    lat_b = 49.008
+    lng_b = 2.549
+
+    km = Haversine.distance(lat_a, lng_a, lat_b, lng_b);
+
+Credits
+-------------------------------------------------------
+This library is written by Jirapong Nanta (@jirapong)
+
+Boring legal stuff
+------------------
+
+Copyright (c) 2011, Jirapong Nanta
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

data/README.markdown

@@ -0,0 +1,57 @@
+Haversine is a formula to calculate the great-circle distance between two points
+================================================================================
+
+Haversine is Ruby library for haversine a formula to calculate distance between
+two GEO Location. Because Earth is not flat!
+
+References
+-------------------------------------------------------
+Inspired by Landon Cox at http://www.esawdust.com/blog/gps/files/HaversineFormulaInRuby.html
+And http://www.movable-type.co.uk/scripts/latlong.html
+
+You can totally install it as a Gem
+-----------------------------------
+
+Haversine is readily available as a Ruby gem.
+
+    $ [sudo] gem install haversine
+
+The Haversine source is available at GitHub:
+
+    $ git clone git://github.com/jirapong/haversine.git
+
+Feedback & Patch are welcome.
+
+And how to use
+------------------------------------
+    require 'haversine'
+
+    lat_a = 51.885
+    lng_a = 0.235
+
+    lat_b = 49.008
+    lng_b = 2.549
+
+    km = Haversine.distance(lat_a, lng_a, lat_b, lng_b);
+
+Credits
+-------------------------------------------------------
+This library is written by Jirapong Nanta (@jirapong)
+
+Boring legal stuff
+------------------
+
+Copyright (c) 2011, Jirapong Nanta
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+    t.libs << 'test'
+end
+
+desc "Run tests"
+task :default => :test

data/haversine.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "haversine/version"
+
+Gem::Specification.new do |s|
+  s.name        = "haversine_distance"
+  s.version     = Haversine::VERSION
+  s.authors     = ["Jirapong Nanta"]
+  s.email       = ["jirapong.nanta@gmail.com"]
+  s.homepage    = "https://github.com/Jirapong/Haversine"
+  s.summary     = "Haversine is a formula to calculate the great-circle distance between two points"
+  s.description = "Because Earth is not flat!"
+
+  s.rubyforge_project = "haversine"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/haversine.rb

@@ -0,0 +1,60 @@
+# Copyright (C) 2011, Jirapong Nanta
+# http://bananacoding.com
+
+
+require "haversine/version"
+
+class Float
+  RADIAN_PER_DEGREE = Math::PI / 180.0
+
+  def toRad
+    return self * RADIAN_PER_DEGREE
+  end
+end
+
+module Haversine
+  EARTH_RADIUS_MI = 3963.19
+  EARTH_RADIUS_KM = 6371.00
+
+  #  Calculate the great-circle distance between two points in kilometers (km.)
+  #
+  #  Example:
+  #  >> Haversine.distance(51.885, 0.235, 49.008, 2.549)
+  #  => 359.3823602146921
+  #
+  #  Arguments:
+  #   lat_a: (Float)
+  #   lng_a: (Float)
+  #   lat_b: (Float)
+  #   lng_b: (Float)
+  def self.distance(lat_a, lng_a, lat_b, lng_b)
+    return self.distance_in_radius(lat_a, lng_a, lat_b, lng_b) * EARTH_RADIUS_KM
+  end
+
+  #  Calculate the great-circle distance between two points in miles (mi.)
+  #
+  #  Example:
+  #  >> Haversine.distance_in_mile(51.885, 0.235, 49.008, 2.549)
+  #  => 223.5599711472713
+  #
+  #  Arguments:
+  #   lat_a: (Float)
+  #   lng_a: (Float)
+  #   lat_b: (Float)
+  #   lng_b: (Float)
+  def self.distance_in_mile(lat_a, lng_a, lat_b, lng_b)
+    return self.distance_in_radius(lat_a, lng_a, lat_b, lng_b) * EARTH_RADIUS_MI
+  end
+
+private
+
+  def self.distance_in_radius(lat_a, lng_a, lat_b, lng_b)
+    d_lat = (lat_a - lat_b).toRad;
+    d_lng = (lng_a - lng_b).toRad;
+
+    a = Math.sin(d_lat/2)**2 + Math.cos(lat_a.toRad) * Math.cos(lat_b.toRad) * Math.sin(d_lng/2) ** 2
+    c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1-a))
+
+    return c
+  end
+end

data/lib/haversine/version.rb

@@ -0,0 +1,3 @@
+module Haversine
+  VERSION = "0.9.0"
+end

data/test/test_haversine.rb

@@ -0,0 +1,29 @@
+require "test/unit"
+require "haversine"
+# testing against with http://www.movable-type.co.uk/scripts/latlong.html
+
+class HaversineTest < Test::Unit::TestCase
+
+  def test_distance_in_km
+    lat_a = 51.885
+    lng_a = 0.235
+
+    lat_b = 49.008
+    lng_b = 2.549
+
+    km = Haversine.distance(lat_a, lng_a, lat_b, lng_b);
+    assert_equal(359.3823602146921, km);
+  end
+
+  def test_distance_in_mi
+    lat_a = 51.885
+    lng_a = 0.235
+
+    lat_b = 49.008
+    lng_b = 2.549
+
+    mi = Haversine.distance_in_mile(lat_a, lng_a, lat_b, lng_b);
+    assert_equal(223.5599711472713, mi);
+  end
+
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: haversine_distance
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+  prerelease: 
+platform: ruby
+authors:
+- Jirapong Nanta
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-03 00:00:00.000000000 Z
+dependencies: []
+description: Because Earth is not flat!
+email:
+- jirapong.nanta@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README
+- README.markdown
+- Rakefile
+- haversine.gemspec
+- lib/haversine.rb
+- lib/haversine/version.rb
+- test/test_haversine.rb
+homepage: https://github.com/Jirapong/Haversine
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: haversine
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Haversine is a formula to calculate the great-circle distance between two
+  points
+test_files:
+- test/test_haversine.rb