[SCM] PostGIS branch stable-3.5 updated. 3.5.2-34-gbcd3834a2
git at osgeo.org
git at osgeo.org
Mon Apr 28 03:02:26 PDT 2025
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, stable-3.5 has been updated
via bcd3834a2e0e976a76d0869635a7efee3e40ee8a (commit)
via 6a3d5f0eb5f1268f3113e5983c42a8c40c9de827 (commit)
from 9f41287f1e982479611610a527ddf1d9d61e81f4 (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 bcd3834a2e0e976a76d0869635a7efee3e40ee8a
Author: Sandro Santilli <strk at kbt.io>
Date: Mon Apr 28 12:02:08 2025 +0200
Update translation template
diff --git a/doc/po/templates/postgis-manual.pot b/doc/po/templates/postgis-manual.pot
index 20d013d4f..c38cffcbc 100644
--- a/doc/po/templates/postgis-manual.pot
+++ b/doc/po/templates/postgis-manual.pot
@@ -6,7 +6,7 @@ msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: https://bugs.kde.org\n"
-"POT-Creation-Date: 2024-09-25 17:55+0000\n"
+"POT-Creation-Date: 2025-04-28 10:01+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
@@ -7986,6 +7986,11 @@ msgstr ""
msgid "David Techer"
msgstr ""
+#. Tag: member
+#, no-c-format
+msgid "Dian M Fay"
+msgstr ""
+
#. Tag: member
#, no-c-format
msgid "Dmitry Vasilyev"
@@ -8545,7 +8550,9 @@ msgstr ""
#. Tag: link
#, no-c-format
-msgid "INIA-CSIC"
+msgid ""
+">The National Institute for Agricultural and Food Research and Technology "
+"(INIA-CSIC)"
msgstr ""
#. Tag: link
@@ -14446,30 +14453,13 @@ msgid ""
"set at global or database level."
msgstr ""
-#. Tag: refpurpose
-#, no-c-format
-msgid ""
-"The backend to service a function where GEOS and SFCGAL overlap. Options: "
-"geos or sfcgal. Defaults to geos."
-msgstr ""
-
#. Tag: para
#, no-c-format
msgid ""
-"This GUC is only relevant if you compiled PostGIS with sfcgal support. By "
-"default <varname>geos</varname> backend is used for functions where both "
-"GEOS and SFCGAL have the same named function. This variable allows you to "
-"override and make sfcgal the backend to service the request."
-msgstr ""
-
-#. Tag: para
-#, no-c-format
-msgid "Sets backend just for life of connection"
-msgstr ""
-
-#. Tag: para
-#, no-c-format
-msgid "Sets backend for new connections to database"
+"For more examples of usage refer to <link xlink:href=\"https://www."
+"postgresql.org/docs/current/sql-set.html\">SQL SET</link> and <link xlink:"
+"href=\"https://www.postgresql.org/docs/current/sql-altersystem.html\">SQL "
+"ALTER SYSTEM</link>"
msgstr ""
#. Tag: refpurpose
@@ -14611,30 +14601,22 @@ msgstr ""
#. Tag: para
#, no-c-format
-msgid "Set and reset <varname>postgis.gdal_enabled_drivers</varname>"
+msgid ""
+"To set and reset <varname>postgis.gdal_enabled_drivers</varname> for current "
+"session"
msgstr ""
#. Tag: para
#, no-c-format
-msgid "Sets backend for all new connections to database"
+msgid "Set for all new connections to a specific database to specific drivers"
msgstr ""
#. Tag: para
#, no-c-format
msgid ""
-"Sets default enabled drivers for all new connections to server. Requires "
-"super user access and PostgreSQL 9.4+. Also note that database, session, and "
-"user settings override this."
-msgstr ""
-
-#. Tag: para
-#, no-c-format
-msgid "Enable all GDAL Drivers"
-msgstr ""
-
-#. Tag: para
-#, no-c-format
-msgid "Disable all GDAL Drivers"
+"Setting for whole database cluster to enable all drivers. Requires super "
+"user access. Also note that database, session, and user settings override "
+"this."
msgstr ""
#. Tag: para
@@ -14691,14 +14673,14 @@ msgstr ""
#. Tag: para
#, no-c-format
-msgid "Set for specific database"
+msgid "Set for all new connections to a specific database"
msgstr ""
#. Tag: para
#, no-c-format
msgid ""
-"Setting for whole database cluster. You need to reconnect to the database "
-"for changes to take effect."
+"Setting for whole database cluster. Requires super user access. Also note "
+"that database, session, and user settings override this."
msgstr ""
#. Tag: refpurpose
@@ -19742,7 +19724,7 @@ msgstr ""
#, no-c-format
msgid ""
"Canonical example for a Web Mercator tile using a computed tile bounds to "
-"query and clip geometry."
+"query and clip geometry. This assumes the data.geom column has srid of 4326."
msgstr ""
#. Tag: para
@@ -20345,12 +20327,9 @@ msgid ""
"ST_Difference(A, B) always returns a portion of A."
msgstr ""
-#. Tag: para
+#. Tag: refsection
#, no-c-format
-msgid ""
-"If the optional <code>gridSize</code> argument is provided, the inputs are "
-"snapped to a grid of the given size, and the result vertices are computed on "
-"that same grid. (Requires GEOS-3.9.0 or higher)"
+msgid "&overlay_gridsize_arg;"
msgstr ""
#. Tag: para
@@ -20402,7 +20381,9 @@ msgstr ""
#. Tag: para
#, no-c-format
-msgid ", <xref linkend=\"ST_Intersection\"/>, <xref linkend=\"ST_Union\"/>"
+msgid ""
+", <xref linkend=\"ST_Intersection\"/>, <xref linkend=\"ST_Union\"/>, <xref "
+"linkend=\"ST_ReducePrecision\"/>"
msgstr ""
#. Tag: refpurpose
@@ -20522,9 +20503,10 @@ msgstr ""
#, no-c-format
msgid ""
", <xref linkend=\"ST_Difference\"/>, <xref linkend=\"ST_Union\"/>, <xref "
-"linkend=\"ST_Dimension\"/>, <xref linkend=\"ST_Dump\"/>, <xref "
-"linkend=\"ST_Force2D\"/>, <xref linkend=\"ST_SymDifference\"/>, <xref "
-"linkend=\"ST_Intersects\"/>, <xref linkend=\"ST_Multi\"/>"
+"linkend=\"ST_ClipByBox2D\"/>, <xref linkend=\"ST_Dimension\"/>, <xref "
+"linkend=\"ST_Dump\"/>, <xref linkend=\"ST_Force2D\"/>, <xref "
+"linkend=\"ST_SymDifference\"/>, <xref linkend=\"ST_Intersects\"/>, <xref "
+"linkend=\"ST_Multi\"/>, <xref linkend=\"ST_ReducePrecision\"/>"
msgstr ""
#. Tag: refpurpose
@@ -20702,8 +20684,7 @@ msgstr ""
#, no-c-format
msgid ""
"<code>max_vertices</code> must be 5 or more, as 5 points are needed to "
-"represent a closed box. <code>gridSize</code> can be specified to have "
-"clipping work in fixed-precision space (requires GEOS-3.9.0+)."
+"represent a closed box."
msgstr ""
#. Tag: para
@@ -20781,7 +20762,7 @@ msgstr ""
#, no-c-format
msgid ""
", <xref linkend=\"ST_Segmentize\"/>, <xref linkend=\"ST_Split\"/>, <xref "
-"linkend=\"ST_NPoints\"/>"
+"linkend=\"ST_NPoints\"/>, <xref linkend=\"ST_ReducePrecision\"/>"
msgstr ""
#. Tag: refpurpose
@@ -20859,7 +20840,8 @@ msgstr ""
#, no-c-format
msgid ""
", <xref linkend=\"ST_MemUnion\"/>, <xref linkend=\"ST_MakeValid\"/>, <xref "
-"linkend=\"ST_Collect\"/>, <xref linkend=\"ST_Node\"/>"
+"linkend=\"ST_Collect\"/>, <xref linkend=\"ST_Node\"/>, <xref "
+"linkend=\"ST_ReducePrecision\"/>"
msgstr ""
#. Tag: refpurpose
@@ -20917,14 +20899,6 @@ msgid ""
"must-faster-unions-in-postgis-14.html</link>"
msgstr ""
-#. Tag: para
-#, no-c-format
-msgid ""
-"A <code>gridSize</code> can be specified to work in fixed-precision space. "
-"The inputs are snapped to a grid of the given size, and the result vertices "
-"are computed on that same grid. (Requires GEOS-3.9.0 or higher)"
-msgstr ""
-
#. Tag: para
#, no-c-format
msgid ""
@@ -20991,7 +20965,7 @@ msgstr ""
msgid ""
", <xref linkend=\"ST_UnaryUnion\"/>, <xref linkend=\"ST_MemUnion\"/>, <xref "
"linkend=\"ST_Intersection\"/>, <xref linkend=\"ST_Difference\"/>, <xref "
-"linkend=\"ST_SymDifference\"/>"
+"linkend=\"ST_SymDifference\"/>, <xref linkend=\"ST_ReducePrecision\"/>"
msgstr ""
#. Tag: title
@@ -34443,12 +34417,12 @@ msgstr ""
#. Tag: title
#, no-c-format
-msgid "PostGIS 3.5.0"
+msgid "PostGIS 3.5.2"
msgstr ""
#. Tag: para
#, no-c-format
-msgid "2024/09/25"
+msgid "2025/01/18"
msgstr ""
#. Tag: para
@@ -34459,6 +34433,174 @@ msgid ""
"of all SFCGAL features, SFCGAL 1.5.0+ is needed."
msgstr ""
+#. Tag: title
+#, no-c-format
+msgid "Bug Fixes"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5677\">#5677</"
+"link>, Retain SRID during unary union (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5833\">#5833</"
+"link>, pg_upgrade fix for postgis_sfcgal (Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5564\">#5564</"
+"link>, BRIN crash fix and support for parallel in PG17+ (Paul Ramsey, Regina "
+"Obe)"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "PostGIS 3.5.1"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "2024/12/22"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Breaking Changes"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5792\">#5792</"
+"link>, [topology] Prevent topology corruption with TopoGeo_addPoint near "
+"almost collinear edges (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5795\">#5795</"
+"link>, [topology] Fix ST_NewEdgesSplit can cause invalid topology (Björn "
+"Harrtell)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5794\">#5794</"
+"link>, [topology] Fix crash in TopoGeo_addPoint (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5785\">#5785</"
+"link>, [raster] ST_MapAlgebra segfaults when expression references a "
+"supernumerary rast argument (Dian M Fay)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5787\">#5787</"
+"link>, Check that ST_ChangeEdgeGeom doesn't change winding of rings (Sandro "
+"Santilli)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5791\">#5791</"
+"link>, Add legacy stubs for old transaction functions to allow pg_upgrade "
+"(Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5800\">#5800</"
+"link>, PROJ compiled version reading the wrong minor and micro (Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5790\">#5790</"
+"link>, Non-schema qualified calls causing issue with materialized views "
+"(Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5812\">#5812</"
+"link>, Performance regression in ST_Within (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5815\">#5815</"
+"link>, Remove hash/merge promise from <> operator (Paul Ramsey)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5823\">#5823</"
+"link>, Build support for Pg18 (Paul Ramsey)"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Enhancements"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5782\">#5782</"
+"link>, Improve robustness of min distance calculation (Sandro Santilli)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"[topology] Speedup topology building when closing large rings with many "
+"holes (Björn Harrtell)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5810\">#5810</"
+"link>, Update tiger geocoder to handle TIGER 2024 data (Regina Obe)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5799\">#5799</"
+"link>, make ST_TileEnvelope clip envelopes to tile plane extent (Paul Ramsey)"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "PostGIS 3.5.0"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "2024/09/25"
+msgstr ""
+
#. Tag: para
#, no-c-format
msgid "Many thanks to our translation teams, in particular:"
@@ -34479,11 +34621,6 @@ msgstr ""
msgid "Vincent Bre (French Team)"
msgstr ""
-#. Tag: title
-#, no-c-format
-msgid "Breaking Changes"
-msgstr ""
-
#. Tag: para
#, no-c-format
msgid ""
@@ -34542,7 +34679,8 @@ msgstr ""
msgid ""
"<link xlink:href=\"https://trac.osgeo.org/postgis/ticket/5496\">#5496</"
"link>, ST_Clip all variants replaced, will require rebuilding of "
-"materialized views that use them (Regina Obe)"
+"materialized views that use them (funding from The National Institute for "
+"Agricultural and Food Research and Technology (INIA-CSIC)), Regina Obe"
msgstr ""
#. Tag: para
@@ -34730,11 +34868,6 @@ msgid ""
"pull/768\">GH-768</link>, ST_RemoveSmallParts (Sam Peters)"
msgstr ""
-#. Tag: title
-#, no-c-format
-msgid "Enhancements"
-msgstr ""
-
#. Tag: para
#, no-c-format
msgid ""
@@ -39542,6 +39675,16 @@ msgstr ""
msgid "This function supports 3d and will not drop the z-index."
msgstr ""
+#. Tag: para
+#, no-c-format
+msgid ""
+"If the optional <code>gridSize</code> parameter is given (GEOS-3.9.0 or "
+"higher required), all result vertices are guaranteed to fall on a grid of "
+"the specified size. For the operation to give predictable results all the "
+"input vertices must fall already on the specified grid, see <xref "
+"linkend=\"ST_ReducePrecision\"/>."
+msgstr ""
+
#. Tag: para
#, no-c-format
msgid "New in this release"
commit 6a3d5f0eb5f1268f3113e5983c42a8c40c9de827
Author: Sandro Santilli <strk at kbt.io>
Date: Mon Apr 28 11:09:17 2025 +0200
Reword paragraph about gridSize parameter of overlay operations
The text erroneously reported that the input geometries would
be snapped to the given grid, while instead it is EXPECTED to
be already snapped.
This change turns the corrisponding documentation snippet into
a reusable tag and uses it in all appropriate overlay operation
sections.
References #5885 in 3.5 branch (3.5.3dev)
diff --git a/doc/Makefile.in b/doc/Makefile.in
index 41b9ffd12..e5ad8365e 100644
--- a/doc/Makefile.in
+++ b/doc/Makefile.in
@@ -232,7 +232,8 @@ TAG_GENERATED_SOURCES = \
sfs_compliant.tag \
sqlmm_compliant.tag \
T_support.tag \
- Z_support.tag
+ Z_support.tag \
+ overlay_gridsize_arg.tag
XML_GENERATED_SOURCES = \
$(XSL_GENERATED_SOURCES)
diff --git a/doc/postgis.xml b/doc/postgis.xml
index fbe169b2e..185df166d 100644
--- a/doc/postgis.xml
+++ b/doc/postgis.xml
@@ -73,6 +73,7 @@
<!ENTITY T_support SYSTEM "T_support.tag">
<!ENTITY index_aware SYSTEM "index_aware.tag">
<!ENTITY geography_transform SYSTEM "geography_transform.tag">
+<!ENTITY overlay_gridsize_arg SYSTEM "overlay_gridsize_arg.tag">
<!-- entity definitions for the postgis_special section -->
<!ENTITY postgis_special SYSTEM "postgis_special.xml">
diff --git a/doc/reference_overlay.xml b/doc/reference_overlay.xml
index 4d0a2bde0..a380b6447 100644
--- a/doc/reference_overlay.xml
+++ b/doc/reference_overlay.xml
@@ -90,11 +90,7 @@ SELECT ST_ClipByBox2D(geom, ST_MakeEnvelope(0,0,10,10)) FROM mytab;
<note><para>This is the only overlay function where input order matters.
ST_Difference(A, B) always returns a portion of A.</para></note>
- <para>
-If the optional <code>gridSize</code> argument is provided, the inputs are
-snapped to a grid of the given size, and the result vertices are computed
-on that same grid. (Requires GEOS-3.9.0 or higher)
- </para>
+ &overlay_gridsize_arg;
<para>Performed by the GEOS module</para>
<para role="enhanced" conformance="3.1.0">Enhanced: 3.1.0 accept a gridSize parameter.</para>
@@ -168,7 +164,12 @@ MULTIPOINT(-118.6 38.329 6,-118.58 38.38 5)
<refsection>
<title>See Also</title>
- <para><xref linkend="ST_SymDifference"/>, <xref linkend="ST_Intersection"/>, <xref linkend="ST_Union"/></para>
+ <para>
+<xref linkend="ST_SymDifference"/>,
+<xref linkend="ST_Intersection"/>,
+<xref linkend="ST_Union"/>,
+<xref linkend="ST_ReducePrecision"/>
+ </para>
</refsection>
</refentry>
@@ -220,11 +221,7 @@ Computes a geometry representing the shared portion of geometries A and B.
<para>If the geometries have no points in common (i.e. are disjoint)
then an empty atomic geometry of appropriate type is returned.</para>
- <para>
-If the optional <code>gridSize</code> argument is provided, the inputs are
-snapped to a grid of the given size, and the result vertices are computed
-on that same grid. (Requires GEOS-3.9.0 or higher)
- </para>
+ &overlay_gridsize_arg;
<para>ST_Intersection in conjunction with <xref linkend="ST_Intersects"/> is useful for clipping geometries such as in bounding box, buffer, or region
queries where you only require the portion of a geometry that is inside a country or region of interest.</para>
@@ -301,7 +298,19 @@ from ST_GeomFromText('LINESTRING Z (2 2 6,1.5 1.5 7,1 1 8,0.5 0.5 8,0 0 10)') A
</refsection>
<refsection>
<title>See Also</title>
- <para><xref linkend="ST_3DIntersection"/>, <xref linkend="ST_Difference"/>, <xref linkend="ST_Union"/>, <xref linkend="ST_Dimension"/>, <xref linkend="ST_Dump"/>, <xref linkend="ST_Force2D"/>, <xref linkend="ST_SymDifference"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Multi"/></para>
+ <para>
+<xref linkend="ST_3DIntersection"/>,
+<xref linkend="ST_Difference"/>,
+<xref linkend="ST_Union"/>,
+<xref linkend="ST_ClipByBox2D"/>,
+<xref linkend="ST_Dimension"/>,
+<xref linkend="ST_Dump"/>,
+<xref linkend="ST_Force2D"/>,
+<xref linkend="ST_SymDifference"/>,
+<xref linkend="ST_Intersects"/>,
+<xref linkend="ST_Multi"/>,
+<xref linkend="ST_ReducePrecision"/>
+ </para>
</refsection>
</refentry>
@@ -634,8 +643,10 @@ SELECT ST_AsText( ST_Split( ST_Snap(line, point, 1), point)) AS snapped_split,
</para>
<para>
<code>max_vertices</code> must be 5 or more, as 5 points are needed to represent a closed box.
- <code>gridSize</code> can be specified to have clipping work in fixed-precision space (requires GEOS-3.9.0+).
</para>
+
+ &overlay_gridsize_arg;
+
<para>
Point-in-polygon and other spatial operations are normally faster for indexed subdivided datasets.
Since the bounding boxes for the parts usually cover a smaller area than the original geometry bbox,
@@ -757,7 +768,8 @@ CREATE TABLE subdivided_geoms AS
<xref linkend="ST_ClipByBox2D"/>,
<xref linkend="ST_Segmentize"/>,
<xref linkend="ST_Split"/>,
-<xref linkend="ST_NPoints"/>
+<xref linkend="ST_NPoints"/>,
+<xref linkend="ST_ReducePrecision"/>
</para>
</refsection>
</refentry>
@@ -790,11 +802,7 @@ CREATE TABLE subdivided_geoms AS
It is called a symmetric difference because <code>ST_SymDifference(A,B) = ST_SymDifference(B,A)</code>.
</para>
- <para>
-If the optional <code>gridSize</code> argument is provided, the inputs are
-snapped to a grid of the given size, and the result vertices are computed
-on that same grid. (Requires GEOS-3.9.0 or higher)
- </para>
+ &overlay_gridsize_arg;
<para>Performed by the GEOS module</para>
@@ -873,7 +881,12 @@ MULTILINESTRING((1 3 2.75,1 4 2),(1 1 3,1 2 2.25))
<refsection>
<title>See Also</title>
- <para><xref linkend="ST_Difference"/>, <xref linkend="ST_Intersection"/>, <xref linkend="ST_Union"/></para>
+ <para>
+<xref linkend="ST_Difference"/>,
+<xref linkend="ST_Intersection"/>,
+<xref linkend="ST_Union"/>,
+<xref linkend="ST_ReducePrecision"/>
+ </para>
</refsection>
</refentry>
@@ -926,11 +939,7 @@ MULTILINESTRING((1 3 2.75,1 4 2),(1 1 3,1 2 2.25))
striking a balance between ST_Union and <xref linkend="ST_MemUnion"/>.
</para>
- <para>
- If the optional <code>gridSize</code> argument is provided, the inputs are
- snapped to a grid of the given size, and the result vertices are computed
- on that same grid. (Requires GEOS-3.9.0 or higher)
- </para>
+ &overlay_gridsize_arg;
<para>&Z_support; However, the result is computed using XY only.
The result Z values are copied, averaged or interpolated.</para>
@@ -950,7 +959,8 @@ MULTILINESTRING((1 3 2.75,1 4 2),(1 1 3,1 2 2.25))
<xref linkend="ST_MemUnion"/>,
<xref linkend="ST_MakeValid"/>,
<xref linkend="ST_Collect"/>,
- <xref linkend="ST_Node"/>
+ <xref linkend="ST_Node"/>,
+ <xref linkend="ST_ReducePrecision"/>
</para>
</refsection>
</refentry>
@@ -1019,11 +1029,7 @@ MULTILINESTRING((1 3 2.75,1 4 2),(1 1 3,1 2 2.25))
<para>The ST_Union array and set variants use the fast Cascaded Union algorithm described in <link xlink:href="http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html">http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html</link>
</para>
- <para>A <code>gridSize</code> can be specified to work in fixed-precision space.
- The inputs are snapped to a grid of the given size, and the result vertices are computed
- on that same grid.
- (Requires GEOS-3.9.0 or higher)
- </para>
+ &overlay_gridsize_arg;
<note><para><xref linkend="ST_Collect"/> may sometimes be used in place of ST_Union,
if the result is not required to be non-overlapping.
@@ -1125,7 +1131,8 @@ MULTILINESTRING((3 4,4 5),(1 2,3 4))
<xref linkend="ST_MemUnion"/>,
<xref linkend="ST_Intersection"/>,
<xref linkend="ST_Difference"/>,
- <xref linkend="ST_SymDifference"/>
+ <xref linkend="ST_SymDifference"/>,
+ <xref linkend="ST_ReducePrecision"/>
</para>
</refsection>
</refentry>
diff --git a/doc/xsl-config.xml b/doc/xsl-config.xml
index f201d8cd5..8b04bc682 100644
--- a/doc/xsl-config.xml
+++ b/doc/xsl-config.xml
@@ -164,6 +164,15 @@
</inlinemediaobject>
This function supports 3d and will not drop the z-index.
</para>
+
+ <para role="tag_overlay_gridsize_arg">
+ <para>
+ If the optional <code>gridSize</code> parameter is given (GEOS-3.9.0 or higher required),
+ all result vertices are guaranteed to fall on a grid of the specified
+ size. For the operation to give predictable results all the input vertices
+ must fall already on the specified grid, see <xref linkend="ST_ReducePrecision"/>.
+ </para>
+ </para>
</tags>
<cheatsheets>
-----------------------------------------------------------------------
Summary of changes:
doc/Makefile.in | 3 +-
doc/po/templates/postgis-manual.pot | 295 ++++++++++++++++++++++++++----------
doc/postgis.xml | 1 +
doc/reference_overlay.xml | 71 +++++----
doc/xsl-config.xml | 9 ++
5 files changed, 270 insertions(+), 109 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list