From f39fe54eedeb8dee5538d39311b68decec77956a Mon Sep 17 00:00:00 2001 From: Regina Obe Date: Tue, 29 Jul 2008 12:00:08 +0000 Subject: [PATCH] remove ST_Area from reference.xml already accounted for in reference_new.xml, move over ST_Length, ST_Perimeter git-svn-id: http://svn.osgeo.org/postgis/trunk@2891 b70326c6-7e19-0410-871a-916f4a2858ee --- doc/reference.xml | 57 +----------------- doc/reference_new.xml | 136 +++++++++++++++++++++++++++++++++++++++++- 2 files changed, 135 insertions(+), 58 deletions(-) diff --git a/doc/reference.xml b/doc/reference.xml index eac52cb57..510b7cb5b 100644 --- a/doc/reference.xml +++ b/doc/reference.xml @@ -165,30 +165,7 @@ Geometry Processing Functions - - - - ST_Area(geometry) - - - Returns the area of the geometry if it is a polygon or - multi-polygon. - - - - - ST_Length(geometry) - - - The length of this Curve in its associated spatial - reference. - - synonym for length2d() - - OGC SPEC 2.1.5.1 - - - + ST_Boundary(geometry) @@ -1201,16 +1178,6 @@ GROUP BY gid, field1,field2; strings. - - - ST_perimeter(geometry) - - - Returns the 2-dimensional perimeter of the geometry, if it - is a polygon or multi-polygon. - - - ST_perimeter2d(geometry) @@ -2431,17 +2398,6 @@ WHERE n*100.00/length < 1; - - ST_Length - - - Return the length measurement of an ST_Curve or ST_MultiCurve - value. - - SQL-MM 3: 7.1.2, 9.3.4 - - - ST_LineFromText @@ -2554,17 +2510,6 @@ WHERE n*100.00/length < 1; - - ST_Perimeter - - - Return the length measurement of the boundary of an ST_Surface - or ST_MultiRSurface value. - - SQL-MM 3: 8.1.3, 9.5.4 - - - ST_Point diff --git a/doc/reference_new.xml b/doc/reference_new.xml index 6a2d63118..c363c46f3 100644 --- a/doc/reference_new.xml +++ b/doc/reference_new.xml @@ -2797,7 +2797,65 @@ SELECT ST_Intersects('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::geometry See Also - + + + + ST_Length + + Returns the length of the geometry if it is a linestring or multilinestring. + + + + + float ST_Length + geometry g1 + + + + + Description + + Returns the 2D length of the geometry if it is a linestring, multilinestring, ST_Curve, ST_MultiCurve. 0 is returned for + areal geometries. For areal geometries use ST_Perimeter. Measurements are in the units of the + spatial reference system of the geometry. + + Currently this is an alias for ST_Length2D, but this may change to support higher dimensions. + + + + + + This method implements the OpenGIS Simple Features + Implementation Specification for SQL. OGC SPEC 2.1.5.1 + + + + + + This method implements the SQL/MM specification: + SQL-MM 3: 7.1.2, 9.3.4 + + + + Examples + Return length in feet for line string. Note this is in feet because 2249 is + Mass State Plane Feet + +SELECT SELECT ST_Length(ST_GeomFromText('LINESTRING(743238 2967416,743238 2967450,743265 2967450, +743265.625 2967416,743238 2967416)',2249)); +st_length +--------- + 122.630744000095 +(1 row) + + + + See Also + + + + ST_OrderingEquals @@ -2868,8 +2926,82 @@ SELECT ST_OrderingEquals(ST_Reverse(ST_GeomFromText('LINESTRING(0 0, 10 10)')), , - + + + ST_Perimeter + + Return the length measurement of the boundary of an ST_Surface + or ST_MultiSurface value. (Polygon, Multipolygon) + + + + + float ST_Length + geometry g1 + + + + + Description + + Returns the 2D perimeter of the geometry if it is a ST_Surface, ST_MultiSurface (Polygon, Multipolygon). 0 is returned for + non-areal geometries. For linestrings use ST_Length. Measurements are in the units of the + spatial reference system of the geometry. + + Currently this is an alias for ST_Perimeter2D, but this may change to support higher dimensions. + + + + + + This method implements the OpenGIS Simple Features + Implementation Specification for SQL. OGC SPEC 2.1.5.1 + + + + + + This method implements the SQL/MM specification: + SQL-MM 3: 8.1.3, 9.5.4 + + + + Examples + Return perimeter in feet for polygon and multipolygon. Note this is in feet because 2249 is + Mass State Plane Feet + +SELECT ST_Perimeter(ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,743265 2967450, +743265.625 2967416,743238 2967416))', 2249)); +st_perimeter +--------- + 122.630744000095 +(1 row) + +SELECT ST_Perimeter(ST_GeomFromText('MULTIPOLYGON(((763104.471273676 2949418.44119003, +763104.477769673 2949418.42538203, +763104.189609677 2949418.22343004,763104.471273676 2949418.44119003)), +((763104.471273676 2949418.44119003,763095.804579742 2949436.33850239, +763086.132105649 2949451.46730207,763078.452329651 2949462.11549407, +763075.354136904 2949466.17407812,763064.362142565 2949477.64291974, +763059.953961626 2949481.28983009,762994.637609571 2949532.04103014, +762990.568508415 2949535.06640477,762986.710889563 2949539.61421415, +763117.237897679 2949709.50493431,763235.236617789 2949617.95619822, +763287.718121842 2949562.20592617,763111.553321674 2949423.91664605, +763104.471273676 2949418.44119003)))', 2249)); +st_perimeter +--------- + 845.227713366825 +(1 row) + + + + See Also + + + + ST_PointOnSurface -- 2.50.1