From 1205dea37dafa22ca29ebf190ad0a2b79c6ae9f0 Mon Sep 17 00:00:00 2001 From: Regina Obe Date: Tue, 15 Jul 2008 17:51:39 +0000 Subject: [PATCH] Move ST_Intersection, ST_Disjoint provide examples for both. git-svn-id: http://svn.osgeo.org/postgis/trunk@2854 b70326c6-7e19-0410-871a-916f4a2858ee --- doc/reference.xml | 43 ------------ doc/reference_new.xml | 148 ++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 143 insertions(+), 48 deletions(-) diff --git a/doc/reference.xml b/doc/reference.xml index c0f07d04b..ba5b918c3 100644 --- a/doc/reference.xml +++ b/doc/reference.xml @@ -40,49 +40,6 @@ - - ST_Disjoint(A geometry, B geometry) - - - Returns TRUE if the Geometries are "spatially - disjoint". - - Performed by the GEOS module - - Do not call with a GeometryCollection as an argument - - NOTE: this is the "allowable" version that returns a - boolean, not an integer. - - OGC SPEC s2.1.1.2 //s2.1.13.3 - a.Relate(b, - 'FF*FF****') - - - - - ST_Intersects(A geometry, B geometry) - - - Returns TRUE if the Geometries "spatially - intersect" - (share any portion of space) and FALSE if they don't. - - Performed by the GEOS module - - Do not call with a GeometryCollection as an argument - - This function call will automatically include a bounding box - comparison that will make use of any indexes that are available on - the geometries. To avoid index use, use the function - _ST_Intersects. - - NOTE: this is the "allowable" version that returns a - boolean, not an integer. - - OGC SPEC s2.1.1.2 //s2.1.13.3 - Intersects(g1, g2 ) --> - Not (Disjoint(g1, g2 )) - - - ST_Touches(A geometry, B geometry) diff --git a/doc/reference_new.xml b/doc/reference_new.xml index b22c70848..38a204348 100644 --- a/doc/reference_new.xml +++ b/doc/reference_new.xml @@ -486,8 +486,76 @@ FROM userpoints ; - Spatial Relationships + Spatial Relationships and Measurements + + + ST_Disjoint + + Returns TRUE if the Geometries do not "spatially + intersect" - if they do not share any space together. + + + + + + boolean ST_Disjoint + + geometry + A + + + geometry + B + + + + + + Description + Overlaps, Touches, Within all imply geometries are not spatially disjoint. If any of the aforementioned + returns true, then the geometries are not spatially disjoint. + Disjoint implies false for spatial intersection. + + Do not call with a GeometryCollection as an argument + + Performed by the GEOS module + + This function call does not use indexes + + + + NOTE: this is the "allowable" version that returns a + boolean, not an integer. + + + + This method implements the + OGC SPEC s2.1.1.2 //s2.1.13.3 - a.Relate(b, + 'FF*FF****') + + + + Examples + + SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry); + st_disjoint +--------------- + t +(1 row) +SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::geometry); + st_disjoint +--------------- + f +(1 row) + + + + + See Also + ST_Intersects + + ST_Distance @@ -615,10 +683,80 @@ SELECT DISTINCT ON (s.gid) s.gid, s.school_name, s.the_geom, h.hospital_name - - - - Spatial Predicates + + + + ST_Intersects + + Returns TRUE if the Geometries "spatially + intersect" - (share any portion of space) and FALSE if they don't (they are Disjoint). + + + + + + boolean ST_Intersects + + geometry + A + + + geometry + B + + + + + + Description + Overlaps, Touches, Within all imply spatial intersection. If any of the aforementioned + returns true, then the geometries also spatially intersect. + Disjoint implies false for spatial intersection. + + Do not call with a GeometryCollection as an argument + + Performed by the GEOS module + + This function call will automatically include a bounding box + comparison that will make use of any indexes that are available on the + geometries. + + + + NOTE: this is the "allowable" version that returns a + boolean, not an integer. + + + + This method implements the + OpenGIS Simple + Features Implementation Specification for SQL + + + + OGC SPEC s2.1.1.2 //s2.1.13.3 - ST_Intersects(g1, g2 ) --> + Not (ST_Disjoint(g1, g2 )) + + + + Examples +SELECT ST_Intersects('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry); + st_intersects +--------------- + f +(1 row) +SELECT ST_Intersects('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::geometry); + st_intersects +--------------- + t +(1 row) + + + + See Also + ST_Disjoint + + -- 2.50.1