[postgis-tickets] [SCM] PostGIS branch master updated. 3.3.0beta1-15-g070fbec8b
git at osgeo.org
git at osgeo.org
Wed Jul 6 10:59:41 PDT 2022
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 070fbec8b683060386df02faf5e442fa52386683 (commit)
from 1543d3792bf12862bf30da5607e1d871fd5ce6de (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 070fbec8b683060386df02faf5e442fa52386683
Author: Martin Davis <mtnclimb at gmail.com>
Date: Wed Jul 6 10:59:35 2022 -0700
Improve doc for Linear Ref functions
diff --git a/doc/reference_lrs.xml b/doc/reference_lrs.xml
index 421a739f1..40d0e803d 100644
--- a/doc/reference_lrs.xml
+++ b/doc/reference_lrs.xml
@@ -456,15 +456,16 @@ CROSS JOIN LATERAL (
<refsection>
<title>Description</title>
- <para>Returns the locations along a measured geometry (as a Point or MultiPoint)
- that match a measure value.
- Polygonal elements are not supported.</para>
+ <para>Returns the location(s) along a measured geometry
+ that have the given measure values.
+ The result is a Point or MultiPoint.
+ Polygonal inputs are not supported.</para>
- <para>If the <varname>offset</varname> is provided, the result
+ <para>If <varname>offset</varname> is provided, the result
is offset to the left or right of the input line by the specified distance.
A positive offset will be to the left, and a negative one to the right.</para>
- <note><para>Use this function only for geometries with an M component</para></note>
+ <note><para>Use this function only for linear geometries with an M component</para></note>
<para>The semantic is specified by the <emphasis>ISO/IEC 13249-3 SQL/MM Spatial</emphasis> standard.</para>
@@ -483,17 +484,15 @@ SELECT ST_AsText(
'MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 3),(1 2 3, 5 4 5))'::geometry,
3 ));
- st_astext
----------------------------------
MULTIPOINT M ((1 2 3),(9 4 3),(1 2 3))
</programlisting>
</refsection>
- <!-- Optionally add a "See Also" section -->
<refsection>
<title>See Also</title>
- <para><xref linkend="ST_LocateBetween" />, <xref linkend="ST_LocateBetweenElevations" /></para>
+ <para><xref linkend="ST_LocateBetween" />, <xref linkend="ST_LocateBetweenElevations" />, <xref linkend="ST_InterpolatePoint" /> </para>
</refsection>
</refentry>
@@ -571,7 +570,6 @@ MULTILINESTRING((54.49835019899045 104.53426957938231,58.70056060327303 82.12248
</refsection>
- <!-- Optionally add a "See Also" section -->
<refsection>
<title>See Also</title>
@@ -603,7 +601,7 @@ MULTILINESTRING((54.49835019899045 104.53426957938231,58.70056060327303 82.12248
<title>Description</title>
<para>Returns a geometry (collection) with the portions of a geometry
- that lie in an elevations (Z) range.</para>
+ that lie in an elevation (Z) range.</para>
<para>Clipping a non-convex POLYGON may produce invalid geometry.</para>
@@ -636,7 +634,6 @@ SELECT ST_AsText(
</programlisting>
</refsection>
- <!-- Optionally add a "See Also" section -->
<refsection>
<title>See Also</title>
@@ -645,51 +642,53 @@ SELECT ST_AsText(
</refentry>
- <refentry id="ST_InterpolatePoint">
- <refnamediv>
- <refname>ST_InterpolatePoint</refname>
+ <refentry id="ST_InterpolatePoint">
+ <refnamediv>
+ <refname>ST_InterpolatePoint</refname>
- <refpurpose>Returns the interpolated measure of a geometry closest to a point.</refpurpose>
- </refnamediv>
+ <refpurpose>Returns the interpolated measure of a geometry closest to a point.</refpurpose>
+ </refnamediv>
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>float8 <function>ST_InterpolatePoint</function></funcdef>
- <paramdef><type>geometry </type> <parameter>line</parameter></paramdef>
- <paramdef><type>geometry </type> <parameter>point</parameter></paramdef>
- </funcprototype>
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float8 <function>ST_InterpolatePoint</function></funcdef>
+ <paramdef><type>geometry </type> <parameter>linear_geom_with_measure</parameter></paramdef>
+ <paramdef><type>geometry </type> <parameter>point</parameter></paramdef>
+ </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
+ </funcsynopsis>
+ </refsynopsisdiv>
- <refsection>
- <title>Description</title>
+ <refsection>
+ <title>Description</title>
- <para>Returns the value of the measure dimension of a geometry at the point closed to the provided point.</para>
+ <para>Returns an interpolated measure value of a linear measured geometry
+ at the location closest to the given point.</para>
- <para>Availability: 2.0.0</para>
+ <note><para>Use this function only for linear geometries with an M component</para></note>
- <para>&Z_support;</para>
- </refsection>
+ <para>Availability: 2.0.0</para>
- <refsection>
- <title>Examples</title>
+ <para>&Z_support;</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
- <programlisting>SELECT ST_InterpolatePoint('LINESTRING M (0 0 0, 10 0 20)', 'POINT(5 5)');
- st_interpolatepoint
+ <programlisting>SELECT ST_InterpolatePoint('LINESTRING M (0 0 0, 10 0 20)', 'POINT(5 5)');
---------------------
10
</programlisting>
- </refsection>
+ </refsection>
- <refsection>
- <title>See Also</title>
+ <refsection>
+ <title>See Also</title>
- <para><xref linkend="ST_AddMeasure" />, <xref linkend="ST_LocateAlong" />, <xref linkend="ST_LocateBetween" /></para>
- </refsection>
+ <para><xref linkend="ST_AddMeasure" />, <xref linkend="ST_LocateAlong" />, <xref linkend="ST_LocateBetween" /></para>
+ </refsection>
- </refentry>
+ </refentry>
<refentry id="ST_AddMeasure">
-----------------------------------------------------------------------
Summary of changes:
doc/reference_lrs.xml | 81 +++++++++++++++++++++++++--------------------------
1 file changed, 40 insertions(+), 41 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list