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
The following commit(s) were added to refs/heads/geoapi-4.0 by this push:
new 71894a912f Slightly more accurate documentation of projection
implementation methods and typo fixes. There is no code change in this commit
(documentation only).
71894a912f is described below
commit 71894a912f7ff2c2f09aed6ee4fc82a62bdb7916
Author: Martin Desruisseaux <[email protected]>
AuthorDate: Thu Aug 4 18:20:26 2022 +0200
Slightly more accurate documentation of projection implementation methods
and typo fixes.
There is no code change in this commit (documentation only).
---
.../java/org/apache/sis/internal/jaxb/lan/LocaleAndCharset.java | 2 +-
.../src/main/java/org/apache/sis/io/wkt/Symbols.java | 2 +-
.../src/main/java/org/apache/sis/io/wkt/WKTDictionary.java | 2 +-
.../org/apache/sis/referencing/operation/MathTransformContext.java | 2 +-
.../sis/referencing/operation/projection/AlbersEqualArea.java | 4 +++-
.../sis/referencing/operation/projection/AuthalicMercator.java | 6 +++---
.../sis/referencing/operation/projection/AzimuthalEquidistant.java | 4 +++-
.../apache/sis/referencing/operation/projection/CassiniSoldner.java | 3 ++-
.../sis/referencing/operation/projection/CylindricalEqualArea.java | 6 +++---
.../referencing/operation/projection/LambertAzimuthalEqualArea.java | 3 ++-
.../sis/referencing/operation/projection/LambertConicConformal.java | 4 +++-
.../org/apache/sis/referencing/operation/projection/Mercator.java | 3 ++-
.../operation/projection/ModifiedAzimuthalEquidistant.java | 4 +++-
.../org/apache/sis/referencing/operation/projection/Mollweide.java | 3 ++-
.../sis/referencing/operation/projection/NormalizedProjection.java | 6 +++---
.../sis/referencing/operation/projection/ObliqueMercator.java | 3 ++-
.../sis/referencing/operation/projection/ObliqueStereographic.java | 4 +++-
.../apache/sis/referencing/operation/projection/Orthographic.java | 3 ++-
.../sis/referencing/operation/projection/PolarStereographic.java | 3 ++-
.../org/apache/sis/referencing/operation/projection/Polyconic.java | 6 +++---
.../sis/referencing/operation/projection/SatelliteTracking.java | 3 ++-
.../org/apache/sis/referencing/operation/projection/Sinusoidal.java | 6 +++---
.../sis/referencing/operation/projection/TransverseMercator.java | 3 ++-
.../sis/referencing/operation/projection/ZonedGridSystem.java | 2 +-
.../src/main/java/org/apache/sis/internal/sql/feature/Database.java | 2 +-
.../src/main/java/org/apache/sis/internal/storage/csv/Store.java | 2 +-
26 files changed, 55 insertions(+), 36 deletions(-)
diff --git
a/core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/lan/LocaleAndCharset.java
b/core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/lan/LocaleAndCharset.java
index aaab4d7915..2461e8b1a9 100644
---
a/core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/lan/LocaleAndCharset.java
+++
b/core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/lan/LocaleAndCharset.java
@@ -106,7 +106,7 @@ public final class LocaleAndCharset implements Node {
/**
* Returns the key or the value of the given {@link Map.Entry}. If the
given object is not a map entry
- * or is null, then it is returned as-is. This later case should never
happen (the object shall always be
+ * or is null, then it is returned as-is. This latter case should never
happen (the object shall always be
* a non-null map entry), but we nevertheless check for making the code
more robust to ill-formed metadata.
* We apply this tolerance because this method is used (indirectly) for
{@code toString()} implementations,
* and failure in those methods make debugging more difficult (string
representations are often requested
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/io/wkt/Symbols.java
b/core/sis-referencing/src/main/java/org/apache/sis/io/wkt/Symbols.java
index 40e2a0ec67..0ae1e2a7f4 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/io/wkt/Symbols.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/io/wkt/Symbols.java
@@ -570,7 +570,7 @@ public class Symbols implements Localized, Cloneable,
Serializable {
*
* <h4>Scientific notation</h4>
* The {@link NumberFormat} created here does not use scientific notation.
This is okay for many
- * WKT formatting purpose since Earth ellipsoid axis lengths in metres are
large enough for trigging
+ * WKT formatting purpose since Earth ellipsoid axis lengths in metres are
large enough for triggering
* scientific notation, while we want to express them as normal numbers
with centimetre precision.
* However this is problematic for small numbers like 1E-5. Callers may
need to adjust the precision
* depending on the kind of numbers (length or angle) to format.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/io/wkt/WKTDictionary.java
b/core/sis-referencing/src/main/java/org/apache/sis/io/wkt/WKTDictionary.java
index a179791103..30dcb365ff 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/io/wkt/WKTDictionary.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/io/wkt/WKTDictionary.java
@@ -625,7 +625,7 @@ public class WKTDictionary extends GeodeticAuthorityFactory
{
/**
* Parses the current {@link #buffer} content as a WKT elements
(possibly with children elements).
- * This method does not build the full {@link IdentifiedObject}; this
later part will be done only
+ * This method does not build the full {@link IdentifiedObject}; this
latter part will be done only
* when first needed.
*
* <p>If {@link #aliasKey} is non-null, the first WKT is taken as a
{@linkplain WKTFormat#addFragment
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/MathTransformContext.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/MathTransformContext.java
index 1103ec4597..defcd754ae 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/MathTransformContext.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/MathTransformContext.java
@@ -36,7 +36,7 @@ import org.apache.sis.measure.Units;
/**
* Information about the context in which a {@code MathTransform} is created.
* This class performs the same normalization than the super-class (namely
axis swapping and unit conversions),
- * with the addition of longitude rotation for supporting change of prime
meridian. This later change is not
+ * with the addition of longitude rotation for supporting change of prime
meridian. This latter change is not
* applied by the super-class because prime meridian is part of geodetic
datum, and the public math transform
* factory know nothing about datum (on design, for separation of concerns).
*
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AlbersEqualArea.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AlbersEqualArea.java
index e9d8caead0..19bc0d2234 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AlbersEqualArea.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AlbersEqualArea.java
@@ -226,8 +226,10 @@ public class AlbersEqualArea extends AuthalicConversion {
}
/**
- * Converts the specified (θ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}.
+ * Projects the specified (θ,φ) coordinates and stores the result in
{@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The units of measurement are implementation-specific (see super-class
javadoc).
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AuthalicMercator.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AuthalicMercator.java
index 2f331d44e2..039802ad48 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AuthalicMercator.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AuthalicMercator.java
@@ -54,9 +54,9 @@ final class AuthalicMercator extends AuthalicConversion {
}
/**
- * Converts the specified (λ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}
- * (linear distance on a unit sphere). In addition, opportunistically
computes the projection derivative
- * if {@code derivate} is {@code true}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
+ * In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AzimuthalEquidistant.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AzimuthalEquidistant.java
index ba8c3e8185..500c481a94 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AzimuthalEquidistant.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AzimuthalEquidistant.java
@@ -157,7 +157,9 @@ public class AzimuthalEquidistant extends
NormalizedProjection {
}
/**
- * Converts the specified (λ,φ) coordinate and stores the
(<var>x</var>,<var>y</var>) result in {@code dstPts}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
+ * In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @param srcPts source point coordinate, as (<var>longitude</var>,
<var>latitude</var>) in radians.
* @param srcOff the offset of the single coordinate to be converted
in the source array.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/CassiniSoldner.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/CassiniSoldner.java
index 10b368415a..aba65189a4 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/CassiniSoldner.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/CassiniSoldner.java
@@ -233,8 +233,9 @@ public class CassiniSoldner extends MeridianArcBased {
}
/**
- * Converts the specified (λ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @param srcPts the array containing the source point coordinate,
* as (<var>longitude</var>, <var>latitude</var>) angles
in <strong>radians</strong>.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/CylindricalEqualArea.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/CylindricalEqualArea.java
index 0b1eca0c72..2261170a1c 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/CylindricalEqualArea.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/CylindricalEqualArea.java
@@ -230,9 +230,9 @@ public class CylindricalEqualArea extends
AuthalicConversion {
}
/**
- * Converts the specified (λ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}
- * (linear distance on a unit sphere). In addition, opportunistically
computes the projection derivative
- * if {@code derivate} is {@code true}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
+ * In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/LambertAzimuthalEqualArea.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/LambertAzimuthalEqualArea.java
index 58cff5ecbc..1ba7d954e2 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/LambertAzimuthalEqualArea.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/LambertAzimuthalEqualArea.java
@@ -163,8 +163,9 @@ public class LambertAzimuthalEqualArea extends
AuthalicConversion {
}
/**
- * Converts the specified (λ,φ)) coordinate (units in radians) and stores
the result in {@code dstPts}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/LambertConicConformal.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/LambertConicConformal.java
index 0a6923d1f8..459212d8eb 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/LambertConicConformal.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/LambertConicConformal.java
@@ -442,8 +442,10 @@ public class LambertConicConformal extends
ConformalProjection {
}
/**
- * Converts the specified (θ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}.
+ * Projects the specified (θ,φ) coordinates and stores the result in
{@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The units of measurement are implementation-specific (see super-class
javadoc).
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Mercator.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Mercator.java
index 6a669f5edc..e0fed8164e 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Mercator.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Mercator.java
@@ -408,8 +408,9 @@ subst: if (variant.spherical || (eccentricity == 0 &&
getClass() == Mercator.cl
}
/**
- * Converts the specified coordinate (implementation-specific units) and
stores the result in {@code dstPts}.
+ * Projects the specified coordinates (implementation-specific units) and
stores the result in {@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ModifiedAzimuthalEquidistant.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ModifiedAzimuthalEquidistant.java
index 744aea5089..0a50fe366e 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ModifiedAzimuthalEquidistant.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ModifiedAzimuthalEquidistant.java
@@ -155,7 +155,9 @@ public class ModifiedAzimuthalEquidistant extends
AzimuthalEquidistant {
}
/**
- * Converts the specified (λ,φ) coordinate and stores the
(<var>x</var>,<var>y</var>) result in {@code dstPts}.
+ * Projects the specified (λ,φ) coordinate (units in radians)
+ * and stores the (<var>x</var>,<var>y</var>) result in {@code dstPts}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Mollweide.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Mollweide.java
index f9c4d7534d..5285f2aee2 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Mollweide.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Mollweide.java
@@ -119,8 +119,9 @@ public class Mollweide extends NormalizedProjection {
}
/**
- * Converts the specified (λ,φ) coordinate and stores the
(<var>x</var>,<var>y</var>) result in {@code dstPts}.
+ * Projects the specified (Λ,φ) coordinates and stores the
(<var>x</var>,<var>y</var>) result in {@code dstPts}.
* The units of measurement are implementation-specific (see super-class
javadoc).
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/NormalizedProjection.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/NormalizedProjection.java
index 8b7e0c16a5..07946d56a6 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/NormalizedProjection.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/NormalizedProjection.java
@@ -690,9 +690,9 @@ public abstract class NormalizedProjection extends
AbstractMathTransform2D imple
*/
/**
- * Converts a single coordinate in {@code srcPts} at the given offset and
stores the result
- * in {@code dstPts} at the given offset. In addition, opportunistically
computes the
- * transform derivative if requested.
+ * Projects a single coordinate tuple in {@code srcPts} at the given offset
+ * and stores the result in {@code dstPts} at the given offset.
+ * In addition, opportunistically computes the transform derivative if
requested.
*
* <h4>Normalization</h4>
* The input coordinates are (<var>λ</var>,<var>φ</var>) (the variable
names for <var>longitude</var> and
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ObliqueMercator.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ObliqueMercator.java
index 061f58659f..b3cc32a43d 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ObliqueMercator.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ObliqueMercator.java
@@ -327,8 +327,9 @@ public class ObliqueMercator extends ConformalProjection {
}
/**
- * Converts the specified (λ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ObliqueStereographic.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ObliqueStereographic.java
index d68b5d3e7e..fcd61d7014 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ObliqueStereographic.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ObliqueStereographic.java
@@ -257,8 +257,10 @@ public class ObliqueStereographic extends
NormalizedProjection {
}
/**
- * Converts the specified (λ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}.
+ * Projects the specified (Λ,φ) coordinates and stores the result in
{@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The units of measurement are implementation-specific (see super-class
javadoc).
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Orthographic.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Orthographic.java
index 70979ec728..95a2664d34 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Orthographic.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Orthographic.java
@@ -145,8 +145,9 @@ public class Orthographic extends NormalizedProjection {
}
/**
- * Converts the specified (λ,φ) coordinate and stores the
(<var>x</var>,<var>y</var>) result in {@code dstPts}.
+ * Projects the specified (λ,φ) coordinates and stores the result in
{@code dstPts}.
* The units of measurement are implementation-specific (see super-class
javadoc).
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/PolarStereographic.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/PolarStereographic.java
index 0694632c59..ce77e48301 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/PolarStereographic.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/PolarStereographic.java
@@ -317,8 +317,9 @@ public class PolarStereographic extends ConformalProjection
{
}
/**
- * Converts the specified (θ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Polyconic.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Polyconic.java
index 4170432dc8..e19d6a0036 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Polyconic.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Polyconic.java
@@ -168,9 +168,9 @@ public class Polyconic extends MeridianArcBased {
}
/**
- * Converts the specified (λ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}
- * (linear distance on a unit sphere). In addition, opportunistically
computes the projection derivative
- * if {@code derivate} is {@code true}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
+ * In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/SatelliteTracking.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/SatelliteTracking.java
index 7bab551abb..454920c019 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/SatelliteTracking.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/SatelliteTracking.java
@@ -295,8 +295,9 @@ public class SatelliteTracking extends NormalizedProjection
{
}
/**
- * Converts the specified (λ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}.
+ * Projects the specified (λ,φ) coordinates and stores the result in
{@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The units of measurement are implementation-specific (see super-class
javadoc).
* The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* <p>The <var>y</var> axis lies along the central meridian λ₀,
<var>y</var> increasing northerly, and
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Sinusoidal.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Sinusoidal.java
index 70283f04e3..0912b32535 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Sinusoidal.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/Sinusoidal.java
@@ -164,9 +164,9 @@ public class Sinusoidal extends MeridianArcBased {
}
/**
- * Converts the specified (λ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}
- * (linear distance on a unit sphere). In addition, opportunistically
computes the projection derivative
- * if {@code derivate} is {@code true}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
+ * In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* @return the matrix of the projection derivative at the given source
position,
* or {@code null} if the {@code derivate} argument is {@code
false}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/TransverseMercator.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/TransverseMercator.java
index 10ee4214b5..2ad53aa22b 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/TransverseMercator.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/TransverseMercator.java
@@ -409,8 +409,9 @@ public class TransverseMercator extends
NormalizedProjection {
}
/**
- * Converts the specified (λ,φ) coordinate (units in radians) and stores
the result in {@code dstPts}.
+ * Projects the specified (λ,φ) coordinates (units in radians) and stores
the result in {@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
+ * The results must be multiplied by the denormalization matrix before to
get linear distances.
*
* <h4>Accuracy and domain of validity</h4>
* Projection errors depend on the difference ∆λ between longitude λ and
the central meridian λ₀.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ZonedGridSystem.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ZonedGridSystem.java
index 146f574add..524c6fda0e 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ZonedGridSystem.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ZonedGridSystem.java
@@ -165,7 +165,7 @@ public class ZonedGridSystem extends
AbstractMathTransform2D implements Serializ
}
/**
- * Converts the specified (λ,φ) coordinate and stores the result in {@code
dstPts}.
+ * Projects the specified (λ,φ) coordinates and stores the result in
{@code dstPts}.
* In addition, opportunistically computes the projection derivative if
{@code derivate} is {@code true}.
* Note that the derivative does not contain zone prefix.
*
diff --git
a/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Database.java
b/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Database.java
index 3abf5140ed..2c8f5871ea 100644
---
a/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Database.java
+++
b/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Database.java
@@ -731,7 +731,7 @@ public class Database<G> extends Syntax {
*/
protected final void log(final LogRecord record) {
record.setSourceClassName(SQLStore.class.getName());
- record.setSourceMethodName("components"); // Main
public API trigging the database analysis.
+ record.setSourceMethodName("components"); // Main
public API triggering the database analysis.
record.setLoggerName(Modules.SQL);
listeners.warning(record);
}
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/csv/Store.java
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/csv/Store.java
index 084d67ffa7..adb49da93a 100644
---
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/csv/Store.java
+++
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/csv/Store.java
@@ -311,7 +311,7 @@ final class Store extends URIDataStore implements
FeatureSet {
/**
* Moves the reader position to beginning of file, if possible. We try to
use the mark defined by the constructor,
* which is set after the last header line. If the mark is no longer
valid, then we have to create a new line reader.
- * In this later case, we have to skip the header lines (i.e. we reproduce
the constructor loop, but without parsing
+ * In this latter case, we have to skip the header lines (i.e. we
reproduce the constructor loop, but without parsing
* metadata).
*
* @todo Not yet used. This is planned for a future version of {@link
#features(boolean)} method implementation.
