You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sis.apache.org by de...@apache.org on 2022/02/09 19:31:20 UTC
[sis] 01/04: Fix an inacurate documentation about the 0° (or 180°) meridian passing through geographic and rotated poles.
This is an automated email from the ASF dual-hosted git repository.
desruisseaux pushed a commit to branch geoapi-4.0
in repository https://gitbox.apache.org/repos/asf/sis.git
commit 295bee7570822eee03ca0be787c665e116d32537
Author: Martin Desruisseaux <ma...@geomatys.com>
AuthorDate: Tue Feb 8 22:59:52 2022 +0100
Fix an inacurate documentation about the 0° (or 180°) meridian passing through geographic and rotated poles.
---
.../sis/referencing/operation/transform/PoleRotation.java | 14 ++++++++------
1 file changed, 8 insertions(+), 6 deletions(-)
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/PoleRotation.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/PoleRotation.java
index c522210..92e89eb 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/PoleRotation.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/PoleRotation.java
@@ -264,9 +264,10 @@ public class PoleRotation extends AbstractMathTransform2D implements Serializabl
/**
* Creates a new rotated south pole operation. The rotations are applied by first rotating the sphere
* through λ<sub>p</sub> about the geographic polar axis, then rotating through (φ<sub>p</sub> − (−90°))
- * degrees so that the southern pole moved along the (previously rotated) Greenwich meridian,
- * and finally by rotating clockwise when looking from the southern to the northern rotated pole.
- * The 180° rotated meridian runs through both the geographical and the rotated South pole.
+ * degrees so that the southern pole moved along the (previously rotated) Greenwich meridian, and finally
+ * by rotating θ<sub>p</sub> degrees clockwise when looking from the southern to the northern rotated pole.
+ * In the case where θ<sub>p</sub>=0, the 180° rotated meridian runs through both the geographical
+ * and the rotated South pole.
*
* @param factory the factory to use for creating the transform.
* @param φp geographic latitude in degrees of the southern pole of the coordinate system.
@@ -286,9 +287,10 @@ public class PoleRotation extends AbstractMathTransform2D implements Serializabl
/**
* Creates a new rotated north pole operation. The rotations are applied by first rotating the sphere
* through λ<sub>p</sub> about the geographic polar axis, then rotating through (φ<sub>p</sub> − 90°)
- * degrees so that the northern pole moved along the (previously rotated) Greenwich meridian.
- * The 0° rotated meridian is defined as the meridian that runs through both the geographical and the
- * rotated North pole.
+ * degrees so that the northern pole moved along the (previously rotated) Greenwich meridian, and finally
+ * by rotating θ<sub>p</sub> degrees clockwise when looking from the northern to the southern rotated pole.
+ * In the case where θ<sub>p</sub>=0, the 0° rotated meridian is defined as the meridian that runs through
+ * both the geographical and the rotated North pole.
*
* <div class="warning">
* The sign of the {@code θp} argument is not yet well determined.