From: Paul Ramsey <pramsey@cleverelephant.ca>
Date: Wed, 1 Feb 2012 23:55:48 +0000 (+0000)
Subject: Add lwcollection_homogenize and ST_Homogenize (#375)
X-Git-Tag: 2.0.0alpha4~94
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=784d83e7c0a1f900b68cee82c5c3333e4997a488;p=postgis

Add lwcollection_homogenize and ST_Homogenize (#375)


git-svn-id: http://svn.osgeo.org/postgis/trunk@9010 b70326c6-7e19-0410-871a-916f4a2858ee
---

diff --git a/doc/reference_editor.xml b/doc/reference_editor.xml
index 15a1721d5..280fc53b1 100644
--- a/doc/reference_editor.xml
+++ b/doc/reference_editor.xml
@@ -697,10 +697,65 @@ MULTILINESTRING((0 0, 1 1), (2 2, 3 3))
 		</refsection>
 		<refsection>
 			<title>See Also</title>
-			<para><xref linkend="ST_Multi" />, <xref linkend="ST_Dump" /></para>
+			<para><xref linkend="ST_Multi" />, <xref linkend="ST_Dump" />, <xref linkend="ST_CollectionHomogenize" /></para>
 		</refsection>
 	</refentry>
 	
+		<refentry id="ST_CollectionHomogenize">
+			<refnamediv>
+				<refname>ST_CollectionHomogenize</refname>
+
+				<refpurpose>
+	Given a geometry collection, returns the "simplest" representation of the contents.
+				</refpurpose>
+			</refnamediv>
+
+			<refsynopsisdiv>
+				<funcsynopsis>
+				  <funcprototype>
+					<funcdef>geometry <function>ST_CollectionHomogenize</function></funcdef>
+					<paramdef><type>geometry </type> <parameter>collection</parameter></paramdef>
+				  </funcprototype>
+				</funcsynopsis>
+			</refsynopsisdiv>
+
+			<refsection>
+				<title>Description</title>
+
+				<para>
+					Given a geometry collection, returns the "simplest" representation of the contents.  Singletons will be returned as singletons.  Collections that are homogeneous will be returned as the appropriate multi-type.
+				</para>
+
+				<para>Availability: 2.0.0</para>
+
+			</refsection>
+
+			<refsection>
+				<title>Examples</title>
+
+				<programlisting>
+  SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 0))'));	
+
+	st_astext
+	------------
+	 POINT(0 0)
+	(1 row)
+
+  SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 0),POINT(1 1))'));	
+
+	st_astext
+	---------------------
+	 MULTIPOINT(0 0,1 1)
+	(1 row)
+
+				</programlisting>
+			</refsection>
+			<refsection>
+				<title>See Also</title>
+				<para><xref linkend="ST_Multi" />, <xref linkend="ST_CollectionExtract" /></para>
+			</refsection>
+		</refentry>	
+	
 	<refentry id="ST_Multi">
 		<refnamediv>
 			<refname>ST_Multi</refname>