rgeo 0.1.10

data/lib/rgeo/features/geometry_collection.rb

@@ -0,0 +1,118 @@
+# -----------------------------------------------------------------------------
+# 
+# GeometryCollection feature interface
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * Neither the name of the copyright holder, nor the names of any other
+#   contributors to this software, may be used to endorse or promote products
+#   derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+# -----------------------------------------------------------------------------
+;
+
+
+module RGeo
+  
+  module Features
+    
+    
+    # == SFS 1.1 Description
+    # 
+    # A GeometryCollection is a geometric object that is a collection of 1
+    # or more geometric objects.
+    # 
+    # All the elements in a GeometryCollection shall be in the same Spatial
+    # Reference. This is also the Spatial Reference for the GeometryCollection.
+    # 
+    # GeometryCollection places no other constraints on its elements.
+    # Subclasses of GeometryCollection may restrict membership based on
+    # dimension and may also place other constraints on the degree of spatial
+    # overlap between elements.
+    # 
+    # == Notes
+    # 
+    # GeometryCollection is defined as a module and is provided primarily
+    # for the sake of documentation. Implementations need not necessarily
+    # include this module itself. Therefore, you should not depend on the
+    # kind_of? method to check type. Instead, use the provided check_type
+    # class method. A corresponding === operator is also provided to
+    # to support case-when constructs.
+    
+    module GeometryCollection
+      
+      include Geometry
+      include ::Enumerable
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # Returns the number of geometries in this GeometryCollection.
+      # 
+      # === Notes
+      # 
+      # Returns an integer.
+      
+      def num_geometries
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # Returns the Nth geometry in this GeometryCollection.
+      # 
+      # === Notes
+      # 
+      # Returns an object that supports the Geometry interface, or nil
+      # if the given n is out of range.
+      
+      def geometry_n(n_)
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+      alias_method :size, :num_geometries
+      alias_method :[], :geometry_n
+      
+      
+      # Iterates over the geometries of this GeometryCollection.
+      # 
+      # This is not a standard SFS method, but is provided so that a
+      # GeometryCollection can behave as a Ruby enumerable.
+      # Note that all GeometryCollection implementations must also
+      # include the Enumerable mixin.
+      
+      def each(&block_)
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+    end
+  
+    
+  end
+  
+end

data/lib/rgeo/features/line.rb

@@ -0,0 +1,65 @@
+# -----------------------------------------------------------------------------
+# 
+# Line feature interface
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * Neither the name of the copyright holder, nor the names of any other
+#   contributors to this software, may be used to endorse or promote products
+#   derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+# -----------------------------------------------------------------------------
+;
+
+
+module RGeo
+  
+  module Features
+    
+    
+    # == SFS 1.1 Description
+    # 
+    # A Line is a LineString with exactly 2 Points.
+    # 
+    # == Notes
+    # 
+    # Line is defined as a module and is provided primarily
+    # for the sake of documentation. Implementations need not necessarily
+    # include this module itself. Therefore, you should not depend on the
+    # kind_of? method to check type. Instead, use the provided check_type
+    # class method. A corresponding === operator is also provided to
+    # to support case-when constructs.
+    
+    module Line
+      
+      include LineString
+      
+      
+    end
+  
+    
+  end
+  
+end

data/lib/rgeo/features/line_string.rb

@@ -0,0 +1,101 @@
+# -----------------------------------------------------------------------------
+# 
+# LineString feature interface
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * Neither the name of the copyright holder, nor the names of any other
+#   contributors to this software, may be used to endorse or promote products
+#   derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+# -----------------------------------------------------------------------------
+;
+
+
+module RGeo
+  
+  module Features
+    
+    
+    # == SFS 1.1 Description
+    # 
+    # A LineString is a Curve with linear interpolation between Points.
+    # Each consecutive pair of Points defines a Line segment.
+    # 
+    # == Notes
+    # 
+    # LineString is defined as a module and is provided primarily
+    # for the sake of documentation. Implementations need not necessarily
+    # include this module itself. Therefore, you should not depend on the
+    # kind_of? method to check type. Instead, use the provided check_type
+    # class method. A corresponding === operator is also provided to
+    # to support case-when constructs.
+    
+    module LineString
+      
+      include Curve
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # The number of Points in this LineString.
+      # 
+      # === Notes
+      # 
+      # Returns an integer.
+      
+      def num_points
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # Returns the specified Point N in this LineString.
+      # 
+      # === Notes
+      # 
+      # Returns an object that supports the Point interface, or nil
+      # if the given n is out of range.
+      
+      def point_n(n_)
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+      # Returns the constituent points as an array of objects that
+      # support the Point interface.
+      
+      def points
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+    end
+  
+    
+  end
+  
+end

data/lib/rgeo/features/linear_ring.rb

@@ -0,0 +1,65 @@
+# -----------------------------------------------------------------------------
+# 
+# LinearRing feature interface
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * Neither the name of the copyright holder, nor the names of any other
+#   contributors to this software, may be used to endorse or promote products
+#   derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+# -----------------------------------------------------------------------------
+;
+
+
+module RGeo
+  
+  module Features
+    
+    
+    # == SFS 1.1 Description
+    # 
+    # A LinearRing is a LineString that is both closed and simple.
+    # 
+    # == Notes
+    # 
+    # LinearRing is defined as a module and is provided primarily
+    # for the sake of documentation. Implementations need not necessarily
+    # include this module itself. Therefore, you should not depend on the
+    # kind_of? method to check type. Instead, use the provided check_type
+    # class method. A corresponding === operator is also provided to
+    # to support case-when constructs.
+    
+    module LinearRing
+      
+      include LineString
+      
+      
+    end
+  
+    
+  end
+  
+end

data/lib/rgeo/features/multi_curve.rb

@@ -0,0 +1,112 @@
+# -----------------------------------------------------------------------------
+# 
+# MultiCurve feature interface
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * Neither the name of the copyright holder, nor the names of any other
+#   contributors to this software, may be used to endorse or promote products
+#   derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+# -----------------------------------------------------------------------------
+;
+
+
+module RGeo
+  
+  module Features
+    
+    
+    # == SFS 1.1 Description
+    # 
+    # A MultiCurve is a 1-dimensional GeometryCollection whose elements are
+    # Curves.
+    # 
+    # MultiCurve is a non-instantiable class in this specification; it
+    # defines a set of methods for its subclasses and is included for
+    # reasons of extensibility.
+    # 
+    # A MultiCurve is simple if and only if all of its elements are simple
+    # and the only intersections between any two elements occur at Points
+    # that are on the boundaries of both elements.
+    # 
+    # The boundary of a MultiCurve is obtained by applying the "mod 2"
+    # union rule: A Point is in the boundary of a MultiCurve if it is in
+    # the boundaries of an odd number of elements of the MultiCurve.
+    # 
+    # A MultiCurve is closed if all of its elements are closed. The
+    # boundary of a closed MultiCurve is always empty.
+    # 
+    # A MultiCurve is defined as topologically closed.
+    # 
+    # == Notes
+    # 
+    # MultiCurve is defined as a module and is provided primarily
+    # for the sake of documentation. Implementations need not necessarily
+    # include this module itself. Therefore, you should not depend on the
+    # kind_of? method to check type. Instead, use the provided check_type
+    # class method. A corresponding === operator is also provided to
+    # to support case-when constructs.
+    
+    module MultiCurve
+      
+      include GeometryCollection
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # The Length of this MultiCurve which is equal to the sum of the
+      # lengths of the element Curves.
+      # 
+      # === Notes
+      # 
+      # Returns a floating-point scalar value.
+      
+      def length
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # Returns true if this MultiCurve is closed [StartPoint() = EndPoint()
+      # for each Curve in this MultiCurve].
+      # 
+      # === Notes
+      # 
+      # Returns a boolean value. Note that this is different from the SFS
+      # specification, which stipulates an integer return value.
+      
+      def is_closed?
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+    end
+  
+    
+  end
+  
+end