[postgis-tickets] [SCM] PostGIS branch master updated. 3.2.0-449-ge99891ab4
git at osgeo.org
git at osgeo.org
Tue Feb 1 10:34:03 PST 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 e99891ab407b42c480589a7d336f1f9c342c7db3 (commit)
from 62aee6f13c910d5bd221c255bd34bd74cc0e04ef (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 e99891ab407b42c480589a7d336f1f9c342c7db3
Author: Martin Davis <mtnclimb at gmail.com>
Date: Tue Feb 1 10:33:59 2022 -0800
Improve doc ST_Azimuth section
diff --git a/doc/html/image_src/st_azimuth01.wkt b/doc/html/image_src/st_azimuth01.wkt
index 8737ec41c..4ef81653f 100644
--- a/doc/html/image_src/st_azimuth01.wkt
+++ b/doc/html/image_src/st_azimuth01.wkt
@@ -1,5 +1,5 @@
-ArgB;LINESTRING(25 45,25 119.33)
-ArgB;POINT(25 45)
-ArgA;POINT(75 100)
-Highlight;LINESTRING(25 119.33,32.29 118.97,39.50 117.90,46.58 116.13,53.45 113.67,60.047 110.55,66.31 106.8,72.17 102.45,75 100)
-Highlight;LINESTRING(65 100, 75 100, 75 110)
+Highlight;LINESTRING(25 45,25 150)
+ArgA;POINT(25 45)
+ArgB;POINT(75 100)
+Result-thin;LINESTRING(25 119.33,32.29 118.97,39.50 117.90,46.58 116.13,53.45 113.67,60.047 110.55,66.31 106.8,72.17 102.45,75 100)
+Result-thin;LINESTRING(65 100, 75 100, 75 110)
diff --git a/doc/html/image_src/st_azimuth02.wkt b/doc/html/image_src/st_azimuth02.wkt
index 68303a2c4..e202fa46f 100644
--- a/doc/html/image_src/st_azimuth02.wkt
+++ b/doc/html/image_src/st_azimuth02.wkt
@@ -1,5 +1,5 @@
-ArgA;POINT(25 45)
-ArgB;LINESTRING(75 100,75 174.33)
-ArgB;POINT(75 100)
-Highlight;LINESTRING(25 35, 25 45, 35 45)
-Highlight;LINESTRING(75 174.33,82.2854990291525 173.971777251164,85.9062926213504 173.525039359331,93.0603749304618 172.101689101655,100.040495655901 169.983969974891,103.444230148372 168.670839179401,110.038067674461 165.551844738703,113.212285575926 163.753495024293,119.27710323315 159.700742080159,124.915477881626 155.0730481658,130.073108891238 149.914980503366,134.700325455916 144.276214104132,136.800890872717 141.293372185585,138.75256495065 138.211053370987,142.190802093925 131.777909117344,144.981924782519 125.038736039082,147.099052979159 118.058436056949,148.521797581971 110.904233275595,148.968228943332 107.28340187647,149.236456782679 103.645026578689,149.236148022508 96.3507260950078,148.520874274986 89.0915799256797,147.09752401731 81.9374976165682,146.12434062691 78.421443710561,143.666674095056 71.5536423986582,140.547679654358 64.9598048725693,136.797394926295 58.7034333922286,134.696576995814 55.7207693138797,132.451937202912 52.8447802350724,127.553155617554 47.44
02674336697,122.148228114835 42.5419434007053,119.272049019787 40.2975470911136,113.206888286642 36.2453075963801,106.773744032999 32.8070704531054,100.034570954737 30.015947764511,96.5704072536981 28.8717052929568,89.4946327917332 27.0996343561797,82.2792367921245 26.0296436036982,74.9937074626849 25.6720376313751,71.3465610106627 25.7617245245224,64.0874148413345 26.4769982720444,56.9333325322231 27.9003485297198,53.4172786262158 28.8735319201204,46.5494773143131 31.3311984519738,43.2142750433263 32.8097608594851,36.7814218867588 36.2485426070818,30.7166042295346 40.3012955512158,25 45)
+Highlight;LINESTRING(75 100,75 190)
+ArgA;POINT(75 100)
+ArgB;POINT(25 45)
+Result-thin;LINESTRING(25 35, 25 45, 35 45)
+Result-thin;LINESTRING(75 174.33,82.2854990291525 173.971777251164,85.9062926213504 173.525039359331,93.0603749304618 172.101689101655,100.040495655901 169.983969974891,103.444230148372 168.670839179401,110.038067674461 165.551844738703,113.212285575926 163.753495024293,119.27710323315 159.700742080159,124.915477881626 155.0730481658,130.073108891238 149.914980503366,134.700325455916 144.276214104132,136.800890872717 141.293372185585,138.75256495065 138.211053370987,142.190802093925 131.777909117344,144.981924782519 125.038736039082,147.099052979159 118.058436056949,148.521797581971 110.904233275595,148.968228943332 107.28340187647,149.236456782679 103.645026578689,149.236148022508 96.3507260950078,148.520874274986 89.0915799256797,147.09752401731 81.9374976165682,146.12434062691 78.421443710561,143.666674095056 71.5536423986582,140.547679654358 64.9598048725693,136.797394926295 58.7034333922286,134.696576995814 55.7207693138797,132.451937202912 52.8447802350724,127.553155617554 47.
4402674336697,122.148228114835 42.5419434007053,119.272049019787 40.2975470911136,113.206888286642 36.2453075963801,106.773744032999 32.8070704531054,100.034570954737 30.015947764511,96.5704072536981 28.8717052929568,89.4946327917332 27.0996343561797,82.2792367921245 26.0296436036982,74.9937074626849 25.6720376313751,71.3465610106627 25.7617245245224,64.0874148413345 26.4769982720444,56.9333325322231 27.9003485297198,53.4172786262158 28.8735319201204,46.5494773143131 31.3311984519738,43.2142750433263 32.8097608594851,36.7814218867588 36.2485426070818,30.7166042295346 40.3012955512158,25 45)
diff --git a/doc/reference_measure.xml b/doc/reference_measure.xml
index b37d935a6..0ea5e90fe 100644
--- a/doc/reference_measure.xml
+++ b/doc/reference_measure.xml
@@ -126,25 +126,28 @@ from somegeogtable;</programlisting>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>ST_Azimuth</function></funcdef>
- <paramdef><type>geometry </type><parameter>pointA</parameter></paramdef>
- <paramdef><type>geometry </type><parameter>pointB</parameter></paramdef>
+ <paramdef><type>geometry </type><parameter>origin</parameter></paramdef>
+ <paramdef><type>geometry </type><parameter>target</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>float <function>ST_Azimuth</function></funcdef>
- <paramdef><type>geography </type><parameter>pointA</parameter></paramdef>
- <paramdef><type>geography </type><parameter>pointB</parameter></paramdef>
+ <paramdef><type>geography </type><parameter>origin</parameter></paramdef>
+ <paramdef><type>geography </type><parameter>target</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsection>
<title>Description</title>
- <para>Returns the azimuth in radians of the line segment defined by the given
- point geometries, or NULL if the two points are coincident. The azimuth angle is referenced from north (the positive Y axis), and is positive clockwise: North = 0; Northeast = π/4; East = π/2; Southeast = 3π/4;
- South = π; Southwest 5π/4; West = 3π/2; Northwest = 7π/4.</para>
+ <para>Returns the azimuth in radians of the target point from the origin point,
+ or NULL if the two points are coincident.
+ The azimuth angle is a positive clockwise angle
+ referenced from the positive Y axis (geometry) or the North meridian (geography):
+ North = 0; Northeast = π/4; East = π/2; Southeast = 3π/4;
+ South = π; Southwest 5π/4; West = 3π/2; Northwest = 7π/4.</para>
<para>For the geography type, the azimuth solution is known as the
<ulink url="https://en.wikipedia.org/wiki/Geodesics_on_an_ellipsoid">inverse geodesic problem</ulink>.</para>
- <para>The azimuth is a mathematical concept defined as the angle between a reference plane and a point, with angular units in radians.
+ <para>The azimuth is a mathematical concept defined as the angle between a reference vector and a point, with angular units in radians.
The result value in radians can be converted to degrees using the PostgreSQL function <varname>degrees()</varname>.</para>
<para>Azimuth can be used in conjunction with <xref linkend="ST_Translate" /> to shift an object along its perpendicular axis. See
@@ -160,7 +163,7 @@ from somegeogtable;</programlisting>
<para>Geometry Azimuth in degrees </para>
<programlisting>
SELECT degrees(ST_Azimuth( ST_Point(25, 45), ST_Point(75, 100))) AS degA_B,
- degrees(ST_Azimuth( ST_Point(75, 100), ST_Point(25, 45) )) AS degB_A;
+ degrees(ST_Azimuth( ST_Point(75, 100), ST_Point(25, 45) )) AS degB_A;
dega_b | degb_a
------------------+------------------
@@ -175,7 +178,8 @@ SELECT degrees(ST_Azimuth( ST_Point(25, 45), ST_Point(75, 100))) AS degA_B,
<imageobject>
<imagedata fileref="images/st_azimuth01.png" />
</imageobject>
- <caption><para>Green: the start Point(25,45) with its vertical. Yellow: degA_B as the path to travel (azimuth).</para></caption>
+ <caption><para>Blue: origin Point(25,45); Green: target Point(75, 100); Yellow: Y axis or North;
+ Red: azimuth angle.</para></caption>
</mediaobject>
</informalfigure>
</para></entry>
@@ -184,7 +188,8 @@ SELECT degrees(ST_Azimuth( ST_Point(25, 45), ST_Point(75, 100))) AS degA_B,
<imageobject>
<imagedata fileref="images/st_azimuth02.png" />
</imageobject>
- <caption><para>Green: the start Point(75,100) with its vertical. Yellow: degB_A as the path to travel (azimuth).</para></caption>
+ <caption><para>Blue: origin Point(75, 100); Green: target Point(25, 45); Yellow: Y axis or North;
+ Red: azimuth angle.</para></caption>
</mediaobject>
</informalfigure>
</para></entry>
-----------------------------------------------------------------------
Summary of changes:
doc/html/image_src/st_azimuth01.wkt | 10 +++++-----
doc/html/image_src/st_azimuth02.wkt | 10 +++++-----
doc/reference_measure.xml | 27 ++++++++++++++++-----------
3 files changed, 26 insertions(+), 21 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list