geospatial 1.3.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 11b074e2d3cdfac7ba59e1a7a2577c02824130aa
-  data.tar.gz: e72051ddbdfdac6aff2e38da188662ccf975118b
+  metadata.gz: af57f14cdc085ce808e8462af23af0e269797b86
+  data.tar.gz: f7bc6d182e0b5366a6ada00112c555a35576977b
 SHA512:
-  metadata.gz: 80d7551c77bd067e796b44cce6cfb6e3fc7ae56eee263aff1f11ea09ff76d6e60763181bd9796032154be6e863d3c90d5d474902f2b9b532b5b4acd726723852
-  data.tar.gz: 2a3b2f858503eb5697e6f3d4576ed273a3d1f493205be97446c20fca8770fe1bb26a0229ff9e118a5b00dc00fd3d511ff171428130d3addf6e1bf66cea0ccb3b
+  metadata.gz: 20a32b175c72f9989a8ffe6f29fa06637af22fda65d8d61c240d25c701268468248e4e52bc719b33e9f1c3396702fac0c49924e4878fae2d8ff07af8a4564251
+  data.tar.gz: 471174aee8a1270436599bdfed01d623ff9a3d34dbce7b7221d63b9e266fbfdc5e4da8bd0ca990342a010b68281b7a3fddbd6f5fbfad33757de2ed05fa155c87

data/README.md

@@ -34,26 +34,42 @@ Or install it yourself as:
 
 The simplest way to use this library is to use the built in `Map`:
 
-	map = Geospatial::Map.new
-	map << Geospatial::Location.new(170.53, -43.89) # Lake Tekapo, New Zealand.
-	map << Geospatial::Location.new(170.45, -43.94) # Lake Alex, New Zealand.
-	map << Geospatial::Location.new(151.21, -33.85) # Sydney, Australia.
+```ruby
+map = Geospatial::Map.new
+map << Geospatial::Location.new(170.53, -43.89) # Lake Tekapo, New Zealand.
+map << Geospatial::Location.new(170.45, -43.94) # Lake Alex, New Zealand.
+map << Geospatial::Location.new(151.21, -33.85) # Sydney, Australia.
 
-	map.sort! # or assume an ordered database index.
+map.sort! # or assume an ordered database index.
 
-	new_zealand = Geospatial::Box.from_bounds(Vector[166.0, -48.0], Vector[180.0, -34.0])
+new_zealand = Geospatial::Box.from_bounds(Vector[166.0, -48.0], Vector[180.0, -34.0])
 
-	points = subject.query(new_zealand)
-	expect(points).to include(lake_tekapo, lake_alex)
-	expect(points).to_not include(sydney)
+points = subject.query(new_zealand)
+expect(points).to include(lake_tekapo, lake_alex)
+expect(points).to_not include(sydney)
+```
 
 At a lower level you can use the method in the `Geospatial::Hilbert` module to `map`, `unmap` and `traverse` the Hilbert mapping.
 
+### Computing a Hilbert Index
+
+```ruby
+#!/usr/bin/env ruby
+require 'geospatial/map'
+require 'geospatial/dimensions'
+require 'geospatial/hilbert/curve'
+
+map = Geospatial::Map.for_earth(30)
+coordinate = ARGV.collect(&:to_f)
+index = map.hash_for_coordinates(coordinate)
+puts index
+```
+
 ### Geotemporal Indexes
 
 The Hilbert curve is multi-dimensional and therefore can represent multi-dimensional data, e.g. latitude, longitude and time, in a single index. The curve expands uniformly in all dimensions, so you can't control the precision of the dimensions independently.
 
-Mathematically speaking, it's possible to compose curves together to form curves of different precision/properties. However, how these fit together generally is a bit more complex, especially in terms of exploring the curve via traversal.
+Mathematically speaking, it's possible to [compose curves together](https://github.com/cne1x/sfseize) to form curves of different precision/properties. However, how these fit together generally is a bit more complex, especially in terms of exploring the curve via traversal.
 
 ## Contributing
 

data/lib/geospatial/location.rb

@@ -46,6 +46,10 @@ module Geospatial
 		VALID_LATITUDE = MIN_LATITUDE...MAX_LATITUDE
 		
 		class << self
+			def [] (longitude:, latitude:)
+				self.new(longitude, latitude)
+			end
+			
 			def from_ecef(x, y, z)
 				# Constants (WGS ellipsoid)
 				a = WGS84_A

data/lib/geospatial/version.rb

@@ -19,5 +19,5 @@
 # THE SOFTWARE.
 
 module Geospatial
-	VERSION = "1.3.1"
+	VERSION = "1.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: geospatial
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-03-09 00:00:00.000000000 Z
+date: 2017-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec