geo_coord 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 7e6b043870b18d1cb3c9ccbf3b7b6270a63e19fc
-  data.tar.gz: c9938260cf2f45f3c255e099891ddcf2ac1747d4
+SHA256:
+  metadata.gz: 36feeb545afb9bf13f5d330302ba226b9c9fc9ce28aa1b223ad0c796ca1e2e37
+  data.tar.gz: 57ea4296740735b6c8606738b38498225130620a43056832ae7ee3a96c8b3b2a
 SHA512:
-  metadata.gz: 482499de585615150a74734bf23c72936bc7bd10c7b14447f7c251f7d7c79c4fa573b232d25e5d7de6468b2da0e2a11890ff36f7466ef8edb4385cffe44b6ebc
-  data.tar.gz: 6d7f5c2a3c52ed6315922edfe8ca7cd2b682e8c51b4a6c9dde7d46b7ec0af77168f3d95f9abc2623aac8a20d16759b128f9065b5506c0402501ddb4b7681efd0
+  metadata.gz: 45c9aa30f9d38d1ea2d96cd89fefe0f09ff77a1d18d515402ba6ccb2d37b92a5b8d3ef1903c619cc8c655f4787750db1dae1f457330ac58d2c84ec086ed8962b
+  data.tar.gz: 77ffed86527f6752f4885c0e22173aa84214c8074a7793fc0026ce8d7c78ee43bc3c6d6e1b62a43d77de03619dcc097dde576531c176d149e115b0bf235532f3

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Geo::Coord changelog
+
+## 0.1.0 - Feb 3, 2018
+
+* Switch to `BigDecimal` for internal values storage;
+* More friendly `#inspect` & `#to_s` format;
+* Rename `#to_a` to `#latlng` & `#lnglat`;
+* Fix `#lats` formula bug.
+
+## 0.0.1 - Jun 06, 2016
+
+Initial release as a gem.

data/README.md

@@ -40,74 +40,29 @@ I still have a small hope it would be part of stdlib once, that's why I
 preserve the style of specs (outdated rspec, but compatible with mspec used
 for standard library) and docs (yard in RDoc-compatibility mode).
 
-## Design decisions
-
-While designing `Geo` library, my reference point was standard `Time`
-class (and, to lesser extent, `Date`/`DateTime`). It has these
-responsibilities:
-* stores data in simple internal form;
-* helps to parse and format data to and from strings;
-* provides easy access to logical components of data;
-* allows most simple and unambiguous calculations.
-
-**Namespace name**: The gem takes pretty short and generic top-level
-namespace name `Geo`, but creates only one class inside it: `Geo::Coord`.
-
-**Main type name**: as far as I can see, there's no good singular name
-for `(lat, lng)` pair concept. In different libraries, there can be seen
-names like `LatLng`, or `Location`, or `Point`; and in natural language
-just "coordinates" used frequently. I propose the name `Coord`, which
-is pretty short, easy to remember, demonstrates intentions (and looks
-like singular, so you can have "one coord object" and "array of coords",
-which is not 100% linguistically correct, yet convenient). Alternative
-`Point` name seems to be too ambiguous, being used in many contexts.
-
-`Geo::Coord` object is **immutable**, there's no semantical sense in
-`location.latitude = ...` or something like this.
-
-**Units**: `Geo` calculations (just like `Time` calculations) provide
-no units options, just returning numbers measured in "default" units:
-metres for distances (as they are SI unit) and degrees for azimuth.
-Latitude and longitude are stored in degrees, but radians values accessors
-are provided (being widely used in geodesy math).
-
-All coordinates and calculations are thought to be in
-[WGS 84](https://en.wikipedia.org/wiki/World_Geodetic_System#A_new_World_Geodetic_System:_WGS_84)
-coordinates reference system, being current standard for maps and GPS.
-
-There's introduced **a concept of globe** used internally for calculations.
-Only generic (sphere) and Earth globes are implemented, but for 2016 I
-feel like the current design of basic types should take in consideration
-possibility of writing Ruby scripts for Mars maps analysis. Only one
-geodesy formula is implemented (Vincenty, generally considered one of
-the most precise), as for standard library class it considered
-unnecessary to provide a user with geodesy formulae options.
-
-No **map projection** math was added into the current gem, but it
-may be a good direction for further work. No **elevation** data considered
-either.
-
 ## Installation
 
 Now when it is a gem, just do your usual `gem install geo_coord` or add
-`gem "geo_coord"` to your Gemfile.
+`gem "geo_coord", require: "geo/coord"` to your Gemfile.
 
 ## Usage
 
 ### Creation
 
 ```ruby
+require 'geo/coord'
+
 # From lat/lng pair:
 g = Geo::Coord.new(50.004444, 36.231389)
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 
 # Or using keyword arguments form:
 g = Geo::Coord.new(lat: 50.004444, lng: 36.231389)
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 
 # Keyword arguments also allow creation of Coord from components:
 g = Geo::Coord.new(latd: 50, latm: 0, lats: 16, lath: 'N', lngd: 36, lngm: 13, lngs: 53, lngh: 'E')
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 ```
 
 For parsing API responses you'd like to use `from_h`,
@@ -116,7 +71,7 @@ and knows synonyms (lng/lon/longitude):
 
 ```ruby
 g = Geo::Coord.from_h('LAT' => 50.004444, 'LON' => 36.231389)
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 ```
 
 For math, you'd probably like to be able to initialize
@@ -124,7 +79,7 @@ Coord with radians rather than degrees:
 
 ```ruby
 g = Geo::Coord.from_rad(0.8727421884291233, 0.6323570306208558)
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 ```
 
 There's also family of string parsing methods, with different
@@ -133,21 +88,21 @@ applicability:
 ```ruby
 # Tries to parse (lat, lng) pair:
 g = Geo::Coord.parse_ll('50.004444, 36.231389')
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 
 # Tries to parse degrees/minutes/seconds:
 g = Geo::Coord.parse_dms('50° 0′ 16″ N, 36° 13′ 53″ E')
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 
 # Tries to do best guess:
 g = Geo::Coord.parse('50.004444, 36.231389')
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 g = Geo::Coord.parse('50° 0′ 16″ N, 36° 13′ 53″ E')
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 
 # Allows user to provide pattern:
 g = Geo::Coord.strpcoord('50.004444, 36.231389', '%lat, %lng')
-# => #<Geo::Coord 50.004444,36.231389>
+# => #<Geo::Coord 50°0'16"N 36°13'53"E>
 ```
 
 [Pattern language description](http://www.rubydoc.info/gems/geo_coord/Geo/Coord#strpcoord-class_method)
@@ -170,7 +125,8 @@ g.latdms # => [50, 0, 15.998400000011316, "N"]
 ### Formatting and converting
 
 ```ruby
-g.to_s # => "50.004444,36.231389"
+g.to_s              # => "50°0'16\"N 36°13'53\"E"
+g.to_s(dms: false)  # => "50.004444,36.231389"
 g.strfcoord('%latd°%latm′%lats″%lath %lngd°%lngm′%lngs″%lngh')
 # => "50°0′16″N 36°13′53″E"
 
@@ -185,11 +141,72 @@ kyiv = Geo::Coord.new(50.45, 30.523333)
 
 kharkiv.distance(kyiv) # => 410211.22377421556
 kharkiv.azimuth(kyiv) # => 279.12614358262067
-kharkiv.endpoint(410_211, 280) # => #<Geo::Coord 50.505975,30.531283>
+kharkiv.endpoint(410_211, 280) # => #<Geo::Coord 50°30'22"N 30°31'53"E>
 ```
 
 [Full API Docs](http://www.rubydoc.info/gems/geo_coord)
 
+## Design decisions
+
+While designing `Geo` library, my reference point was standard `Time`
+class (and, to lesser extent, `Date`/`DateTime`). It has these
+responsibilities:
+
+* stores data in simple internal form;
+* helps to parse and format data to and from strings;
+* provides easy access to logical components of data;
+* allows most simple and unambiguous calculations.
+
+**Namespace name**: The gem takes pretty short and generic top-level
+namespace name `Geo`, but creates only one class inside it: `Geo::Coord`.
+
+**Main type name**: as far as I can see, there's no good singular name
+for `(lat, lng)` pair concept. In different libraries, there can be seen
+names like `LatLng`, or `Location`, or `Point`; and in natural language
+just "coordinates" used frequently. I propose the name `Coord`, which
+is pretty short, easy to remember, demonstrates intentions (and looks
+like singular, so you can have "one coord object" and "array of coords",
+which is not 100% linguistically correct, yet convenient). Alternative
+`Point` name seems to be too ambiguous, being used in many contexts.
+
+`Geo::Coord` object is **immutable**, there's no semantical sense in
+`location.latitude = ...` or something like this.
+
+**Units**: `Geo` calculations (just like `Time` calculations) provide
+no units options, just returning numbers measured in "default" units:
+metres for distances (as they are SI unit) and degrees for azimuth.
+Latitude and longitude are stored in degrees, but radians values accessors
+are provided (being widely used in geodesy math).
+
+**Internal storage**: Since ver 0.0.2, latitude and longitude stored
+internally as an instances of `BigDecimal`. While having some memory
+and performance downsides, this datatype provides _correctness_ of
+conversions between floating point & deg-min-sec representations:
+
+```ruby
+# 33.3 should be 33°18'00"
+# Float:
+33.3 * 60 % 60 # => 17.999999999999773 minutes
+# BigDecimal
+BigDecimal(33.3, 10) * 60 % 60 # => 0.18e2
+```
+
+All coordinates and calculations are thought to be in
+[WGS 84](https://en.wikipedia.org/wiki/World_Geodetic_System#A_new_World_Geodetic_System:_WGS_84)
+coordinates reference system, being current standard for maps and GPS.
+
+There's introduced **a concept of globe** used internally for calculations.
+Only generic (sphere) and Earth globes are implemented, but for 2010th I
+feel like the current design of basic types should take in consideration
+possibility of writing Ruby scripts for Mars maps analysis. Only one
+geodesy formula is implemented (Vincenty, generally considered one of
+the most precise), as for standard library class it considered
+unnecessary to provide a user with geodesy formulae options.
+
+No **map projection** math was added into the current gem, but it
+may be a good direction for further work. No **elevation** data considered
+either.
+
 ## Author
 
 [Victor Shepelev](https://zverok.github.io)

data/geo_coord.gemspec

@@ -8,22 +8,17 @@ Gem::Specification.new do |s|
   s.homepage = 'https://github.com/zverok/geo_coord'
 
   s.summary = 'Geo::Coord class'
-  s.description = <<-EOF
-  EOF
+  s.description = <<-DESC
+  DESC
   s.licenses = ['MIT']
 
   s.files = `git ls-files`.split($RS).reject do |file|
-    file =~ /^(?:
-    spec\/.*
-    |Gemfile
-    |Rakefile
-    |\.rspec
-    |\.gitignore
-    |\.rubocop.yml
+    file =~ %r{^(?: spec\/.* |Gemfile |Rakefile
+    |\.rspec |\.gitignore |\.rubocop.yml
     |\.travis.yml
-    )$/x
+    )$}x
   end
-  s.require_paths = ["lib"]
+  s.require_paths = ['lib']
 
   s.required_ruby_version = '>= 2.1.0'
 
@@ -35,4 +30,5 @@ Gem::Specification.new do |s|
   s.add_development_dependency 'rubygems-tasks'
   s.add_development_dependency 'yard'
   s.add_development_dependency 'coveralls'
+  s.add_development_dependency 'dokaz'
 end

data/lib/geo/coord.rb

@@ -1,3 +1,5 @@
+require 'bigdecimal'
+
 # Geo::Coord is Ruby's library for handling [lat, lng] pairs of
 # geographical coordinates. It provides most of basic functionality
 # you may expect (storing and representing coordinate pair), as well
@@ -19,48 +21,48 @@ module Geo
   #
   #    # From lat/lng pair:
   #    g = Geo::Coord.new(50.004444, 36.231389)
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #
   #    # Or using keyword arguments form:
   #    g = Geo::Coord.new(lat: 50.004444, lng: 36.231389)
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #
   #    # Keyword arguments also allow creation of Coord from components:
   #    g = Geo::Coord.new(latd: 50, latm: 0, lats: 16, lath: 'N', lngd: 36, lngm: 13, lngs: 53, lngh: 'E')
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #
   # For parsing API responses you'd like to use +from_h+,
   # which accepts String and Symbol keys, any letter case,
   # and knows synonyms (lng/lon/longitude):
   #
   #    g = Geo::Coord.from_h('LAT' => 50.004444, 'LON' => 36.231389)
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #
   # For math, you'd probably like to be able to initialize
   # Coord with radians rather than degrees:
   #
   #    g = Geo::Coord.from_rad(0.8727421884291233, 0.6323570306208558)
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #
   # There's also family of parsing methods, with different applicability:
   #
   #    # Tries to parse (lat, lng) pair:
   #    g = Geo::Coord.parse_ll('50.004444, 36.231389')
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #
   #    # Tries to parse degrees/minutes/seconds:
   #    g = Geo::Coord.parse_dms('50° 0′ 16″ N, 36° 13′ 53″ E')
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #
   #    # Tries to do best guess:
   #    g = Geo::Coord.parse('50.004444, 36.231389')
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #    g = Geo::Coord.parse('50° 0′ 16″ N, 36° 13′ 53″ E')
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #
-  #    # Allows user to provide pattern (see below for pattern language):
+  #    # Allows user to provide pattern:
   #    g = Geo::Coord.strpcoord('50.004444, 36.231389', '%lat, %lng')
-  #    # => #<Geo::Coord 50.004444,36.231389>
+  #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
   #
   # Having Coord object, you can get its properties:
   #
@@ -117,7 +119,7 @@ module Geo
       #   and longitude ("lng", "lon", "long", "longitude").
       #
       #    g = Geo::Coord.from_h('LAT' => 50.004444, longitude: 36.231389)
-      #    # => #<Geo::Coord 50.004444,36.231389>
+      #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
       #
       def from_h(hash)
         h = hash.map { |k, v| [k.to_s.downcase.to_sym, v] }.to_h
@@ -132,7 +134,7 @@ module Geo
       # Creates Coord from φ and λ (latitude and longitude in radians).
       #
       #    g = Geo::Coord.from_rad(0.8727421884291233, 0.6323570306208558)
-      #    # => #<Geo::Coord 50.004444,36.231389>
+      #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
       #
       def from_rad(phi, la)
         new(phi * 180 / Math::PI, la * 180 / Math::PI)
@@ -150,7 +152,7 @@ module Geo
       # @private
       DEG_PATTERN = '[ °d]'.freeze # :nodoc:
       # @private
-      MIN_PATTERN = "['′m]".freeze # :nodoc:
+      MIN_PATTERN = "['′’m]".freeze # :nodoc:
       # @private
       SEC_PATTERN = '["″s]'.freeze # :nodoc:
 
@@ -158,24 +160,31 @@ module Geo
       LL_PATTERN = /^(#{FLOAT_PATTERN})\s*[,; ]\s*(#{FLOAT_PATTERN})$/ # :nodoc:
 
       # @private
-      DMS_PATTERN = # :nodoc:
-        /^\s*
-          (?<latd>#{INT_PATTERN})#{DEG_PATTERN}\s*
-          ((?<latm>#{UINT_PATTERN})#{MIN_PATTERN}\s*
-          ((?<lats>#{UFLOAT_PATTERN})#{SEC_PATTERN}\s*)?)?
-          (?<lath>[NS])?
-          \s*[,; ]\s*
-          (?<lngd>#{INT_PATTERN})#{DEG_PATTERN}\s*
-          ((?<lngm>#{UINT_PATTERN})#{MIN_PATTERN}\s*
-          ((?<lngs>#{UFLOAT_PATTERN})#{SEC_PATTERN}\s*)?)?
-          (?<lngh>[EW])?
-          \s*$/x
+      DMS_LATD_P = "(?<latd>#{INT_PATTERN})#{DEG_PATTERN}".freeze # :nodoc:
+      # @private
+      DMS_LATM_P = "(?<latm>#{UINT_PATTERN})#{MIN_PATTERN}".freeze # :nodoc:
+      # @private
+      DMS_LATS_P = "(?<lats>#{UFLOAT_PATTERN})#{SEC_PATTERN}".freeze # :nodoc:
+      # @private
+      DMS_LAT_P = "#{DMS_LATD_P}\\s*#{DMS_LATM_P}\\s*#{DMS_LATS_P}\\s*(?<lath>[NS])".freeze # :nodoc:
+
+      # @private
+      DMS_LNGD_P = "(?<lngd>#{INT_PATTERN})#{DEG_PATTERN}".freeze # :nodoc:
+      # @private
+      DMS_LNGM_P = "(?<lngm>#{UINT_PATTERN})#{MIN_PATTERN}".freeze # :nodoc:
+      # @private
+      DMS_LNGS_P = "(?<lngs>#{UFLOAT_PATTERN})#{SEC_PATTERN}".freeze # :nodoc:
+      # @private
+      DMS_LNG_P = "#{DMS_LNGD_P}\\s*#{DMS_LNGM_P}\\s*#{DMS_LNGS_P}\\s*(?<lngh>[EW])".freeze # :nodoc:
+
+      # @private
+      DMS_PATTERN = /^\s*#{DMS_LAT_P}\s*[,; ]\s*#{DMS_LNG_P}\s*$/x # :nodoc:
 
       # Parses Coord from string containing float latitude and longitude.
       # Understands several types of separators/spaces between values.
       #
       #    Geo::Coord.parse_ll('-50.004444 +36.231389')
-      #    # => #<Geo::Coord -50.004444,36.231389>
+      #    # => #<Geo::Coord 50°0'16"S 36°13'53"E>
       #
       # If parse_ll is not wise enough to understand your data, consider
       # using ::strpcoord.
@@ -193,7 +202,7 @@ module Geo
       # explicit hemisphere and no-hemisphere (signed degrees) formats.
       #
       #    Geo::Coord.parse_dms('50°0′16″N 36°13′53″E')
-      #    # => #<Geo::Coord 50.004444,36.231389>
+      #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
       #
       # If parse_dms is not wise enough to understand your data, consider
       # using ::strpcoord.
@@ -212,9 +221,9 @@ module Geo
       # known form).
       #
       #    Geo::Coord.parse('-50.004444 +36.231389')
-      #    # => #<Geo::Coord -50.004444,36.231389>
+      #    # => #<Geo::Coord 50°0'16"S 36°13'53"E>
       #    Geo::Coord.parse('50°0′16″N 36°13′53″E')
-      #    # => #<Geo::Coord 50.004444,36.231389>
+      #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
       #
       # If you know exact form in which coordinates are
       # provided, it may be wider to consider parse_ll, parse_dms or
@@ -268,12 +277,9 @@ module Geo
         pattern = PARSE_PATTERNS.inject(pattern) do |memo, (pfrom, pto)|
           memo.gsub(pfrom, pto)
         end
-        if (m = Regexp.new('^' + pattern).match(str))
-          h = m.names.map { |n| [n.to_sym, _extract_match(m, n)] }.to_h
-          new(h)
-        else
-          raise ArgumentError, "Coordinates str #{str} can't be parsed by pattern #{pattern}"
-        end
+        match = Regexp.new('^' + pattern).match(str)
+        raise ArgumentError, "Coordinates str #{str} can't be parsed by pattern #{pattern}" unless match
+        new(match.names.map { |n| [n.to_sym, _extract_match(match, n)] }.to_h)
       end
 
       private
@@ -299,19 +305,19 @@ module Geo
     # key +lat+ and partial longitude keys +lngd+, +lngm+ and so on.
     #
     #    g = Geo::Coord.new(50.004444, 36.231389)
-    #    # => #<Geo::Coord 50.004444,36.231389>
+    #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
     #
     #    # Or using keyword arguments form:
     #    g = Geo::Coord.new(lat: 50.004444, lng: 36.231389)
-    #    # => #<Geo::Coord 50.004444,36.231389>
+    #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
     #
     #    # Keyword arguments also allow creation of Coord from components:
     #    g = Geo::Coord.new(latd: 50, latm: 0, lats: 16, lath: 'N', lngd: 36, lngm: 13, lngs: 53, lngh: 'E')
-    #    # => #<Geo::Coord 50.004444,36.231389>
+    #    # => #<Geo::Coord 50°0'16"N 36°13'53"E>
     #
     #    # Providing defaults:
     #    g = Geo::Coord.new(lat: 50.004444)
-    #    # => #<Geo::Coord 50.004444,0.000000>
+    #    # => #<Geo::Coord 50°0'16"N 0°0'0"W>
     #
     def initialize(lat = nil, lng = nil, **opts)
       @globe = Globes::Earth.instance
@@ -352,7 +358,7 @@ module Geo
 
     # Returns latitude seconds (unsigned float).
     def lats
-      (lat.abs * 3600) % 3600
+      (lat.abs * 3600) % 60
     end
 
     # Returns latitude hemisphere (upcase letter 'N' or 'S').
@@ -386,14 +392,14 @@ module Geo
     #    # Nothern hemisphere:
     #    g = Geo::Coord.new(50.004444, 36.231389)
     #
-    #    g.latdms        # => [50, 0, 15.998400000011316, "N"]
-    #    g.latdms(true)  # => [50, 0, 15.998400000011316]
+    #    g.latdms        # => [50, 0, 15.9984, "N"]
+    #    g.latdms(true)  # => [50, 0, 15.9984]
     #
     #    # Southern hemisphere:
     #    g = Geo::Coord.new(-50.004444, 36.231389)
     #
-    #    g.latdms        # => [50, 0, 15.998400000011316, "S"]
-    #    g.latdms(true)  # => [-50, 0, 15.998400000011316]
+    #    g.latdms        # => [50, 0, 15.9984, "S"]
+    #    g.latdms(true)  # => [-50, 0, 15.9984]
     #
     def latdms(nohemisphere = false)
       nohemisphere ? [latsign * latd, latm, lats] : [latd, latm, lats, lath]
@@ -405,14 +411,14 @@ module Geo
     #    # Eastern hemisphere:
     #    g = Geo::Coord.new(50.004444, 36.231389)
     #
-    #    g.lngdms        # => [36, 13, 53.00040000000445, "E"]
-    #    g.lngdms(true)  # => [36, 13, 53.00040000000445]
+    #    g.lngdms        # => [36, 13, 53.0004, "E"]
+    #    g.lngdms(true)  # => [36, 13, 53.0004]
     #
     #    # Western hemisphere:
     #    g = Geo::Coord.new(50.004444, 36.231389)
     #
-    #    g.lngdms        # => [36, 13, 53.00040000000445, "E"]
-    #    g.lngdms(true)  # => [-36, 13, 53.00040000000445]
+    #    g.lngdms        # => [36, 13, 53.0004, "E"]
+    #    g.lngdms(true)  # => [-36, 13, 53.0004]
     #
     def lngdms(nohemisphere = false)
       nohemisphere ? [lngsign * lngd, lngm, lngs] : [lngd, lngm, lngs, lngh]
@@ -440,25 +446,35 @@ module Geo
     #    g.inspect  # => "#<Geo::Coord 50.004444,36.231389>"
     #
     def inspect
-      '#<%s %s>' % [self.class.name, to_s]
+      strfcoord(%{#<#{self.class.name} %latd°%latm'%lats"%lath %lngd°%lngm'%lngs"%lngh>})
     end
 
     # Returns a string representing coordinates.
     #
-    #    g.to_s   # => "50.004444,36.231389"
+    #    g.to_s              # => "50°0'16\"N 36°13'53\"E"
+    #    g.to_s(dms: false)  # => "50.004444,36.231389"
     #
-    def to_s
-      '%f,%f' % [lat, lng]
+    def to_s(dms: true)
+      format = dms ? %{%latd°%latm'%lats"%lath %lngd°%lngm'%lngs"%lngh} : '%lat,%lng'
+      strfcoord(format)
     end
 
     # Returns a two-element array of latitude and longitude.
     #
-    #    g.to_a   # => [50.004444, 36.231389]
+    #    g.latlng   # => [50.004444, 36.231389]
     #
-    def to_a
+    def latlng
       [lat, lng]
     end
 
+    # Returns a two-element array of longitude and latitude (reverse order to +latlng+).
+    #
+    #    g.lnglat   # => [36.231389, 50.004444]
+    #
+    def lnglat
+      [lng, lat]
+    end
+
     # Returns hash of latitude and longitude. You can provide your keys
     # if you want:
     #
@@ -480,17 +496,17 @@ module Geo
 
     # @private
     DIRECTIVES = { # :nodoc:
+      /%(#{FLOATUFLAGS})?lats/ => proc { |m| "%<lats>#{m[1] || '.0'}f" },
+      '%latm' => '%<latm>i',
       /%(#{INTFLAGS})?latds/ => proc { |m| "%<latds>#{m[1]}i" },
       '%latd' => '%<latd>i',
-      '%latm' => '%<latm>i',
-      /%(#{FLOATUFLAGS})?lats/ => proc { |m| "%<lats>#{m[1] || '.0'}f" },
       '%lath' => '%<lath>s',
       /%(#{FLOATFLAGS})?lat/ => proc { |m| "%<lat>#{m[1]}f" },
 
+      /%(#{FLOATUFLAGS})?lngs/ => proc { |m| "%<lngs>#{m[1] || '.0'}f" },
+      '%lngm' => '%<lngm>i',
       /%(#{INTFLAGS})?lngds/ => proc { |m| "%<lngds>#{m[1]}i" },
       '%lngd' => '%<lngd>i',
-      '%lngm' => '%<lngm>i',
-      /%(#{FLOATUFLAGS})?lngs/ => proc { |m| "%<lngs>#{m[1] || '.0'}f" },
       '%lngh' => '%<lngh>s',
       /%(#{FLOATFLAGS})?lng/ => proc { |m| "%<lng>#{m[1]}f" }
     }.freeze
@@ -529,13 +545,23 @@ module Geo
     #    g.strfcoord("%latd°%latm'%lath -- %lngd°%lngm'%lngh")
     #    # => "50°0'N -- 36°13'E"
     #
+    # +strfcoord+ handles seconds rounding implicitly:
+    #
+    #    pos = Geo::Coord.new(0.033333, 91.333333)
+    #    pos.lats # => 0.599988e2
+    #    pos.strfcoord('%latd %latm %.05lats') # => "0 1 59.99880"
+    #    pos.strfcoord('%latd %latm %lats')  # => "0 2 0"
+    #
     def strfcoord(formatstr)
       h = full_hash
 
       DIRECTIVES.reduce(formatstr) do |memo, (from, to)|
         memo.gsub(from) do
           to = to.call(Regexp.last_match) if to.is_a?(Proc)
-          to % h
+          res = to % h
+          res, carrymin = guard_seconds(to, res)
+          h[carrymin] += 1 if carrymin
+          res
         end
       end
     end
@@ -570,7 +596,7 @@ module Geo
     #
     #    kharkiv = Geo::Coord.new(50.004444, 36.231389)
     #    kharkiv.endpoint(410_211, 280)
-    #    # => #<Geo::Coord 50.505975,30.531283>
+    #    # => #<Geo::Coord 50°30'22"N 30°31'53"E>
     #
     def endpoint(distance, azimuth)
       phi2, la2 = @globe.direct(phi, la, distance, deg2rad(azimuth))
@@ -579,17 +605,15 @@ module Geo
 
     private
 
-    def _init(lat, lng)
-      lat = lat.to_f
-      lng = lng.to_f
+    LAT_RANGE_ERROR = 'Expected latitude to be between -90 and 90, %p received'.freeze
+    LNG_RANGE_ERROR = 'Expected longitude to be between -180 and 180, %p received'.freeze
 
-      unless (-90..90).cover?(lat)
-        raise ArgumentError, "Expected latitude to be between -90 and 90, #{lat} received"
-      end
+    def _init(lat, lng)
+      lat = BigDecimal(lat.to_f, 10)
+      lng = BigDecimal(lng.to_f, 10)
 
-      unless (-180..180).cover?(lng)
-        raise ArgumentError, "Expected longitude to be between -180 and 180, #{lng} received"
-      end
+      raise ArgumentError, LAT_RANGE_ERROR % lat unless (-90..90).cover?(lat)
+      raise ArgumentError, LNG_RANGE_ERROR % lng unless (-180..180).cover?(lng)
 
       @lat = lat
       @lng = lng
@@ -620,6 +644,13 @@ module Geo
         raise ArgumentError, "Unidentified hemisphere: #{h}"
     end
 
+    def guard_seconds(pattern, result)
+      m = pattern.match(/<(lat|lng)s>/)
+      return result unless m && result.start_with?('60')
+      carry = "#{m[1]}m".to_sym
+      [pattern % {lats: 0, lngs: 0}, carry]
+    end
+
     def latsign
       lat <=> 0
     end

data/lib/geo/coord/version.rb

@@ -1,5 +1,5 @@
 module Geo
   class Coord
-    VERSION = '0.0.1'.freeze
+    VERSION = '0.1.0'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: geo_coord
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Victor Shepelev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-06-06 00:00:00.000000000 Z
+date: 2018-02-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rubocop
@@ -122,6 +122,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: dokaz
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: ''
 email: zverok.offline@gmail.com
 executables: []
@@ -129,6 +143,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".yardopts"
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 - StdlibProposal.md
@@ -156,7 +171,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.8
+rubygems_version: 2.7.4
 signing_key: 
 specification_version: 4
 summary: Geo::Coord class