rgeo 0.1.10

data/ext/geos_c_impl/polygon.h

@@ -0,0 +1,76 @@
+/*
+  -----------------------------------------------------------------------------
+  
+  Polygon methods for GEOS wrapper
+  
+  -----------------------------------------------------------------------------
+  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.
+  -----------------------------------------------------------------------------
+*/
+
+
+#ifndef RGEO_GEOS_POLYGON_INCLUDED
+#define RGEO_GEOS_POLYGON_INCLUDED
+
+#include <ruby.h>
+#include <geos_c.h>
+
+#include "factory.h"
+
+#ifdef __cplusplus
+extern "C" {
+#if 0
+}
+#endif
+#endif
+
+
+/*
+  Initializes the polygon module. This should be called after
+  the geometry module is initialized.
+*/
+void rgeo_init_geos_polygon(RGeo_Globals* globals);
+
+/*
+  Comopares the values of two GEOS polygons. The two given geometries MUST
+  be polygon types.
+  Returns Qtrue if the polygons are equal, Qfalse if they are inequal, or
+  Qnil if an error occurs.
+*/
+VALUE rgeo_geos_polygons_eql(GEOSContextHandle_t context, const GEOSGeometry* geom1, const GEOSGeometry* geom2);
+
+
+#ifdef __cplusplus
+#if 0
+{
+#endif
+}
+#endif
+
+#endif

data/ext/geos_c_impl/preface.h

@@ -0,0 +1,42 @@
+/*
+  -----------------------------------------------------------------------------
+  
+  Preface header for GEOS wrapper
+  
+  -----------------------------------------------------------------------------
+  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.
+  -----------------------------------------------------------------------------
+*/
+
+
+#ifdef HAVE_GEOS_C_H
+#ifdef HAVE_INITGEOS_R
+#define RGEO_GEOS_SUPPORTED
+#endif
+#endif

data/lib/rgeo.rb

@@ -0,0 +1,68 @@
+# -----------------------------------------------------------------------------
+# 
+# RGeo Rakefile
+# 
+# -----------------------------------------------------------------------------
+# 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.
+# -----------------------------------------------------------------------------
+;
+
+
+# The source files that should be required by default.
+paths_ = [
+  'version',
+  'errors',
+  'features',
+  'geos',
+  'geography',
+  'geo_json',
+]
+paths_.each{ |path_| require "rgeo/#{path_}" }
+
+
+# RGeo is a spatial data library for Ruby.
+# 
+# The RGeo::Features module contains interface specifications for spatial
+# objects implemented by RGeo. These interfaces closely follow the OGC
+# Simple Features Specifiation.
+# 
+# The RGeo::Geos module contains a spatial implementation that wraps
+# the GEOS library. This is a full implementation that operates on
+# cartesian coordinates.
+# 
+# The RGeo::Geography module contains spatial implementations that
+# operate in latitude-longitude coordinates. Several different
+# implementations are provided, including one designed for map
+# visualization applications that use Google or Bing maps.
+# 
+# The RGeo::GeoJSON module contains tools for GeoJSON serialization of
+# spatial objects.
+
+module RGeo
+end

data/lib/rgeo/errors.rb

@@ -0,0 +1,59 @@
+# -----------------------------------------------------------------------------
+# 
+# Error classes for RGeo
+# 
+# -----------------------------------------------------------------------------
+# 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
+  
+  
+  # All RGeo errors are members of this namespace.
+  
+  module Errors
+    
+    # Base class for all RGeo-related exceptions
+    class RGeoError < ::RuntimeError
+    end
+    
+    # The method is unimplemented
+    class MethodUnimplemented < RGeoError
+    end
+    
+    # The specified geometry is invalid
+    class InvalidGeometry < RGeoError
+    end
+    
+  end
+  
+  
+end

data/lib/rgeo/features.rb

@@ -0,0 +1,89 @@
+# -----------------------------------------------------------------------------
+# 
+# Features namespace for RGeo
+# 
+# -----------------------------------------------------------------------------
+# 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
+  
+  
+  # The Features namespace contains interfaces and general tools for
+  # implementations of the Open Geospatial Consortium Simple Features
+  # Specification (SFS), version 1.1.0.
+  # 
+  # Each interface is defined as a module, and is provided primarily for
+  # the sake of documentation. Implementations do not necessarily include
+  # the modules themselves. Therefore, you should not depend on the
+  # kind_of? method to check type. Instead, each interface module will
+  # provide a check_type class method (and a corresponding === operator
+  # to support case-when constructs).
+  # 
+  # In addition, a Factory interface is defined here. A factory is an
+  # object that knows how to construct geometry instances for a given
+  # implementation. Each implementation's front-end consists of a way to
+  # create factories. Those factories, in turn, provide the api for
+  # building the features themselves. Note that, like the geometry
+  # modules, the Factory module itself may not actually be included in a
+  # factory implementation.
+  # 
+  # Any particular implementation may extend these interfaces to provide
+  # implementation-specific features beyond what is stated in the SFS
+  # itself. The implementation should separately document any such
+  # extensions that it may provide.
+  
+  module Features
+  end
+  
+  
+end
+
+
+# Dependency source files.
+paths_ = [
+  'features/factory',
+  'features/geometry',
+  'features/point',
+  'features/curve',
+  'features/line_string',
+  'features/linear_ring',
+  'features/line',
+  'features/surface',
+  'features/polygon',
+  'features/geometry_collection',
+  'features/multi_point',
+  'features/multi_curve',
+  'features/multi_line_string',
+  'features/multi_surface',
+  'features/multi_polygon',
+]
+paths_.each{ |path_| require "rgeo/#{path_}" }

data/lib/rgeo/features/curve.rb

@@ -0,0 +1,155 @@
+# -----------------------------------------------------------------------------
+# 
+# Curve 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 Curve is a 1-dimensional geometric object usually stored as a
+    # sequence of Points, with the subtype of Curve specifying the form of
+    # the interpolation between Points. This part of ISO 19125 defines only
+    # one subclass of Curve, LineString, which uses linear interpolation
+    # between Points.
+    # 
+    # A Curve is a 1-dimensional geometric object that is the homeomorphic
+    # image of a real, closed interval D=[a,b] under a mapping f:[a,b]->R2.
+    # 
+    # A Curve is simple if it does not pass through the same Point twice.
+    # 
+    # A Curve is closed if its start Point is equal to its end Point.
+    # 
+    # The boundary of a closed Curve is empty.
+    # 
+    # A Curve that is simple and closed is a Ring.
+    # 
+    # The boundary of a non-closed Curve consists of its two end Points.
+    # 
+    # A Curve is defined as topologically closed.
+    # 
+    # == Notes
+    # 
+    # Curve 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.
+    # 
+    # Some implementations may support higher dimensional points.
+    
+    module Curve
+      
+      include Geometry
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # The length of this Curve in its associated spatial reference.
+      # 
+      # === Notes
+      # 
+      # Returns a floating-point scalar value.
+      
+      def length
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # The start Point of this Curve.
+      # 
+      # === Notes
+      # 
+      # Returns an object that supports the Point interface.
+      
+      def start_point
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # The end Point of this Curve.
+      # 
+      # === Notes
+      # 
+      # Returns an object that supports the Point interface.
+      
+      def end_point
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # Returns true if this Curve is closed [StartPoint() = EndPoint()].
+      # 
+      # === 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
+      
+      
+      # === SFS 1.1 Description
+      # 
+      # Returns true if this Curve is closed [StartPoint() = EndPoint()]
+      # and this Curve is simple (does not pass through the same Point
+      # more than once).
+      # 
+      # === Notes
+      # 
+      # Returns a boolean value. Note that this is different from the SFS
+      # specification, which stipulates an integer return value.
+      
+      def is_ring?
+        raise Errors::MethodUnimplemented
+      end
+      
+      
+    end
+  
+    
+  end
+  
+end