[SCM] PostGIS branch master updated. 3.5.0-292-g82f059db6
git at osgeo.org
git at osgeo.org
Mon Apr 28 02:59:10 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, master has been updated
via 82f059db639f3f57e5c335801336dd78846a3584 (commit)
via fd2793a622f2f6b36eabd0572eeff5f295202eca (commit)
from 0d16b359f9049379cd69dbfb1a6c0271d1d19cf3 (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 82f059db639f3f57e5c335801336dd78846a3584
Author: Sandro Santilli <strk at kbt.io>
Date: Mon Apr 28 11:57:43 2025 +0200
Update translation template
diff --git a/doc/po/templates/postgis-manual.pot b/doc/po/templates/postgis-manual.pot
index 404044a41..88c256453 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-11-19 11:58+0000\n"
+"POT-Creation-Date: 2025-04-28 09:57+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"
@@ -1824,8 +1824,8 @@ msgstr ""
#. Tag: para
#, no-c-format
msgid ""
-"A plpgsql based geocoder written to work with the <link xlink:href=\"http://"
-"www.census.gov/geo/www/tiger/\">TIGER (Topologically Integrated Geographic "
+"A plpgsql based geocoder written to work with the <link xlink:href=\"https://"
+"www2.census.gov/geo/tiger/\">TIGER (Topologically Integrated Geographic "
"Encoding and Referencing system ) / Line and Master Address database export</"
"link> released by the US Census Bureau."
msgstr ""
@@ -6090,6 +6090,13 @@ msgid ""
"topology (say a spatially-simplified version of the starting topology)."
msgstr ""
+#. Tag: para
+#, no-c-format
+msgid ""
+"If the target topology already exists and you want it dropped upfront you "
+"can pass the <code>--drop-topology</code> switch (since PostGIS-3.6.0)."
+msgstr ""
+
#. Tag: title
#, no-c-format
msgid "PostGIS Installation"
@@ -13758,8 +13765,9 @@ msgstr ""
#. Tag: para
#, no-c-format
msgid ""
-"If the <parameter>tolerance</parameter> parameter is provided, vertices "
-"within the tolerance distance of one another are considered to be duplicates."
+"If a non-zero <parameter>tolerance</parameter> parameter is provided, "
+"vertices within the tolerance distance of one another are considered to be "
+"duplicates. The distance is computed in 2D (XY plane)."
msgstr ""
#. Tag: para
@@ -14460,32 +14468,6 @@ msgid ""
"ALTER SYSTEM</link>"
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"
-msgstr ""
-
#. Tag: refpurpose
#, no-c-format
msgid ""
@@ -14737,6 +14719,26 @@ msgid ""
"keyword:"
msgstr ""
+#. Tag: refpurpose
+#, no-c-format
+msgid ""
+"A boolean configuration to turn logging of GDAL debug messages on and off."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid ""
+"By default, GDAL logging is printed to stderr, and lower level debug "
+"messages are not printed at all. Turning this GUC to true will cause GDAL "
+"logging to be sent into the PostgreSQL logging stream, so you can see more "
+"or less of it by altering the <code>client_min_message</code> PostgreSQL GUC."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Availability: 3.6.0"
+msgstr ""
+
#. Tag: title
#, no-c-format
msgid "Geometry Input"
@@ -19748,7 +19750,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
@@ -20351,12 +20353,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
@@ -20408,7 +20407,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
@@ -20528,9 +20529,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
@@ -20708,8 +20710,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
@@ -20787,7 +20788,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
@@ -20865,7 +20866,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
@@ -20923,14 +20925,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 ""
@@ -20997,7 +20991,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
@@ -24017,11 +24011,6 @@ msgid ""
"geometries, each with its associated value."
msgstr ""
-#. Tag: para
-#, no-c-format
-msgid "Availability: 3.6.0"
-msgstr ""
-
#. Tag: para
#, no-c-format
msgid ""
@@ -32241,6 +32230,11 @@ msgstr ""
msgid "A polygon and its approximate medial axis"
msgstr ""
+#. Tag: para
+#, no-c-format
+msgid ", <xref linkend=\"CG_StraightSkeletonPartition\"/>"
+msgstr ""
+
#. Tag: refpurpose
#, no-c-format
msgid ""
@@ -32340,7 +32334,10 @@ msgstr ""
#. Tag: para
#, no-c-format
-msgid ", <xref linkend=\"CG_StraightSkeleton\"/>"
+msgid ""
+", <xref linkend=\"CG_ExtrudeStraightSkeleton\"/>, <xref "
+"linkend=\"CG_StraightSkeleton\"/>, <xref "
+"linkend=\"CG_StraightSkeletonPartition\"/>"
msgstr ""
#. Tag: para
@@ -32545,6 +32542,13 @@ msgstr ""
msgid "Requires SFCGAL >= 1.3.8 for option use_distance_as_m"
msgstr ""
+#. Tag: para
+#, no-c-format
+msgid ""
+"Note that valid inputs with rings that touch at a single point will raise an "
+"error."
+msgstr ""
+
#. Tag: para
#, no-c-format
msgid "Straight Skeleton of polygon"
@@ -32695,6 +32699,11 @@ msgstr ""
msgid "Availability: 3.6.0 - requires SFCGAL >= 2.0.0."
msgstr ""
+#. Tag: para
+#, no-c-format
+msgid "Straight Skeleton Partition of polygon"
+msgstr ""
+
#. Tag: refpurpose
#, no-c-format
msgid "Computes a 3D buffer around a geometry."
@@ -39463,6 +39472,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 fd2793a622f2f6b36eabd0572eeff5f295202eca
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 master branch (3.6.0dev)
diff --git a/doc/Makefile.in b/doc/Makefile.in
index 4fb616349..3eb117542 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 6c41172c8..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_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"/></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 ca99fec12..c4395a8fa 100644
--- a/doc/xsl-config.xml
+++ b/doc/xsl-config.xml
@@ -165,6 +165,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 | 139 ++++++++++++++++++++----------------
doc/postgis.xml | 1 +
doc/reference_overlay.xml | 71 +++++++++---------
doc/xsl-config.xml | 9 +++
5 files changed, 130 insertions(+), 93 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list