Class: Geospatial::Map

Inherits:
Object
  • Object
show all
Defined in:
lib/geospatial/map.rb,
lib/geospatial/map/index.rb

Defined Under Namespace

Classes: Index

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(curve) ⇒ Map

Returns a new instance of Map.



64
65
66
67
68
 
# File 'lib/geospatial/map.rb', line 64

def initialize(curve)
	@curve = curve
	@points = []
	@bounds = nil
end

Instance Attribute Details

#curve ⇒ Object (readonly)

Returns the value of attribute curve.



70
71
72
 
# File 'lib/geospatial/map.rb', line 70

def curve
  @curve
end

#points ⇒ Object (readonly)

Returns the value of attribute points.



87
88
89
 
# File 'lib/geospatial/map.rb', line 87

def points
  @points
end

Class Method Details

.for_earth(order = 20) ⇒ Object 



60
61
62
 
# File 'lib/geospatial/map.rb', line 60

def self.for_earth(order = 20)
	self.new(Hilbert::Curve.new(Dimensions.for_earth, order))
end

Instance Method Details

#<<(object) ⇒ Object 



105
106
107
108
109
 
# File 'lib/geospatial/map.rb', line 105

def << object
	@points << point_for_coordinates(object.to_a, object)
	
	return self
end

#bounds ⇒ Object 



76
77
78
79
80
81
82
83
84
85
 
# File 'lib/geospatial/map.rb', line 76

def bounds
	unless @bounds
		origin = @curve.origin
		size = @curve.size
		
		@bounds = Box.new(origin, size)
	end
	
	return @bounds
end

#count ⇒ Object 



111
112
113
 
# File 'lib/geospatial/map.rb', line 111

def count
	@points.count
end

#filter_for(*regions, **options) ⇒ Object 



148
149
150
151
152
153
154
155
156
157
158
159
 
# File 'lib/geospatial/map.rb', line 148

def filter_for(*regions, **options)
	filter = Filter.new(@curve)
	
	regions.each do |region|
		# The filter will coalesce sequential segments of the curve into a single range.
		traverse(region, **options) do |child, prefix, order|
			filter.add(prefix, order)
		end
	end
	
	return filter
end

#hash_for_coordinates(coordinates) ⇒ Object 



89
90
91
 
# File 'lib/geospatial/map.rb', line 89

def hash_for_coordinates(coordinates)
	@curve.map(coordinates)
end

#index ⇒ Object

serialize :point, Map.for_earth.index



49
50
51
52
53
54
55
 
# File 'lib/geospatial/map/index.rb', line 49

def index
	klass = Class.new(Index)
	
	klass.map = self
	
	return klass
end

#order ⇒ Object 



72
73
74
 
# File 'lib/geospatial/map.rb', line 72

def order
	@curve.order
end

#point_for_coordinates(coordinates, object = nil) ⇒ Object 



97
98
99
 
# File 'lib/geospatial/map.rb', line 97

def point_for_coordinates(coordinates, object = nil)
	Point.new(self, coordinates, object)
end

#point_for_hash(hash) ⇒ Object 



93
94
95
 
# File 'lib/geospatial/map.rb', line 93

def point_for_hash(hash)
	Point.new(self, @curve.unmap(hash))
end

#point_for_object(object) ⇒ Object 



101
102
103
 
# File 'lib/geospatial/map.rb', line 101

def point_for_object(object)
	Point.new(self, object.to_a, object)
end

#query(region, **options) ⇒ Object 



119
120
121
122
123
 
# File 'lib/geospatial/map.rb', line 119

def query(region, **options)
	filter = filter_for(region, **options)
	
	return filter.apply(@points).map(&:object)
end

#sort! ⇒ Object 



115
116
117
 
# File 'lib/geospatial/map.rb', line 115

def sort!
	@points.sort_by!(&:hash)
end

#traverse(region, depth: 0) ⇒ Object 



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
 
# File 'lib/geospatial/map.rb', line 125

def traverse(region, depth: 0)
	@curve.traverse do |child_origin, child_size, prefix, order|
		child = Box.new(Vector.elements(child_origin), Vector.elements(child_size))
		
		# puts "Considering (order=#{order}) #{child.inspect}..."
		
		if region.intersect?(child)
			if order == depth # at bottom
				# puts "at bottom -> found prefix #{prefix.to_s(2)} (#{child.inspect})"
				yield(child, prefix, order); :skip
			elsif region.include?(child)
				# puts "include child -> found prefix #{prefix.to_s(2)} (#{child.inspect})"
				yield(child, prefix, order); :skip
			else
				# puts "going deeper..."
			end
		else
			# puts "out of bounds."
			:skip
		end
	end
end