[postgis-tickets] [SCM] PostGIS branch master updated. 3.1.0rc1-194-g0e5d871
git at osgeo.org
git at osgeo.org
Thu May 27 10:08:36 PDT 2021
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "PostGIS".
The branch, master has been updated
via 0e5d871404e2cb076ab987a58c246ca6f784ebf2 (commit)
from c815ecd7d2d59fc362f39c9adfd99b01d12aea89 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit 0e5d871404e2cb076ab987a58c246ca6f784ebf2
Author: Martin Davis <mtnclimb at gmail.com>
Date: Thu May 27 10:08:30 2021 -0700
Improve doc for ST_LineMerge
diff --git a/doc/reference_editor.xml b/doc/reference_editor.xml
index 793003d..742b81b 100644
--- a/doc/reference_editor.xml
+++ b/doc/reference_editor.xml
@@ -1090,73 +1090,6 @@ GEOMETRYCOLLECTION(
</refsection>
</refentry>
- <refentry id="ST_LineMerge">
- <refnamediv>
- <refname>ST_LineMerge</refname>
-
- <refpurpose>Return a (set of) LineString(s) formed by sewing together
- a MULTILINESTRING.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>geometry <function>ST_LineMerge</function></funcdef>
- <paramdef><type>geometry </type> <parameter>amultilinestring</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns a (set of) LineString(s) formed by sewing together
- the constituent line work of a MULTILINESTRING. </para>
- <note><para>Only use with MULTILINESTRING/LINESTRINGs. If you feed a polygon or geometry collection into this function, it
- will return an empty GEOMETRYCOLLECTION</para></note>
- <para>Performed by the GEOS module.</para>
- <para>Availability: 1.1.0</para>
- <warning><para>Will strip the M dimension.</para></warning>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT ST_AsText(ST_LineMerge(
-ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45 -33,-46 -32))')
- )
-);
-st_astext
---------------------------------------------------------------------------------------------------
-LINESTRING(-29 -27,-30 -29.7,-36 -31,-45 -33,-46 -32)
-(1 row)
-
---If can't be merged - original MULTILINESTRING is returned
-SELECT ST_AsText(ST_LineMerge(
-ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45.2 -33.2,-46 -32))')
-)
-);
-st_astext
-----------------
-MULTILINESTRING((-45.2 -33.2,-46 -32),(-29 -27,-30 -29.7,-36 -31,-45 -33))
-
--- example with Z dimension
-SELECT ST_AsText(ST_LineMerge(
-ST_GeomFromText('MULTILINESTRING((-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 6), (-29 -27 12,-30 -29.7 5), (-45 -33 1,-46 -32 11))')
- )
-);
-st_astext
---------------------------------------------------------------------------------------------------
-LINESTRING Z (-30 -29.7 5,-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 1,-46 -32 11)
-(1 row)
- </programlisting>
- </refsection>
- <refsection>
- <title>See Also</title>
- <para><xref linkend="ST_Segmentize" />, <xref linkend="ST_LineSubstring" /></para>
- </refsection>
- </refentry>
-
<refentry id="ST_LineToCurve">
<refnamediv>
<refname>ST_LineToCurve</refname>
diff --git a/doc/reference_processing.xml b/doc/reference_processing.xml
index 928f968..1a0ab6b 100644
--- a/doc/reference_processing.xml
+++ b/doc/reference_processing.xml
@@ -1285,6 +1285,75 @@ FROM test;
</refentry>
+ <refentry id="ST_LineMerge">
+ <refnamediv>
+ <refname>ST_LineMerge</refname>
+
+ <refpurpose>Return the lines formed by sewing together
+ a MultiLineString.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>geometry <function>ST_LineMerge</function></funcdef>
+ <paramdef><type>geometry </type> <parameter>amultilinestring</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns a LineString or MultiLineString formed by joining together
+ the constituent line work of a MultiLineString.
+ Lines are joined at their endpoints at 2-way intersections.
+ Lines are not joined across intersections of 3-way or greater degree.
+ </para>
+
+ <note><para>Only use with MultiLineString/LineStrings. If you pass a Plygon or GeometryCollection into this function, it
+ returns an empty GeometryCollection</para></note>
+ <para>Performed by the GEOS module.</para>
+ <para>Availability: 1.1.0</para>
+ <warning><para>This function will strip the M dimension.</para></warning>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT ST_AsText(ST_LineMerge(
+'MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45 -33,-46 -32))'
+ ));
+st_astext
+--------------------------------------------------------------------------------------------------
+LINESTRING(-29 -27,-30 -29.7,-36 -31,-45 -33,-46 -32)
+</programlisting>
+<para>If merging is not possible due to non-touching lines,
+the original MultiLineString is returned.</para>
+<programlisting>
+SELECT ST_AsText(ST_LineMerge(
+'MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45.2 -33.2,-46 -32))'
+));
+st_astext
+----------------
+MULTILINESTRING((-45.2 -33.2,-46 -32),(-29 -27,-30 -29.7,-36 -31,-45 -33))
+</programlisting>
+<para>Example showing Z-dimension handling.</para>
+<programlisting>
+SELECT ST_AsText(ST_LineMerge(
+ 'MULTILINESTRING((-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 6), (-29 -27 12,-30 -29.7 5), (-45 -33 1,-46 -32 11))'
+ ));
+st_astext
+--------------------------------------------------------------------------------------------------
+LINESTRING Z (-30 -29.7 5,-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 1,-46 -32 11)
+</programlisting>
+ </refsection>
+ <refsection>
+ <title>See Also</title>
+ <para><xref linkend="ST_Segmentize" />, <xref linkend="ST_LineSubstring" /></para>
+ </refsection>
+ </refentry>
+
<refentry id="ST_MaximumInscribedCircle">
<refnamediv>
<refname>ST_MaximumInscribedCircle</refname>
-----------------------------------------------------------------------
Summary of changes:
doc/reference_editor.xml | 67 ------------------------------------------
doc/reference_processing.xml | 69 ++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 69 insertions(+), 67 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list