[postgis-tickets] [SCM] PostGIS branch master updated. 3.3.0rc2-302-g065801907
git at osgeo.org
git at osgeo.org
Mon Oct 31 20:05:03 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 065801907c0f44d0700cf9ba95a0fed176e8fdeb (commit)
from ce9f8b5e3039ebf6bef7fb7c23059ba211ea29cb (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 065801907c0f44d0700cf9ba95a0fed176e8fdeb
Author: Regina Obe <lr at pcorp.us>
Date: Mon Oct 31 23:04:07 2022 -0400
1. Add availability information for ST_TransformPipeline and
ST_InversePipeline
2. Break ST_TransformPipeline and ST_InversePipeline into two separate
entries
diff --git a/doc/reference_srs.xml b/doc/reference_srs.xml
index f03776c7d..103bd503d 100644
--- a/doc/reference_srs.xml
+++ b/doc/reference_srs.xml
@@ -9,6 +9,84 @@
<title>Spatial Reference System Functions</title>
+ <refentry id="ST_InverseTransformPipeline">
+ <refnamediv>
+ <refname>ST_InverseTransformPipeline</refname>
+
+ <refpurpose>Return a new geometry with coordinates transformed to
+ a different spatial reference system using the reverse of a defined coordinate
+ transformation pipeline.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>geometry <function>ST_InverseTransformPipeline</function></funcdef>
+ <paramdef><type>geometry </type> <parameter>geom</parameter></paramdef>
+ <paramdef><type>text </type> <parameter>pipeline</parameter></paramdef>
+ <paramdef choice="opt"><type>integer </type> <parameter>to_srid</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>
+ Return a new geometry with coordinates transformed to a different spatial reference system
+ using the reverse of a defined coordinate transformation pipeline.
+ </para>
+
+ <para> Refer to <xref linkend="ST_TransformPipeline" /> for details on writing a transformation pipeline.</para>
+
+ <para>Availability: 3.4.0</para>
+
+ <para>
+ The SRID of the input geometry is ignored, and the SRID of the output geometry will be set to
+ zero unless a value is provided via the optional <varname>to_srid</varname> parameter. When
+ using <xref linkend="ST_TransformPipeline" /> the pipeline is executed in a forward direction. Using
+ `ST_InverseTransformPipeline()` the pipeline is executed in the inverse direction.</para>
+
+ <para>Transforms using pipelines are a specialised version of <xref linkend="ST_Transform" />.
+ In most cases `ST_Transform` will choose the correct operations to convert between coordinate
+ systems, and should be preferred.</para>
+
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+ <para>Change WGS 84 long lat to UTM 31N using the EPSG:16031 conversion</para>
+ <programlisting>
+-- Inverse direction
+SELECT ST_AsText(ST_InverseTransformPipeline('POINT(426857.9877165967 5427937.523342293)'::geometry,
+ 'urn:ogc:def:coordinateOperation:EPSG::16031')) AS wgs_geom;
+
+ wgs_geom
+----------------------------
+ POINT(2 48.99999999999999)
+(1 row)
+ </programlisting>
+
+ <para>GDA2020 example.</para>
+ <programlisting>
+-- using ST_Transform with automatic selection of a conversion pipeline.
+SELECT ST_AsText(ST_Transform('SRID=4939;POINT(143.0 -37.0)'::geometry, 7844)) AS gda2020_auto;
+
+ gda2020_auto
+-----------------------------------------------
+ POINT(143.00000635638918 -36.999986706128176)
+(1 row)
+ </programlisting>
+ </refsection>
+
+ <!-- Optionally add a "See Also" section -->
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="ST_Transform" />, <xref linkend="ST_TransformPipeline" /></para>
+ </refsection>
+ </refentry>
+
<refentry id="ST_SetSRID">
<refnamediv>
<refname>ST_SetSRID</refname>
@@ -287,21 +365,14 @@ CREATE INDEX idx_geom_26986_parcels
</refnamediv>
<refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>geometry <function>ST_TransformPipeline</function></funcdef>
- <paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>
- <paramdef><type>text </type> <parameter>pipeline</parameter></paramdef>
- <paramdef choice="opt"><type>integer </type> <parameter>to_srid</parameter></paramdef>
- </funcprototype>
-
- <funcprototype>
- <funcdef>geometry <function>ST_InverseTransformPipeline</function></funcdef>
- <paramdef><type>geometry </type> <parameter>geom</parameter></paramdef>
- <paramdef><type>text </type> <parameter>pipeline</parameter></paramdef>
- <paramdef choice="opt"><type>integer </type> <parameter>to_srid</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>geometry <function>ST_TransformPipeline</function></funcdef>
+ <paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>
+ <paramdef><type>text </type> <parameter>pipeline</parameter></paramdef>
+ <paramdef choice="opt"><type>integer </type> <parameter>to_srid</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
</refsynopsisdiv>
<refsection>
@@ -338,12 +409,13 @@ CREATE INDEX idx_geom_26986_parcels
</listitem>
</itemizedlist>
</para>
+ <para>Availability: 3.4.0</para>
<para>
The SRID of the input geometry is ignored, and the SRID of the output geometry will be set to
zero unless a value is provided via the optional <varname>to_srid</varname> parameter. When
using `ST_TransformPipeline()` the pipeline is executed in a forward direction. Using
- `ST_InverseTransformPipeline()` the pipeline is executed in the inverse direction.</para>
+ <xref linkend="ST_InverseTransformPipeline" /> the pipeline is executed in the inverse direction.</para>
<para>Transforms using pipelines are a specialised version of <xref linkend="ST_Transform" />.
In most cases `ST_Transform` will choose the correct operations to convert between coordinate
@@ -413,7 +485,7 @@ SELECT ST_AsText(ST_TransformPipeline('SRID=4939;POINT(143.0 -37.0)'::geometry,
<refsection>
<title>See Also</title>
- <para><xref linkend="ST_Transform" /></para>
+ <para><xref linkend="ST_Transform" />, <xref linkend="ST_InverseTransformPipeline" /></para>
</refsection>
</refentry>
-----------------------------------------------------------------------
Summary of changes:
doc/reference_srs.xml | 106 ++++++++++++++++++++++++++++++++++++++++++--------
1 file changed, 89 insertions(+), 17 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list