From: Kevin Neufeld Date: Thu, 31 Jul 2008 06:29:52 +0000 (+0000) Subject: Moved over ST_Touches to new PostGIS reference. Examples forthcoming. X-Git-Tag: 1.4.0b1~802 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=20f3dc86a3dd5288b5837509d83c8c194772b514;p=postgis Moved over ST_Touches to new PostGIS reference. Examples forthcoming. git-svn-id: http://svn.osgeo.org/postgis/trunk@2898 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/reference.xml b/doc/reference.xml index 5ff012759..e8231c398 100644 --- a/doc/reference.xml +++ b/doc/reference.xml @@ -23,29 +23,6 @@ Geometry Relationship Functions - - ST_Touches(A geometry, B geometry) - - - Returns TRUE if the Geometries "spatially touch". - - 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_Touches. - - NOTE: this is the "allowable" version that returns a - boolean, not an integer. - - OGC SPEC s2.1.1.2 // s2.1.13.3- a.Touches(b) -> (I(a) - intersection I(b) = {empty set} ) and (a intersection b) not - empty - - ST_Overlaps(A geometry, B geometry) @@ -2518,18 +2495,7 @@ WHERE n*100.00/length < 1; SQL-MM 3: 5.1.21 - - - - ST_Touches - - - Test if an ST_Geometry value spatially touches another - ST_Geometry value. - - SQL-MM 3: 5.1.28 - - + ST_WKBToSQL diff --git a/doc/reference_new.xml b/doc/reference_new.xml index d216d6ac6..e26a3664a 100644 --- a/doc/reference_new.xml +++ b/doc/reference_new.xml @@ -2594,7 +2594,7 @@ st_area geometries must not equal either of the source geometries. Otherwise, it returns FALSE. - In mathematical terms, this is expressed as : + In mathematical terms, this is expressed as: a.Crosses(b) ⇔ (dim(I(a) ∩ I(b)) < max(dim(I(a)),dim(I(b))) @@ -2628,7 +2628,7 @@ st_area Area/Line situations as well. This makes the relation symmetric. - + Do not call with a GEOMETRYCOLLECTION as an argument @@ -2772,9 +2772,11 @@ WHERE ST_Crosses(roads.the_geom, highways.the_geom); 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 - + + + Do not call with a GEOMETRYCOLLECTION as an argument + + Performed by the GEOS module This function call does not use indexes @@ -3049,9 +3051,11 @@ SELECT ST_Equals(ST_Reverse(ST_GeomFromText('LINESTRING(0 0, 10 10)')), 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 - + + + Do not call with a GEOMETRYCOLLECTION as an argument + + Performed by the GEOS module This function call will automatically include a bounding box @@ -3366,6 +3370,93 @@ SELECT ST_AsText(ST_PointOnSurface('POLYGON((0 0, 0 5, 5 5, 5 0, 0 0))'::geometr + + + ST_Touches + + Returns TRUE if the geometries have at least one point in common, + but their interiors do not intersect. + + + + + + boolean ST_Touches + + geometry + g1 + + geometry + g2 + + + + + + Description + + Returns TRUE if the only points in common between + g1 and g2 lie in the union of the + boundaries of g1 and g2. + The ST_Touches relation applies + to all Area/Area, Line/Line, Line/Area, Point/Area and Point/Line pairs of relationships, + but not to the Point/Point pair. + + In mathematical terms, this predicate is expressed as: + + + a.Touches(b) ⇔ (I(a) ∩ I(b) = ∅) ∧ (a ∪ b ≠ ∅) + + + The allowable DE-9IM Intersection Matrices for the two geometries are: + + + + FT******* + + + + F**T***** + + + + F***T**** + + + + + 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 using an index, use _ST_Touches instead. + + + + + + + This method implements the OpenGIS Simple + Features Implementation Specification for SQL: 2.1.1.2, 2.1.13.3 + + + + + + This method implements the SQL/MM + specification: SQL-MM 3: 5.1.28 + + + + Examples + + Forthcoming... + + + ST_Within @@ -3397,7 +3488,9 @@ SELECT ST_AsText(ST_PointOnSurface('POLYGON((0 0, 0 5, 5 5, 5 0, 0 0))'::geometr Performed by the GEOS module - Do not call with a GeometryCollection as an argument + + 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