[postgis-tickets] [SCM] PostGIS branch master updated. 3.3.0rc2-80-g1aa5a723c
git at osgeo.org
git at osgeo.org
Tue Sep 13 13:52:19 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 1aa5a723cf03653c19df9a3c34eb94e9079b12d0 (commit)
from 3c6da820cff397a6b19dc02cbb391a14d9cf418e (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 1aa5a723cf03653c19df9a3c34eb94e9079b12d0
Author: Martin Davis <mtnclimb at gmail.com>
Date: Tue Sep 13 13:52:15 2022 -0700
Improve doc for MinBoundingCircle and LongestLine
diff --git a/doc/reference_measure.xml b/doc/reference_measure.xml
index c2c04e0d9..a0fdf7a92 100644
--- a/doc/reference_measure.xml
+++ b/doc/reference_measure.xml
@@ -1254,7 +1254,7 @@ CAST('SPHEROID["GRS_1980",6378137,298.257222101]' As spheroid) As sph_m) as foo
</para>
<para>
If g1 and g2 are the same geometry, returns the line between the two vertices farthest apart in the geometry.
- This is a diameter of the circle computed by <xref linkend="ST_MinimumBoundingCircle"/>
+ The endpoints of the line lie on the circle computed by <xref linkend="ST_MinimumBoundingCircle"/>.
</para>
<para>Availability: 1.5.0</para>
@@ -1306,7 +1306,7 @@ LINESTRING(20 10,105.3073372946034 186.95518130045156)
</imageobject>
<caption><para>Longest line across a single geometry.
The length of the line is equal to the Maximum Distance.
- The line is a diameter of the Minimum Bounding Circle.</para></caption>
+ The endpoints of the line lie on the Minimum Bounding Circle.</para></caption>
</mediaobject>
</informalfigure>
<programlisting>
diff --git a/doc/reference_processing.xml b/doc/reference_processing.xml
index 00fb02e83..cff29187c 100644
--- a/doc/reference_processing.xml
+++ b/doc/reference_processing.xml
@@ -1454,8 +1454,10 @@ LINESTRING Z (-30 -29.7 5,-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 1,-46 -32 11
The approximation can be improved by increasing the number of segments.
For applications where an approximation is not suitable <xref linkend="ST_MinimumBoundingRadius" /> may be used.</para></note>
- <para>This function is not an aggregate. It can be used
- with <xref linkend="ST_Collect" /> to get the minimum bounding circle of a set of geometries.</para>
+ <para>Use with <xref linkend="ST_Collect" /> to get the minimum bounding circle of a set of geometries.</para>
+
+ <para>To compute two points lying on the mimimum circle (the "maximum diameter") use <xref linkend="ST_LongestLine" />.
+ </para>
<para>The ratio of the area of a polygon divided by the area of its Minimum Bounding Circle
is referred to as the <emphasis>Reock compactness score</emphasis>.</para>
@@ -1463,10 +1465,6 @@ LINESTRING Z (-30 -29.7 5,-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 1,-46 -32 11
<para>Availability: 1.4.0</para>
</refsection>
- <refsection>
- <title>See Also</title>
- <para><xref linkend="ST_Collect" />, <xref linkend="ST_MinimumBoundingRadius" /></para>
- </refsection>
<refsection>
<title>Examples</title>
@@ -1499,7 +1497,7 @@ POLYGON((135.59714732062 115,134.384753327498 102.690357210921,130.79416296937 9
</refsection>
<refsection>
<title>See Also</title>
- <para><xref linkend="ST_Collect" />, <xref linkend="ST_MinimumBoundingRadius" /> </para>
+ <para><xref linkend="ST_Collect" />, <xref linkend="ST_MinimumBoundingRadius" />, <xref linkend="ST_LongestLine" /> </para>
</refsection>
</refentry>
@@ -1528,15 +1526,14 @@ POLYGON((135.59714732062 115,134.384753327498 102.690357210921,130.79416296937 9
<listitem><para> <varname>radius</varname> - radius of the circle </para></listitem>
</itemizedlist>
- <para>Use in conjunction with <xref linkend="ST_Collect"/> to get the minimum bounding circle of a set of geometries.</para>
+ <para>Use with <xref linkend="ST_Collect"/> to get the minimum bounding circle of a set of geometries.</para>
+
+ <para>To compute two points lying on the mimimum circle (the "maximum diameter") use <xref linkend="ST_LongestLine" />.
+ </para>
+
<para>Availability - 2.3.0</para>
</refsection>
- <refsection>
- <title>See Also</title>
- <para><xref linkend="ST_Collect" />, <xref linkend="ST_MinimumBoundingCircle" /></para>
- </refsection>
-
<refsection>
<title>Examples</title>
<programlisting>SELECT ST_AsText(center), radius FROM ST_MinimumBoundingRadius('POLYGON((26426 65078,26531 65242,26075 65136,26096 65427,26426 65078))');
@@ -1547,6 +1544,11 @@ POLYGON((135.59714732062 115,134.384753327498 102.690357210921,130.79416296937 9
</programlisting>
</refsection>
+ <refsection>
+ <title>See Also</title>
+ <para><xref linkend="ST_Collect" />, <xref linkend="ST_MinimumBoundingCircle" />, <xref linkend="ST_LongestLine" /></para>
+ </refsection>
+
</refentry>
<refentry id="ST_OrientedEnvelope">
@@ -1579,14 +1581,6 @@ POLYGON((135.59714732062 115,134.384753327498 102.690357210921,130.79416296937 9
</para>
</refsection>
- <refsection>
- <title>See Also</title>
- <para>
- <xref linkend="ST_Envelope" />
- <xref linkend="ST_MinimumBoundingCircle" />
- </para>
- </refsection>
-
<refsection>
<title>Examples</title>
<programlisting>
@@ -1617,6 +1611,14 @@ POLYGON((19.9999999999997 79.9999999999999,33.0769230769229 60.3846153846152,138
</programlisting>
</refsection>
+
+ <refsection>
+ <title>See Also</title>
+ <para>
+ <xref linkend="ST_Envelope" />
+ <xref linkend="ST_MinimumBoundingCircle" />
+ </para>
+ </refsection>
</refentry>
<refentry id="ST_OffsetCurve">
-----------------------------------------------------------------------
Summary of changes:
doc/reference_measure.xml | 4 ++--
doc/reference_processing.xml | 44 +++++++++++++++++++++++---------------------
2 files changed, 25 insertions(+), 23 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list