[postgis-tickets] r14712 - Mark ST_ClusterWithin and ST_ClusterIntersecting as taking geometry sets
Regina Obe
lr at pcorp.us
Sat Feb 27 00:10:37 PST 2016
Author: robe
Date: 2016-02-27 00:10:37 -0800 (Sat, 27 Feb 2016)
New Revision: 14712
Modified:
branches/2.2/doc/reference_measure.xml
branches/2.2/doc/reference_processing.xml
Log:
Mark ST_ClusterWithin and ST_ClusterIntersecting as taking geometry sets
(so they are flagged as aggregates)
Move them to measurement and relationships section so matches 2.3 docs
Modified: branches/2.2/doc/reference_measure.xml
===================================================================
--- branches/2.2/doc/reference_measure.xml 2016-02-27 08:05:34 UTC (rev 14711)
+++ branches/2.2/doc/reference_measure.xml 2016-02-27 08:10:37 UTC (rev 14712)
@@ -1032,6 +1032,113 @@
</refsection>
</refentry>
+ <refentry id="ST_ClusterIntersecting">
+ <refnamediv>
+ <refname>ST_ClusterIntersecting</refname>
+
+ <refpurpose>Aggregate. Returns an array with the connected components of a set of geometries</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>geometry[] <function>ST_ClusterIntersecting</function></funcdef>
+ <paramdef><type>geometry set </type> <parameter>g</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>ST_ClusterIntersecting is an aggregate function that returns an array of GeometryCollections, where each GeometryCollection represents an interconnected set of geometries.</para>
+
+ <para>Availability: 2.2.0 - requires GEOS </para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+ <programlisting>
+WITH testdata AS
+ (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,
+ 'LINESTRING (5 5, 4 4)'::geometry,
+ 'LINESTRING (6 6, 7 7)'::geometry,
+ 'LINESTRING (0 0, -1 -1)'::geometry,
+ 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS geom)
+
+SELECT ST_AsText(unnest(ST_ClusterIntersecting(geom))) FROM testdata;
+
+--result
+
+st_astext
+---------
+GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 -1),POLYGON((0 0,4 0,4 4,0 4,0 0)))
+GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))
+ </programlisting>
+ </refsection>
+ <refsection>
+ <title>See Also</title>
+ <para>
+ <xref linkend="ST_ClusterWithin" />,
+ </para>
+ </refsection>
+
+ </refentry>
+
+ <refentry id="ST_ClusterWithin">
+ <refnamediv>
+ <refname>ST_ClusterWithin</refname>
+
+ <refpurpose>Aggregate. Returns an array of GeometryCollections, where each GeometryCollection represents a set of geometries separated by no more than the specified distance.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>geometry[] <function>ST_ClusterWithin</function></funcdef>
+ <paramdef><type>geometry set </type> <parameter>g</parameter></paramdef>
+ <paramdef><type>float8 </type> <parameter>distance</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>ST_ClusterWithin is an aggregate function that returns an array of GeometryCollections, where each GeometryCollection represents a set of geometries separated by no more than the specified distance.</para>
+
+ <para>Availability: 2.2.0 - requires GEOS</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+ <programlisting>
+WITH testdata AS
+ (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,
+ 'LINESTRING (5 5, 4 4)'::geometry,
+ 'LINESTRING (6 6, 7 7)'::geometry,
+ 'LINESTRING (0 0, -1 -1)'::geometry,
+ 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS geom)
+
+SELECT ST_AsText(unnest(ST_ClusterWithin(geom, 1.4))) FROM testdata;
+
+--result
+
+st_astext
+---------
+GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 -1),POLYGON((0 0,4 0,4 4,0 4,0 0)))
+GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))
+ </programlisting>
+ </refsection>
+ <refsection>
+ <title>See Also</title>
+ <para>
+ <xref linkend="ST_ClusterIntersecting" />,
+ </para>
+ </refsection>
+
+ </refentry>
+
<refentry id="ST_Contains">
<refnamediv>
<refname>ST_Contains</refname>
Modified: branches/2.2/doc/reference_processing.xml
===================================================================
--- branches/2.2/doc/reference_processing.xml 2016-02-27 08:05:34 UTC (rev 14711)
+++ branches/2.2/doc/reference_processing.xml 2016-02-27 08:10:37 UTC (rev 14712)
@@ -3374,115 +3374,11 @@
</para>
</refsection>
</refentry>
+
- <refentry id="ST_ClusterWithin">
- <refnamediv>
- <refname>ST_ClusterWithin</refname>
- <refpurpose>Aggregate. Returns an array of GeometryCollections, where each GeometryCollection represents a set of geometries separated by no more than the specified distance.</refpurpose>
- </refnamediv>
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>geometry[] <function>ST_ClusterWithin</function></funcdef>
- <paramdef><type>geometry </type> <parameter>g</parameter></paramdef>
- <paramdef><type>float8 </type> <parameter>distance</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
- <refsection>
- <title>Description</title>
-
- <para>ST_ClusterWithin is an aggregate function that returns an array of GeometryCollections, where each GeometryCollection represents a set of geometries separated by no more than the specified distance.</para>
-
- <para>Availability: 2.2.0 - requires GEOS</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
- <programlisting>
-WITH testdata AS
- (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,
- 'LINESTRING (5 5, 4 4)'::geometry,
- 'LINESTRING (6 6, 7 7)'::geometry,
- 'LINESTRING (0 0, -1 -1)'::geometry,
- 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS geom)
-
-SELECT ST_AsText(unnest(ST_ClusterWithin(geom, 1.4))) FROM testdata;
-
---result
-
-st_astext
----------
-GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 -1),POLYGON((0 0,4 0,4 4,0 4,0 0)))
-GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))
- </programlisting>
- </refsection>
- <refsection>
- <title>See Also</title>
- <para>
- <xref linkend="ST_ClusterIntersecting" />,
- </para>
- </refsection>
-
- </refentry>
-
-
- <refentry id="ST_ClusterIntersecting">
- <refnamediv>
- <refname>ST_ClusterIntersecting</refname>
-
- <refpurpose>Aggregate. Returns an array with the connected components of a set of geometries</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>geometry[] <function>ST_ClusterIntersecting</function></funcdef>
- <paramdef><type>geometry </type> <parameter>g</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>ST_ClusterIntersecting is an aggregate function that returns an array of GeometryCollections, where each GeometryCollection represents an interconnected set of geometries.</para>
-
- <para>Availability: 2.2.0 - requires GEOS </para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
- <programlisting>
-WITH testdata AS
- (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,
- 'LINESTRING (5 5, 4 4)'::geometry,
- 'LINESTRING (6 6, 7 7)'::geometry,
- 'LINESTRING (0 0, -1 -1)'::geometry,
- 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS geom)
-
-SELECT ST_AsText(unnest(ST_ClusterIntersecting(geom))) FROM testdata;
-
---result
-
-st_astext
----------
-GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 -1),POLYGON((0 0,4 0,4 4,0 4,0 0)))
-GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))
- </programlisting>
- </refsection>
- <refsection>
- <title>See Also</title>
- <para>
- <xref linkend="ST_ClusterWithin" />,
- </para>
- </refsection>
-
- </refentry>
-
<refentry id="ST_UnaryUnion">
<refnamediv>
<refname>ST_UnaryUnion</refname>
More information about the postgis-tickets
mailing list