[postgis-tickets] [SCM] PostGIS branch master updated. 3.2.0beta1-15-g85553d7ea
git at osgeo.org
git at osgeo.org
Mon Nov 1 06:36:10 PDT 2021
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 85553d7ea16f3ada83d00e21c25c14b4f6c9612e (commit)
via 53e3ede012c0c1a9b5c995febd71b43384eac335 (commit)
via 7d668c157115f355dd3553117ddb162f49327da4 (commit)
via ba0c250f8d4e690f5cfa42b345f9309cd274c87d (commit)
from 5b765a615dd11505e341248b87d7117a85195e68 (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 85553d7ea16f3ada83d00e21c25c14b4f6c9612e
Merge: 5b765a615 53e3ede01
Author: leoregina <lr at pcorp.us>
Date: Mon Nov 1 09:31:04 2021 -0400
Merge remote-tracking branch 'Kajan/shiftlongitude-doc'
References #5010
commit 53e3ede012c0c1a9b5c995febd71b43384eac335
Author: Lauri Kajan <lauri.kajan at gispo.fi>
Date: Mon Nov 1 08:05:53 2021 +0200
Change to more representational examples
diff --git a/doc/reference_editor.xml b/doc/reference_editor.xml
index c4e31d914..9a0710157 100644
--- a/doc/reference_editor.xml
+++ b/doc/reference_editor.xml
@@ -1769,20 +1769,28 @@ LINESTRING(0 0,1 1,0 0,3 3,4 4)
<refsection>
<title>Examples</title>
- <programlisting>--forward transform
-SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;LINESTRING(179.2 12.2, 180.3 12.8)'::geometry))
+ <programlisting>--single point forward transformation
+SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;POINT(270 0)'::geometry))
st_astext
----------
-LINESTRING(179.2 12.2,-179.7 12.8)
+POINT(-90 0)
---reverse transform
-SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;LINESTRING(179.2 12.2,-179.7 12.8)'::geometry))
+--single point reverse transformation
+SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;POINT(-90 0)'::geometry))
st_astext
----------
-LINESTRING(179.2 12.2, 180.3 12.8)
+POINT(270 0)
+
+
+--for linestrings the functions affects only to the sufficient coordinates
+SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;LINESTRING(174 12, 182 13)'::geometry))
+
+st_astext
+----------
+LINESTRING(174 12,-178 13)
</programlisting>
</refsection>
commit 7d668c157115f355dd3553117ddb162f49327da4
Author: Lauri Kajan <lauri.kajan at gispo.fi>
Date: Mon Nov 1 08:04:37 2021 +0200
Reword the description to be specific with terms
diff --git a/doc/reference_editor.xml b/doc/reference_editor.xml
index f81250475..c4e31d914 100644
--- a/doc/reference_editor.xml
+++ b/doc/reference_editor.xml
@@ -1733,7 +1733,7 @@ LINESTRING(0 0,1 1,0 0,3 3,4 4)
<refnamediv>
<refname>ST_ShiftLongitude</refname>
- <refpurpose>Swaps longitude coordinates of a geometry between -180..180 and 0..360.</refpurpose>
+ <refpurpose>Shifts the longitude coordinates of a geometry between -180..180 and 0..360.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -1748,8 +1748,8 @@ LINESTRING(0 0,1 1,0 0,3 3,4 4)
<refsection>
<title>Description</title>
- <para>Reads every point/vertex in a geometry, and swaps its longitude coordinate from -180..0 to 180..360 and vice versa if between these ranges.
- This function is symmetrical so the result is a 0..360 version of a -180..180 data and -180..180 version of a 0..360 data.
+ <para>Reads every point/vertex in a geometry, and shifts its longitude coordinate from -180..0 to 180..360 and vice versa if between these ranges.
+ This function is symmetrical so the result is a 0..360 representation of a -180..180 data and a -180..180 representation of a 0..360 data.
</para>
<note><para>This is only useful for data with coordinates in
longitude/latitude; e.g. SRID 4326 (WGS 84 geographic)</para></note>
commit ba0c250f8d4e690f5cfa42b345f9309cd274c87d
Author: Lauri Kajan <lauri.kajan at gispo.fi>
Date: Thu Oct 21 09:41:26 2021 +0300
Clarify ST_ShiftLongitude docs
The ST_ShiftLongitude function behave symmetrical with inverse
and reverse transformations. Clarify this in the docs.
diff --git a/doc/reference_editor.xml b/doc/reference_editor.xml
index 90c7f6dd1..f81250475 100644
--- a/doc/reference_editor.xml
+++ b/doc/reference_editor.xml
@@ -1733,14 +1733,14 @@ LINESTRING(0 0,1 1,0 0,3 3,4 4)
<refnamediv>
<refname>ST_ShiftLongitude</refname>
- <refpurpose>Shifts a geometry with geographic coordinates between -180..180 and 0..360.</refpurpose>
+ <refpurpose>Swaps longitude coordinates of a geometry between -180..180 and 0..360.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcprototype>
<funcdef>geometry <function>ST_ShiftLongitude</function></funcdef>
- <paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>
+ <paramdef><type>geometry </type> <parameter>geom</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
@@ -1748,9 +1748,9 @@ LINESTRING(0 0,1 1,0 0,3 3,4 4)
<refsection>
<title>Description</title>
- <para>Reads every point/vertex in a geometry, and if the longitude coordinate is <0, adds 360
- to it. The result is a 0-360 version of the data to be
- plotted in a 180 centric map</para>
+ <para>Reads every point/vertex in a geometry, and swaps its longitude coordinate from -180..0 to 180..360 and vice versa if between these ranges.
+ This function is symmetrical so the result is a 0..360 version of a -180..180 data and -180..180 version of a 0..360 data.
+ </para>
<note><para>This is only useful for data with coordinates in
longitude/latitude; e.g. SRID 4326 (WGS 84 geographic)</para></note>
@@ -1769,19 +1769,20 @@ LINESTRING(0 0,1 1,0 0,3 3,4 4)
<refsection>
<title>Examples</title>
- <programlisting>--3d points
-SELECT ST_AsEWKT(ST_ShiftLongitude(ST_GeomFromEWKT('SRID=4326;POINT(-118.58 38.38 10)'))) As geomA,
- ST_AsEWKT(ST_ShiftLongitude(ST_GeomFromEWKT('SRID=4326;POINT(241.42 38.38 10)'))) As geomb
-geomA geomB
----------- -----------
-SRID=4326;POINT(241.42 38.38 10) SRID=4326;POINT(-118.58 38.38 10)
+ <programlisting>--forward transform
+SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;LINESTRING(179.2 12.2, 180.3 12.8)'::geometry))
+
+st_astext
+----------
+LINESTRING(179.2 12.2,-179.7 12.8)
+
---regular line string
-SELECT ST_AsText(ST_ShiftLongitude(ST_GeomFromText('LINESTRING(-118.58 38.38, -118.20 38.45)')))
+--reverse transform
+SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;LINESTRING(179.2 12.2,-179.7 12.8)'::geometry))
st_astext
----------
-LINESTRING(241.42 38.38,241.8 38.45)
+LINESTRING(179.2 12.2, 180.3 12.8)
</programlisting>
</refsection>
-----------------------------------------------------------------------
Summary of changes:
doc/reference_editor.xml | 37 +++++++++++++++++++++++--------------
1 file changed, 23 insertions(+), 14 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list