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/08/20 14:27:26 UTC
[sis] 01/02: More fixes of the use of "coordinate" word in documentation. It was used for a all coordinates of a point, while ISO 19111 uses "coordinate" for a single value in a coordinate tuple.
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 f1adff64766e120a459b5b5915d65cc070f7acbb
Author: Martin Desruisseaux <ma...@geomatys.com>
AuthorDate: Sat Aug 20 10:55:15 2022 +0200
More fixes of the use of "coordinate" word in documentation.
It was used for a all coordinates of a point, while ISO 19111 uses "coordinate" for a single value in a coordinate tuple.
---
.../org/apache/sis/coverage/BandedCoverage.java | 2 +-
.../sis/coverage/grid/ConvertedGridCoverage.java | 2 +-
.../apache/sis/coverage/grid/DefaultEvaluator.java | 2 +-
.../apache/sis/coverage/grid/EvaluatorWrapper.java | 2 +-
.../internal/coverage/CompoundTransformOf1D.java | 10 ++---
.../sis/internal/coverage/RepeatedTransform.java | 10 ++---
.../sis/internal/feature/j2d/ShapeProperties.java | 10 ++---
.../apache/sis/internal/feature/jts/Wrapper.java | 2 +-
.../org/apache/sis/geometry/GeneralEnvelope.java | 4 +-
.../java/org/apache/sis/geometry/Shapes2D.java | 2 +-
.../referencing/j2d/AffineTransform2D.java | 2 +-
.../operation/builder/LocalizationGridBuilder.java | 2 +-
.../operation/projection/AlbersEqualArea.java | 2 +-
.../operation/projection/AuthalicMercator.java | 2 +-
.../operation/projection/AzimuthalEquidistant.java | 14 +++---
.../operation/projection/CassiniSoldner.java | 14 +++---
.../operation/projection/CylindricalEqualArea.java | 4 +-
.../projection/LambertAzimuthalEqualArea.java | 2 +-
.../projection/LambertConicConformal.java | 2 +-
.../referencing/operation/projection/Mercator.java | 4 +-
.../projection/ModifiedAzimuthalEquidistant.java | 4 +-
.../operation/projection/Mollweide.java | 2 +-
.../operation/projection/NormalizedProjection.java | 24 +++++------
.../operation/projection/ObliqueMercator.java | 2 +-
.../operation/projection/ObliqueStereographic.java | 2 +-
.../operation/projection/Orthographic.java | 2 +-
.../operation/projection/PolarStereographic.java | 2 +-
.../operation/projection/ProjectionException.java | 2 +-
.../operation/projection/Sinusoidal.java | 4 +-
.../operation/projection/TransverseMercator.java | 2 +-
.../operation/projection/ZonedGridSystem.java | 2 +-
.../operation/transform/AbstractMathTransform.java | 50 +++++++++++-----------
.../transform/AbstractMathTransform1D.java | 4 +-
.../transform/AbstractMathTransform2D.java | 24 +++++------
.../operation/transform/ConcatenatedTransform.java | 4 +-
.../transform/ConcatenatedTransform2D.java | 2 +-
.../transform/ConcatenatedTransformDirect2D.java | 2 +-
.../transform/CoordinateSystemTransform.java | 4 +-
.../transform/EllipsoidToCentricTransform.java | 2 +-
.../operation/transform/PoleRotation.java | 4 +-
.../operation/transform/ProjectiveTransform.java | 4 +-
.../transform/SpecializableTransform.java | 22 +++++-----
.../operation/transform/WraparoundTransform.java | 2 +-
.../operation/transform/package-info.java | 2 +-
.../referencing/j2d/ShapeUtilitiesViewer.java | 2 +-
.../operation/transform/PolarToCartesianTest.java | 2 +-
.../transform/SphericalToCartesianTest.java | 2 +-
47 files changed, 137 insertions(+), 137 deletions(-)
diff --git a/core/sis-feature/src/main/java/org/apache/sis/coverage/BandedCoverage.java b/core/sis-feature/src/main/java/org/apache/sis/coverage/BandedCoverage.java
index 11d4140e53..51d874834a 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/coverage/BandedCoverage.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/coverage/BandedCoverage.java
@@ -198,7 +198,7 @@ public abstract class BandedCoverage {
* If the CRS of the point is undefined, then it is assumed to be the {@linkplain #getCoverage() coverage} CRS.
* The returned sequence includes a value for each {@linkplain SampleDimension sample dimension}.
*
- * @param point the coordinate point where to evaluate.
+ * @param point the position where to evaluate.
* @return the sample values at the specified point, or {@code null} if the point is outside the coverage.
* For performance reason, this method may return the same array
* on every method call by overwriting previous values.
diff --git a/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/ConvertedGridCoverage.java b/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/ConvertedGridCoverage.java
index b3f2b6d9aa..ccca65d2a0 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/ConvertedGridCoverage.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/ConvertedGridCoverage.java
@@ -266,7 +266,7 @@ final class ConvertedGridCoverage extends DerivedGridCoverage {
* Returns a sequence of double values for a given point in the coverage.
* This method delegates to the source coverage, then converts the values.
*
- * @param point the coordinate point where to evaluate.
+ * @param point the position where to evaluate.
* @throws CannotEvaluateException if the values can not be computed.
*/
@Override
diff --git a/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/DefaultEvaluator.java b/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/DefaultEvaluator.java
index aede5d3ed7..ac1f4e41bb 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/DefaultEvaluator.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/DefaultEvaluator.java
@@ -352,7 +352,7 @@ class DefaultEvaluator implements GridCoverage.Evaluator {
* <p>The default implementation invokes {@link GridCoverage#render(GridExtent)} for a small region
* around the point. Subclasses should override with more efficient implementation.</p>
*
- * @param point the coordinate point where to evaluate.
+ * @param point the position where to evaluate.
* @return the sample values at the specified point, or {@code null} if the point is outside the coverage.
* For performance reason, this method may return the same array
* on every method call by overwriting previous values.
diff --git a/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/EvaluatorWrapper.java b/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/EvaluatorWrapper.java
index 014335bcb7..df9738fe89 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/EvaluatorWrapper.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/coverage/grid/EvaluatorWrapper.java
@@ -116,7 +116,7 @@ abstract class EvaluatorWrapper implements GridCoverage.Evaluator {
* This method should be overridden if this evaluator is for a coverage
* doing some on-the-fly conversion of sample values.
*
- * @param point the coordinate point where to evaluate.
+ * @param point the position where to evaluate.
* @throws CannotEvaluateException if the values can not be computed.
*/
@Override
diff --git a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/CompoundTransformOf1D.java b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/CompoundTransformOf1D.java
index db2ba82e4d..ef43ef8cf8 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/CompoundTransformOf1D.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/CompoundTransformOf1D.java
@@ -77,7 +77,7 @@ final class CompoundTransformOf1D extends CompoundTransform {
}
/**
- * Transforms a single coordinate point in an array, and optionally computes the transform derivative
+ * Transforms a single coordinate tuple in an array, and optionally computes the transform derivative
* at that location.
*/
@Override
@@ -112,7 +112,7 @@ final class CompoundTransformOf1D extends CompoundTransform {
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
*/
@Override
public void transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts) throws TransformException {
@@ -130,7 +130,7 @@ final class CompoundTransformOf1D extends CompoundTransform {
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
*/
@Override
public void transform(float[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts) throws TransformException {
@@ -148,7 +148,7 @@ final class CompoundTransformOf1D extends CompoundTransform {
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
*/
@Override
public void transform(double[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts) throws TransformException {
@@ -160,7 +160,7 @@ final class CompoundTransformOf1D extends CompoundTransform {
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
*/
@Override
public void transform(float[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts) throws TransformException {
diff --git a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/RepeatedTransform.java b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/RepeatedTransform.java
index 29f9aa46b0..b04d816830 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/RepeatedTransform.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/RepeatedTransform.java
@@ -94,7 +94,7 @@ final class RepeatedTransform extends CompoundTransform {
}
/**
- * Transforms a single coordinate point in an array, and optionally computes the transform derivative
+ * Transforms a single coordinate tuple in an array, and optionally computes the transform derivative
* at that location.
*/
@Override
@@ -120,7 +120,7 @@ final class RepeatedTransform extends CompoundTransform {
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
*/
@Override
public void transform(final double[] srcPts, final int srcOff,
@@ -130,7 +130,7 @@ final class RepeatedTransform extends CompoundTransform {
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
*/
@Override
public void transform(final float[] srcPts, final int srcOff,
@@ -140,7 +140,7 @@ final class RepeatedTransform extends CompoundTransform {
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
*/
@Override
public void transform(final double[] srcPts, final int srcOff,
@@ -150,7 +150,7 @@ final class RepeatedTransform extends CompoundTransform {
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
*/
@Override
public void transform(final float [] srcPts, final int srcOff,
diff --git a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/j2d/ShapeProperties.java b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/j2d/ShapeProperties.java
index 8cdc88154b..24749b6806 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/j2d/ShapeProperties.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/j2d/ShapeProperties.java
@@ -109,7 +109,7 @@ final class ShapeProperties {
* It should be invoked only for small or medium shapes. For large shapes, the path iterator should be used
* directly without copy to arrays.
*
- * @return coordinate points as (<var>x</var>,<var>y</var>) tuples.
+ * @return coordinate tuples as (<var>x</var>,<var>y</var>) tuples.
* @throws IllegalPathStateException if the given path iterator contains curves.
*/
public List<double[]> coordinatesAsDoubles() {
@@ -121,8 +121,8 @@ final class ShapeProperties {
* {@link #coordinates(double)} implementation for the double-precision case.
* The {@link #isPolygon} field needs to be set before to invoke this method.
*
- * @param it path iterator of the geometry for which to get the coordinate points.
- * @return coordinate points as (<var>x</var>,<var>y</var>) tuples.
+ * @param it path iterator of the geometry for which to get the coordinate tuples.
+ * @return coordinate tuples as (<var>x</var>,<var>y</var>) tuples.
* @throws IllegalPathStateException if the given path iterator contains curves.
*/
private List<double[]> coordinatesAsDoubles(final PathIterator it) {
@@ -177,8 +177,8 @@ final class ShapeProperties {
* {@link #coordinates(double)} implementation for the single-precision case.
* The {@link #isPolygon} field needs to be set before to invoke this method.
*
- * @param it path iterator of the geometry for which to get the coordinate points.
- * @return coordinate points as (<var>x</var>,<var>y</var>) tuples.
+ * @param it path iterator of the geometry for which to get the coordinate tuples.
+ * @return coordinate tuples as (<var>x</var>,<var>y</var>) tuples.
* @throws IllegalPathStateException if the given path iterator contains curves.
*/
private List<float[]> coordinatesAsFloats(final PathIterator it) {
diff --git a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/jts/Wrapper.java b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/jts/Wrapper.java
index e6c0b500e6..385277fd57 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/jts/Wrapper.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/jts/Wrapper.java
@@ -156,7 +156,7 @@ final class Wrapper extends GeometryWrapper<Geometry> {
}
/**
- * Gets the number of dimensions of geometry vertex (sequence of coordinate points), which can be 2 or 3.
+ * Gets the number of dimensions of geometry vertex (sequence of coordinate tuples), which can be 2 or 3.
* Note that this is different than the {@linkplain Geometry#getDimension() geometry topological dimension},
* which can be 0, 1 or 2.
*
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/geometry/GeneralEnvelope.java b/core/sis-referencing/src/main/java/org/apache/sis/geometry/GeneralEnvelope.java
index 1fbacc182a..12b46c9b18 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/geometry/GeneralEnvelope.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/geometry/GeneralEnvelope.java
@@ -51,7 +51,7 @@ import static org.apache.sis.math.MathFunctions.isNegativeZero;
/**
* A mutable {@code Envelope} (a minimum bounding box or rectangle) of arbitrary dimension.
* Regardless of dimension, an {@code Envelope} can be represented without ambiguity
- * as two {@linkplain AbstractDirectPosition direct positions} (coordinate points).
+ * as two {@linkplain AbstractDirectPosition direct positions} (coordinate tuples).
* To encode an {@code Envelope}, it is sufficient to encode these two points.
*
* <div class="note"><b>Note:</b>
@@ -66,7 +66,7 @@ import static org.apache.sis.math.MathFunctions.isNegativeZero;
* <p>A {@code GeneralEnvelope} can be created in various ways:</p>
* <ul>
* <li>{@linkplain #GeneralEnvelope(int) From a given number of dimension}, with all coordinates initialized to 0.</li>
- * <li>{@linkplain #GeneralEnvelope(double[], double[]) From two coordinate points}.</li>
+ * <li>{@linkplain #GeneralEnvelope(double[], double[]) From two coordinate tuples}.</li>
* <li>{@linkplain #GeneralEnvelope(Envelope) From a an other envelope} (copy constructor).</li>
* <li>{@linkplain #GeneralEnvelope(GeographicBoundingBox) From a geographic bounding box}.</li>
* <li>{@linkplain #GeneralEnvelope(CharSequence) From a character sequence}
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/geometry/Shapes2D.java b/core/sis-referencing/src/main/java/org/apache/sis/geometry/Shapes2D.java
index 31b37d4f20..5081c52147 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/geometry/Shapes2D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/geometry/Shapes2D.java
@@ -384,7 +384,7 @@ public final class Shapes2D extends Static {
/*
* Note: a previous version had an "assert" statement here comparing our calculation
* with the calculation performed by the more general method working on Envelope. We
- * verified that the same values (coordinate points and derivatives) were ultimately
+ * verified that the same values (coordinate tuples and derivatives) were ultimately
* passed to the CurveExtremum.resolve(…) method, so we would expect the same result.
* However the iteration order is different. The result seems insensitive to iteration
* order most of the time, but not always. However, it seems that the cases were the
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/AffineTransform2D.java b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/AffineTransform2D.java
index 535024d3bb..888ebb867f 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/AffineTransform2D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/AffineTransform2D.java
@@ -41,7 +41,7 @@ import org.apache.sis.util.Workaround;
/**
- * Transforms two-dimensional coordinate points using an affine transform. This class both extends
+ * Transforms two-dimensional coordinate tuples using an affine transform. This class both extends
* {@link AffineTransform} and implements {@link MathTransform2D}, so it can be used as a bridge
* between Java2D and the referencing module. Note that this bridge role involves a tricky issue with
* the {@link #equals(Object) equals} method, hopefully to occur only in exceptional corner cases.
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/builder/LocalizationGridBuilder.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/builder/LocalizationGridBuilder.java
index aaedbe2834..f6956e0a56 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/builder/LocalizationGridBuilder.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/builder/LocalizationGridBuilder.java
@@ -54,7 +54,7 @@ import static org.apache.sis.referencing.operation.builder.ResidualGrid.SOURCE_D
/**
* Creates an "almost linear" transform mapping the given source points to the given target points.
- * The transform is backed by a <cite>grid of localization</cite>, a two-dimensional array of coordinate points.
+ * The transform is backed by a <cite>grid of localization</cite>, a two-dimensional array of coordinate tuples.
* Grid size is {@code width} × {@code height} and input coordinates are (<var>i</var>,<var>j</var>) indices in the grid,
* where <var>i</var> must be in the [0…{@code width}-1] range and <var>j</var> in the [0…{@code height}-1] range inclusive.
* Output coordinates are the values stored in the grid of localization at the specified index.
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 19bc0d2234..fc1e246ffb 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
@@ -233,7 +233,7 @@ public class AlbersEqualArea extends AuthalicConversion {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
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 039802ad48..656c64a4c2 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
@@ -76,7 +76,7 @@ final class AuthalicMercator extends AuthalicConversion {
}
/**
- * Converts a list of coordinate points. This method performs the same calculation than above
+ * Converts a list of coordinate tuples. This method performs the same calculation than above
* {@link #transform(double[], int, double[], int, boolean)} method, but is overridden for efficiency.
*
* @throws TransformException if a point can not be converted.
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 500c481a94..33e376a214 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
@@ -161,14 +161,14 @@ public class AzimuthalEquidistant extends NormalizedProjection {
* 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.
- * @param dstPts the array into which the converted coordinate is returned (may be the same than {@code srcPts}).
- * @param dstOff the offset of the location of the converted coordinate that is stored in the destination array.
+ * @param srcPts source point coordinates, as (<var>longitude</var>, <var>latitude</var>) in radians.
+ * @param srcOff the offset of the single coordinate tuple to be converted in the source array.
+ * @param dstPts the array into which the converted coordinates is returned (may be the same than {@code srcPts}).
+ * @param dstOff the offset of the location of the converted coordinates that is stored in the destination array.
* @param derivate {@code true} for computing the derivative, or {@code false} if not needed.
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
@@ -215,9 +215,9 @@ public class AzimuthalEquidistant extends NormalizedProjection {
* Converts the specified (<var>x</var>,<var>y</var>) coordinates
* and stores the result in {@code dstPts} (angles in radians).
*
- * @param srcPts the array containing the source point coordinate, as linear distance on a unit sphere or ellipse.
+ * @param srcPts the array containing the source point coordinates, as linear distance on a unit sphere or ellipse.
* @param srcOff the offset of the point to be converted in the source array.
- * @param dstPts the array into which the converted point coordinate is returned (may be the same than {@code srcPts}).
+ * @param dstPts the array into which the converted point coordinates is returned (may be the same than {@code srcPts}).
* @param dstOff the offset of the location of the converted point that is stored in the destination array.
* @throws ProjectionException if the point can not be converted.
*/
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 aba65189a4..8931e9ad8f 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
@@ -237,16 +237,16 @@ public class CassiniSoldner extends MeridianArcBased {
* 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,
+ * @param srcPts the array containing the source point coordinates,
* as (<var>longitude</var>, <var>latitude</var>) angles in <strong>radians</strong>.
- * @param srcOff the offset of the single coordinate to be converted in the source array.
- * @param dstPts the array into which the converted coordinate is returned (may be the same than {@code srcPts}).
+ * @param srcOff the offset of the single coordinate tuple to be converted in the source array.
+ * @param dstPts the array into which the converted coordinates is returned (may be the same than {@code srcPts}).
* Coordinates will be expressed in a dimensionless unit, as a linear distance on a unit sphere or ellipse.
- * @param dstOff the offset of the location of the converted coordinate that is stored in the destination array.
+ * @param dstOff the offset of the location of the converted coordinates that is stored in the destination array.
* @param derivate {@code true} for computing the derivative, or {@code false} if not needed.
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
@@ -318,9 +318,9 @@ public class CassiniSoldner extends MeridianArcBased {
* Converts the specified (<var>x</var>,<var>y</var>) coordinates
* and stores the result in {@code dstPts} (angles in radians).
*
- * @param srcPts the array containing the source point coordinate, as linear distance on a unit sphere or ellipse.
+ * @param srcPts the array containing the source point coordinates, as linear distance on a unit sphere or ellipse.
* @param srcOff the offset of the point to be converted in the source array.
- * @param dstPts the array into which the converted point coordinate is returned (may be the same than {@code srcPts}).
+ * @param dstPts the array into which the converted point coordinates is returned (may be the same than {@code srcPts}).
* Coordinates will be (<var>longitude</var>, <var>latitude</var>) angles in <strong>radians</strong>.
* @param dstOff the offset of the location of the converted point that is stored in the destination array.
* @throws ProjectionException if the point can not be converted.
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 2261170a1c..ef90d7493e 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
@@ -236,7 +236,7 @@ public class CylindricalEqualArea extends AuthalicConversion {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
@@ -256,7 +256,7 @@ public class CylindricalEqualArea extends AuthalicConversion {
}
/**
- * Converts a list of coordinate points. This method performs the same calculation than above
+ * Converts a list of coordinate tuples. This method performs the same calculation than above
* {@link #transform(double[], int, double[], int, boolean)} method, but is overridden for efficiency.
*
* @throws TransformException if a point can not be converted.
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 1ba7d954e2..c17dcf8474 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
@@ -169,7 +169,7 @@ public class LambertAzimuthalEqualArea extends AuthalicConversion {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
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 459212d8eb..911a4dd001 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
@@ -449,7 +449,7 @@ public class LambertConicConformal extends ConformalProjection {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
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 e0fed8164e..1059bd8a6a 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
@@ -414,7 +414,7 @@ subst: if (variant.spherical || (eccentricity == 0 && getClass() == Mercator.cl
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
@@ -457,7 +457,7 @@ subst: if (variant.spherical || (eccentricity == 0 && getClass() == Mercator.cl
}
/**
- * Converts a list of coordinate points. This method performs the same calculation than above
+ * Converts a list of coordinate tuples. This method performs the same calculation than above
* {@link #transform(double[], int, double[], int, boolean)} method, but is overridden for efficiency.
*
* @throws TransformException if a point can not be converted.
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 0a50fe366e..a4d1a74cf0 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,13 +155,13 @@ public class ModifiedAzimuthalEquidistant extends AzimuthalEquidistant {
}
/**
- * Projects the specified (λ,φ) coordinate (units in radians)
+ * Projects the specified (λ,φ) coordinates (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}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
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 5285f2aee2..aeb3fa02e5 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
@@ -125,7 +125,7 @@ public class Mollweide extends NormalizedProjection {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
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 07946d56a6..6717376c01 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
@@ -697,9 +697,9 @@ public abstract class NormalizedProjection extends AbstractMathTransform2D imple
* <h4>Normalization</h4>
* The input coordinates are (<var>λ</var>,<var>φ</var>) (the variable names for <var>longitude</var> and
* <var>latitude</var> respectively) angles in radians, eventually pre-multiplied by projection-specific factors.
- * Input coordinate shall have the <cite>central meridian</cite> removed from the longitude by the caller
+ * Input coordinates shall have the <cite>central meridian</cite> removed from the longitude by the caller
* before this method is invoked. After this method is invoked, the caller will need to multiply the output
- * coordinate by the global <cite>scale factor</cite>,
+ * coordinates by the global <cite>scale factor</cite>,
* apply the (<cite>false easting</cite>, <cite>false northing</cite>) offset
* and eventually other projection-specific factors.
* This means that projections that implement this method are performed on a sphere or ellipse
@@ -721,40 +721,40 @@ public abstract class NormalizedProjection extends AbstractMathTransform2D imple
* If this assumption is not applicable to a particular subclass, then it is implementer responsibility to check
* the range.
*
- * @param srcPts the array containing the source point coordinate, as (<var>longitude</var>, <var>latitude</var>)
+ * @param srcPts the array containing the source point coordinates, as (<var>longitude</var>, <var>latitude</var>)
* angles in <strong>radians</strong>.
- * @param srcOff the offset of the single coordinate to be converted in the source array.
- * @param dstPts the array into which the converted coordinate is returned (may be the same than {@code srcPts}).
+ * @param srcOff the offset of the single coordinate tuple to be converted in the source array.
+ * @param dstPts the array into which the converted coordinates is returned (may be the same than {@code srcPts}).
* Coordinates will be expressed in a dimensionless unit, as a linear distance on a unit sphere or ellipse.
- * @param dstOff the offset of the location of the converted coordinate that is stored in the destination array.
+ * @param dstOff the offset of the location of the converted coordinates that is stored in the destination array.
* @param derivate {@code true} for computing the derivative, or {@code false} if not needed.
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public abstract Matrix transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, boolean derivate)
throws ProjectionException;
/**
- * Inverse converts the single coordinate in {@code srcPts} at the given offset and stores the result in
+ * Inverse converts the single coordinate tuple in {@code srcPts} at the given offset and stores the result in
* {@code ptDst} at the given offset. The output coordinates are (<var>longitude</var>, <var>latitude</var>)
* angles in radians, usually (but not necessarily) in the range [-π … π] and [-π/2 … π/2] respectively.
*
* <h4>Normalization</h4>
- * Input coordinate shall have the (<cite>false easting</cite>, <cite>false northing</cite>) removed
+ * Input coordinates shall have the (<cite>false easting</cite>, <cite>false northing</cite>) removed
* by the caller and the result divided by the global <cite>scale factor</cite> before this method is invoked.
* After this method is invoked, the caller will need to add the <cite>central meridian</cite> to the longitude
- * in the output coordinate. This means that projections that implement this method are performed on a sphere
+ * in the output coordinates. This means that projections that implement this method are performed on a sphere
* or ellipse having a semi-major axis of 1.
* Additional projection-specific factors may also need to be applied (see class javadoc).
*
* <div class="note"><b>Note:</b> in the <a href="https://proj.org/">PROJ</a> library, the same standardization,
* described above, is handled by {@code pj_inv.c}, except for the projection-specific additional factors.</div>
*
- * @param srcPts the array containing the source point coordinate, as linear distance on a unit sphere or ellipse.
+ * @param srcPts the array containing the source point coordinates, as linear distance on a unit sphere or ellipse.
* @param srcOff the offset of the point to be converted in the source array.
- * @param dstPts the array into which the converted point coordinate is returned (may be the same than {@code srcPts}).
+ * @param dstPts the array into which the converted point coordinates is returned (may be the same than {@code srcPts}).
* Coordinates will be (<var>longitude</var>, <var>latitude</var>) angles in <strong>radians</strong>.
* @param dstOff the offset of the location of the converted point that is stored in the destination array.
* @throws ProjectionException if the point can not be converted.
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 b3cc32a43d..32793344dd 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
@@ -333,7 +333,7 @@ public class ObliqueMercator extends ConformalProjection {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
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 fcd61d7014..7e71293a4d 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
@@ -264,7 +264,7 @@ public class ObliqueStereographic extends NormalizedProjection {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
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 95a2664d34..5e276ce233 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
@@ -151,7 +151,7 @@ public class Orthographic extends NormalizedProjection {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
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 ce77e48301..eea95aecaa 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
@@ -323,7 +323,7 @@ public class PolarStereographic extends ConformalProjection {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ProjectionException.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ProjectionException.java
index 9299856678..8dd8b4cfe6 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ProjectionException.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/ProjectionException.java
@@ -32,7 +32,7 @@ import org.opengis.referencing.operation.TransformException;
* <li>If the expected mathematical value is infinite (for example the Mercator projection at ±90° of latitude),
* then the map projection should return a {@link Double#POSITIVE_INFINITY} or {@link Double#NEGATIVE_INFINITY},
* depending on the sign of the correct mathematical answer.</li>
- * <li>If no real number is expected to exist for the input coordinate (for example at a latitude greater than 90°),
+ * <li>If no real number is expected to exist for the input coordinates (for example at a latitude greater than 90°),
* then the map projection should return {@link Double#NaN}.</li>
* <li>If a real number is expected to exist but the map projection fails to compute it (for example because an
* iterative algorithm does not converge), then the projection should throw {@code ProjectionException}.</li>
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 0912b32535..1a58c6a1d3 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
@@ -170,7 +170,7 @@ public class Sinusoidal extends MeridianArcBased {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
@@ -260,7 +260,7 @@ public class Sinusoidal extends MeridianArcBased {
}
/**
- * Converts a list of coordinate points. This method performs the same calculation than above
+ * Converts a list of coordinate tuples. This method performs the same calculation than above
* {@link #transform(double[], int, double[], int, boolean)} method, but is overridden for efficiency.
*/
@Override
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 2ad53aa22b..3f6ebf450e 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
@@ -448,7 +448,7 @@ public class TransverseMercator extends NormalizedProjection {
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws ProjectionException if the coordinate can not be converted.
+ * @throws ProjectionException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
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 524c6fda0e..af043a9996 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
@@ -171,7 +171,7 @@ public class ZonedGridSystem extends AbstractMathTransform2D implements Serializ
*
* @return the matrix of the projection derivative at the given source position,
* or {@code null} if the {@code derivate} argument is {@code false}.
- * @throws TransformException if the coordinate can not be converted.
+ * @throws TransformException if the coordinates can not be converted.
*/
@Override
public Matrix transform(final double[] srcPts, final int srcOff,
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform.java
index fc1a8547a8..e4656ca3dc 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform.java
@@ -293,9 +293,9 @@ public abstract class AbstractMathTransform extends FormattableObject
*
* This method does not update the associated {@link org.opengis.referencing.crs.CoordinateReferenceSystem} value.
*
- * @param ptSrc the coordinate point to be transformed.
- * @param ptDst the coordinate point that stores the result of transforming {@code ptSrc}, or {@code null}.
- * @return the coordinate point after transforming {@code ptSrc} and storing the result in {@code ptDst},
+ * @param ptSrc the coordinate tuple to be transformed.
+ * @param ptDst the coordinate tuple that stores the result of transforming {@code ptSrc}, or {@code null}.
+ * @return the coordinate tuple after transforming {@code ptSrc} and storing the result in {@code ptDst},
* or a newly created point if {@code ptDst} was null.
* @throws MismatchedDimensionException if {@code ptSrc} or {@code ptDst} doesn't have the expected dimension.
* @throws TransformException if the point can not be transformed.
@@ -346,7 +346,7 @@ public abstract class AbstractMathTransform extends FormattableObject
}
/**
- * Transforms a single coordinate point in an array, and optionally computes the transform
+ * Transforms a single coordinate tuple in an array, and optionally computes the transform
* derivative at that location. Invoking this method is conceptually equivalent to running
* the following:
*
@@ -377,9 +377,9 @@ public abstract class AbstractMathTransform extends FormattableObject
* The source and destination may overlap. Consequently, implementers must read all source
* coordinate values before to start writing the transformed coordinates in the destination array.
*
- * @param srcPts the array containing the source coordinate (can not be {@code null}).
+ * @param srcPts the array containing the source coordinates (can not be {@code null}).
* @param srcOff the offset to the point to be transformed in the source array.
- * @param dstPts the array into which the transformed coordinate is returned. May be the same than {@code srcPts}.
+ * @param dstPts the array into which the transformed coordinates is returned. May be the same than {@code srcPts}.
* May be {@code null} if only the derivative matrix is desired.
* @param dstOff the offset to the location of the transformed point that is stored in the destination array.
* @param derivate {@code true} for computing the derivative, or {@code false} if not needed.
@@ -396,7 +396,7 @@ public abstract class AbstractMathTransform extends FormattableObject
throws TransformException;
/**
- * Transforms a list of coordinate points. This method is provided for efficiently transforming many points.
+ * Transforms a list of coordinate tuples. This method is provided for efficiently transforming many points.
* The supplied array of coordinate values will contain packed coordinate values.
*
* <div class="note"><b>Example:</b> if the source dimension is 3, then the coordinates will be packed in this order:
@@ -507,7 +507,7 @@ public abstract class AbstractMathTransform extends FormattableObject
/*
* If some points failed to be transformed, let the first exception propagate.
* But before doing so we declare that this transform has nevertheless be able
- * to process all coordinate points, setting them to NaN when transform failed.
+ * to process all coordinate tuples, setting them to NaN when transform failed.
*/
if (failure != null) {
failure.setLastCompletedTransform(this);
@@ -516,7 +516,7 @@ public abstract class AbstractMathTransform extends FormattableObject
}
/**
- * Transforms a list of coordinate points. The default implementation delegates
+ * Transforms a list of coordinate tuples. The default implementation delegates
* to {@link #transform(double[], int, double[], int, int)} using a temporary array of doubles.
*
* <div class="note"><b>Implementation note:</b> see {@link IterationStrategy} javadoc for a method skeleton.</div>
@@ -556,10 +556,10 @@ public abstract class AbstractMathTransform extends FormattableObject
/*
* We need to check if writing the transformed coordinates in the same array than the source
* coordinates will cause an overlapping problem. However we can consider the whole buffer as
- * if it was a single coordinate with a very large dimension. Doing so increase the chances
+ * if it was a single coordinate tuple with a very large dimension. Doing so increase the chances
* that IterationStrategy.suggest(...) doesn't require us an other buffer (hint: the -1 in
- * suggest(...) mathematic matter and reflect the contract saying that the input coordinate
- * must be fully read before the output coordinate is written - which is the behavior we get
+ * suggest(...) mathematic matter and reflect the contract saying that the input coordinates
+ * must be fully read before the output coordinates is written - which is the behavior we get
* with our buffer).
*/
int srcInc = dimSource * numBufferedPts;
@@ -588,8 +588,8 @@ public abstract class AbstractMathTransform extends FormattableObject
}
}
/*
- * Computes the offset of the first source coordinate in the buffer. The offset of the
- * first destination coordinate will always be zero. We compute the source offset in
+ * Computes the offset of the first source coordinates in the buffer. The offset of the
+ * first destination coordinates will always be zero. We compute the source offset in
* such a way that the default transform(double[],int,double[],int,int) implementation
* should never needs to copy the source coordinates in yet an other temporary buffer.
* We will verify that with an assert statement inside the do loop.
@@ -621,7 +621,7 @@ public abstract class AbstractMathTransform extends FormattableObject
} catch (TransformException exception) {
/*
* If an exception occurred but the transform nevertheless declares having been
- * able to process all coordinate points (setting to NaN those that can not be
+ * able to process all coordinate tuples (setting to NaN those that can not be
* transformed), we will keep the first exception (to be propagated at the end
* of this method) and continue. Otherwise we will stop immediately.
*/
@@ -646,7 +646,7 @@ public abstract class AbstractMathTransform extends FormattableObject
}
/**
- * Transforms a list of coordinate points. The default implementation delegates
+ * Transforms a list of coordinate tuples. The default implementation delegates
* to {@link #transform(double[], int, double[], int, int)} using a temporary array of doubles.
*
* @param srcPts the array containing the source point coordinates.
@@ -709,7 +709,7 @@ public abstract class AbstractMathTransform extends FormattableObject
}
/**
- * Transforms a list of coordinate points. The default implementation delegates
+ * Transforms a list of coordinate tuples. The default implementation delegates
* to {@link #transform(double[], int, double[], int, int)} using a temporary array of doubles
* if necessary.
*
@@ -787,27 +787,27 @@ public abstract class AbstractMathTransform extends FormattableObject
* <ul>
* <li>Ensure that the {@code point} dimension is equal to this math transform
* {@linkplain #getSourceDimensions() source dimensions}.</li>
- * <li>Copy the coordinate in a temporary array and pass that array to the
+ * <li>Copy the coordinates in a temporary array and pass that array to the
* {@link #transform(double[], int, double[], int, boolean)} method,
* with the {@code derivate} boolean argument set to {@code true}.</li>
* <li>If the latter method returned a non-null matrix, returns that matrix.
* Otherwise throws {@link TransformException}.</li>
* </ul>
*
- * @param point the coordinate point where to evaluate the derivative.
+ * @param point the coordinate tuple where to evaluate the derivative.
* @return the derivative at the specified point (never {@code null}).
- * @throws NullPointerException if the derivative depends on coordinate and {@code point} is {@code null}.
+ * @throws NullPointerException if the derivative depends on coordinates and {@code point} is {@code null}.
* @throws MismatchedDimensionException if {@code point} does not have the expected dimension.
* @throws TransformException if the derivative can not be evaluated at the specified point.
*/
@Override
public Matrix derivative(final DirectPosition point) throws TransformException {
final int dimSource = getSourceDimensions();
- final double[] coordinate = point.getCoordinate();
- if (coordinate.length != dimSource) {
- throw mismatchedDimension("point", dimSource, coordinate.length);
+ final double[] coordinates = point.getCoordinate();
+ if (coordinates.length != dimSource) {
+ throw mismatchedDimension("point", dimSource, coordinates.length);
}
- final Matrix derivative = transform(coordinate, 0, null, 0, true);
+ final Matrix derivative = transform(coordinates, 0, null, 0, true);
if (derivative == null) {
throw new TransformException(Resources.format(Resources.Keys.CanNotComputeDerivative));
}
@@ -1139,7 +1139,7 @@ public abstract class AbstractMathTransform extends FormattableObject
* returned by the {@linkplain #inverse() inverse} math transform.
*
* @return {@inheritDoc}
- * @throws NullPointerException if the derivative depends on coordinate and {@code point} is {@code null}.
+ * @throws NullPointerException if the derivative depends on coordinates and {@code point} is {@code null}.
* @throws MismatchedDimensionException if {@code point} does not have the expected dimension.
* @throws TransformException if the derivative can not be evaluated at the specified point.
*/
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform1D.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform1D.java
index c22073277b..78b36ab5ec 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform1D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform1D.java
@@ -124,7 +124,7 @@ public abstract class AbstractMathTransform1D extends AbstractMathTransform impl
* Gets the derivative of this transform at a point. The default implementation ensures that
* {@code point} is one-dimensional, then delegates to {@link #derivative(double)}.
*
- * @param point the coordinate point where to evaluate the derivative, or {@code null}.
+ * @param point the position where to evaluate the derivative, or {@code null}.
* @return the derivative at the specified point (never {@code null}).
* @throws MismatchedDimensionException if {@code point} does not have the expected dimension.
* @throws TransformException if the derivative can not be evaluated at the specified point.
@@ -204,7 +204,7 @@ public abstract class AbstractMathTransform1D extends AbstractMathTransform impl
* Gets the derivative of this transform at a point. The default implementation ensures that
* {@code point} is one-dimensional, then delegates to {@link #derivative(double)}.
*
- * @param point the coordinate point where to evaluate the derivative, or {@code null}.
+ * @param point the position where to evaluate the derivative, or {@code null}.
* @return the derivative at the specified point (never {@code null}).
* @throws MismatchedDimensionException if {@code point} does not have the expected dimension.
* @throws TransformException if the derivative can not be evaluated at the specified point.
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform2D.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform2D.java
index 535a88952e..ded14220bc 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform2D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform2D.java
@@ -106,10 +106,10 @@ public abstract class AbstractMathTransform2D extends AbstractMathTransform impl
* The default implementation invokes {@link #transform(double[], int, double[], int, boolean)}
* using a temporary array of doubles.
*
- * @param ptSrc the coordinate point to be transformed.
- * @param ptDst the coordinate point that stores the result of transforming {@code ptSrc},
+ * @param ptSrc the coordinate tuple to be transformed.
+ * @param ptDst the coordinate tuple that stores the result of transforming {@code ptSrc},
* or {@code null} if a new point shall be created.
- * @return the coordinate point after transforming {@code ptSrc} and storing the result in {@code ptDst},
+ * @return the coordinate tuple after transforming {@code ptSrc} and storing the result in {@code ptDst},
* or in a new point if {@code ptDst} was null.
* @throws TransformException if the point can not be transformed.
*
@@ -305,14 +305,14 @@ public abstract class AbstractMathTransform2D extends AbstractMathTransform impl
* The default implementation performs the following steps:
*
* <ul>
- * <li>Copy the coordinate in a temporary array and pass that array to the
+ * <li>Copy the coordinates in a temporary array and pass that array to the
* {@link #transform(double[], int, double[], int, boolean)} method,
* with the {@code derivate} boolean argument set to {@code true}.</li>
* <li>If the latter method returned a non-null matrix, returns that matrix.
* Otherwise throws {@link TransformException}.</li>
* </ul>
*
- * @param point the coordinate point where to evaluate the derivative.
+ * @param point the coordinate tuple where to evaluate the derivative.
* @return the derivative at the specified point as a 2×2 matrix.
* @throws TransformException if the derivative can not be evaluated at the specified point.
*/
@@ -325,8 +325,8 @@ public abstract class AbstractMathTransform2D extends AbstractMathTransform impl
* Implementation of {@link #derivative(DirectPosition)} shared by the inverse transform.
*/
static Matrix derivative(final AbstractMathTransform tr, final Point2D point) throws TransformException {
- final double[] coordinate = new double[] {point.getX(), point.getY()};
- final Matrix derivative = tr.transform(coordinate, 0, null, 0, true);
+ final double[] coordinates = new double[] {point.getX(), point.getY()};
+ final Matrix derivative = tr.transform(coordinates, 0, null, 0, true);
if (derivative == null) {
throw new TransformException(Resources.format(Resources.Keys.CanNotComputeDerivative));
}
@@ -377,10 +377,10 @@ public abstract class AbstractMathTransform2D extends AbstractMathTransform impl
* The default implementation invokes {@link #transform(double[], int, double[], int, boolean)}
* using a temporary array of doubles.
*
- * @param ptSrc the coordinate point to be transformed.
- * @param ptDst the coordinate point that stores the result of transforming {@code ptSrc},
+ * @param ptSrc the coordinate tuple to be transformed.
+ * @param ptDst the coordinate tuple that stores the result of transforming {@code ptSrc},
* or {@code null} if a new point shall be created.
- * @return the coordinate point after transforming {@code ptSrc} and storing the result in {@code ptDst},
+ * @return the coordinate tuple after transforming {@code ptSrc} and storing the result in {@code ptDst},
* or in a new point if {@code ptDst} was null.
* @throws TransformException if the point can not be transformed.
*
@@ -411,14 +411,14 @@ public abstract class AbstractMathTransform2D extends AbstractMathTransform impl
* The default implementation performs the following steps:
*
* <ul>
- * <li>Copy the coordinate in a temporary array and pass that array to the
+ * <li>Copy the coordinates in a temporary array and pass that array to the
* {@link #transform(double[], int, double[], int, boolean)} method,
* with the {@code derivate} boolean argument set to {@code true}.</li>
* <li>If the latter method returned a non-null matrix, returns that matrix.
* Otherwise throws {@link TransformException}.</li>
* </ul>
*
- * @param point the coordinate point where to evaluate the derivative.
+ * @param point the coordinate tuple where to evaluate the derivative.
* @return the derivative at the specified point as a 2×2 matrix.
* @throws TransformException if the derivative can not be evaluated at the specified point.
*/
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform.java
index e2d3a44810..62f1c927e0 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform.java
@@ -650,7 +650,7 @@ class ConcatenatedTransform extends AbstractMathTransform implements Serializabl
if (length > MAXIMUM_BUFFER_SIZE) {
numBuf = Math.max(1, MAXIMUM_BUFFER_SIZE / bufferDim);
if (srcPts == dstPts) {
- // Since we are using a buffer, the whole buffer is like a single coordinate point.
+ // Since we are using a buffer, the whole buffer is like a single coordinate tuple.
switch (IterationStrategy.suggest(srcOff, numBuf*sourceDim, dstOff, numBuf*targetDim, numPts)) {
default: {
// Needs to copy the whole data.
@@ -846,7 +846,7 @@ class ConcatenatedTransform extends AbstractMathTransform implements Serializabl
/**
* Gets the derivative of this transform at a point.
*
- * @param point the coordinate point where to evaluate the derivative.
+ * @param point the position where to evaluate the derivative.
* @return the derivative at the specified point (never {@code null}).
* @throws TransformException if the derivative can't be evaluated at the specified point.
*/
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform2D.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform2D.java
index f7710f05de..5d1532765f 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform2D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform2D.java
@@ -93,7 +93,7 @@ final class ConcatenatedTransform2D extends ConcatenatedTransform implements Mat
* {@link #derivative(DirectPosition)} method because the transformation steps
* {@link #transform1} and {@link #transform2} may not be instances of {@link MathTransform2D}.
*
- * @param point the coordinate point where to evaluate the derivative.
+ * @param point the position where to evaluate the derivative.
* @return the derivative at the specified point as a 2×2 matrix.
* @throws TransformException if the derivative can't be evaluated at the specified point.
*/
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformDirect2D.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformDirect2D.java
index a71febbf96..9a8761e5a0 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformDirect2D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformDirect2D.java
@@ -85,7 +85,7 @@ final class ConcatenatedTransformDirect2D extends ConcatenatedTransformDirect im
/**
* Gets the derivative of this transform at a point.
*
- * @param point the coordinate point where to evaluate the derivative.
+ * @param point the position where to evaluate the derivative.
* @return the derivative at the specified point (never {@code null}).
* @throws TransformException if the derivative can't be evaluated at the specified point.
*/
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/CoordinateSystemTransform.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/CoordinateSystemTransform.java
index 86ad430804..7e38b4cf47 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/CoordinateSystemTransform.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/CoordinateSystemTransform.java
@@ -150,7 +150,7 @@ abstract class CoordinateSystemTransform extends AbstractMathTransform {
}
/**
- * Returns the number of dimensions in the source coordinate points.
+ * Returns the number of dimensions in the source coordinate tuples.
* Shall be equal to {@code getSourceCS().getDimension()}.
*/
@Override
@@ -159,7 +159,7 @@ abstract class CoordinateSystemTransform extends AbstractMathTransform {
}
/**
- * Returns the number of dimensions in the target coordinate points.
+ * Returns the number of dimensions in the target coordinate tuples.
* Shall be equal to {@code getTargetCS().getDimension()}.
*/
@Override
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/EllipsoidToCentricTransform.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/EllipsoidToCentricTransform.java
index ce4215e9d7..46acd77895 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/EllipsoidToCentricTransform.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/EllipsoidToCentricTransform.java
@@ -488,7 +488,7 @@ public class EllipsoidToCentricTransform extends AbstractMathTransform implement
* transform derivative, because that calculation needs to inverse a square matrix with all terms in it before
* to drop the last row in the two-dimensional case.</div>
*
- * @param point the coordinate point where to evaluate the derivative.
+ * @param point the position where to evaluate the derivative.
* @return the derivative at the specified point (never {@code null}).
* @throws TransformException if the derivative can not be evaluated at the specified point.
*/
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 92e89ebc8c..82c1b08aae 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
@@ -362,7 +362,7 @@ public class PoleRotation extends AbstractMathTransform2D implements Serializabl
}
/**
- * Transforms a single coordinate point in an array,
+ * Transforms a single coordinate tuple in an array,
* and optionally computes the transform derivative at that location.
* Source and target axis order is (<var>longitude</var>, <var>latitude</var>).
*/
@@ -421,7 +421,7 @@ public class PoleRotation extends AbstractMathTransform2D implements Serializabl
}
/**
- * Converts a list of coordinate points. This method performs the same calculation than above
+ * Converts a list of coordinate tuples. This method performs the same calculation than above
* {@link #transform(double[], int, double[], int, boolean)} method, but is overridden for efficiency.
*
* @throws TransformException if a point can not be converted.
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ProjectiveTransform.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ProjectiveTransform.java
index f7e65b416d..95d14e09ab 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ProjectiveTransform.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ProjectiveTransform.java
@@ -207,7 +207,7 @@ class ProjectiveTransform extends AbstractLinearTransform implements ExtendedPre
}
/**
- * Converts a single coordinate point in a list of coordinate values,
+ * Converts a single coordinate tuple in a list of coordinate values,
* and optionally computes the derivative at that location.
*
* @return {@inheritDoc}
@@ -436,7 +436,7 @@ class ProjectiveTransform extends AbstractLinearTransform implements ExtendedPre
* the derivative is the same everywhere and the given point is ignored.
* For a perspective transform, the given point is used.
*
- * @param point the coordinate point where to evaluate the derivative.
+ * @param point the coordinate tuple where to evaluate the derivative.
*/
@Override
public final Matrix derivative(final DirectPosition point) {
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/SpecializableTransform.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/SpecializableTransform.java
index 25cd5b884d..8e4f5ed9a3 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/SpecializableTransform.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/SpecializableTransform.java
@@ -278,7 +278,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Transforms a single coordinate point in an array, and optionally computes the transform
+ * Transforms a single coordinate tuple in an array, and optionally computes the transform
* derivative at that location. This method delegates to the most specialized transform.
*/
@Override
@@ -311,7 +311,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Transforms a list of coordinate points. This method delegates to the most specialized transform,
+ * Transforms a list of coordinate tuples. This method delegates to the most specialized transform,
* with single {@code transform(…)} calls for coordinate sequences as long as possible.
*
* @param transform caller for a {@code MathTransform.transform(…)} method.
@@ -358,7 +358,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
* This method delegates to the most specialized transform.
*/
@Override
@@ -391,7 +391,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Transforms a list of coordinate points.
+ * Transforms a list of coordinate tuples.
* This method delegates to the most specialized transform.
*/
@Override
@@ -424,7 +424,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Transforms a list of coordinate points. This method delegates to the most specialized transform,
+ * Transforms a list of coordinate tuples. This method delegates to the most specialized transform,
* with single {@code transform(…)} calls for coordinate sequences as long as possible.
*/
@Override
@@ -440,7 +440,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Transforms a list of coordinate points. This method delegates to the most specialized transform,
+ * Transforms a list of coordinate tuples. This method delegates to the most specialized transform,
* with single {@code transform(…)} calls for coordinate sequences as long as possible.
*/
@Override
@@ -580,7 +580,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Inverse transforms a single coordinate point in an array, and optionally computes the transform
+ * Inverse transforms a single coordinate tuple in an array, and optionally computes the transform
* derivative at that location.
*/
@Override
@@ -661,7 +661,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Inverse transforms a list of coordinate points.
+ * Inverse transforms a list of coordinate tuples.
* The transformed points are written directly in the destination array.
*/
@Override
@@ -684,7 +684,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Inverse transforms a list of coordinate points. This method uses an temporary {@code double[]} buffer
+ * Inverse transforms a list of coordinate tuples. This method uses an temporary {@code double[]} buffer
* for testing {@code SubArea} inclusion with full precision before to cast to {@code float} values.
*/
@Override
@@ -706,7 +706,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Inverse transforms a list of coordinate points. This method uses an temporary {@code double[]} buffer
+ * Inverse transforms a list of coordinate tuples. This method uses an temporary {@code double[]} buffer
* for testing {@code SubArea} inclusion with full precision before to cast to {@code float} values.
*/
@Override
@@ -727,7 +727,7 @@ class SpecializableTransform extends AbstractMathTransform implements Serializab
}
/**
- * Inverse transforms a list of coordinate points.
+ * Inverse transforms a list of coordinate tuples.
* The transformed points are written directly in the destination array.
*/
@Override
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/WraparoundTransform.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/WraparoundTransform.java
index 5cb4253d44..65a3f6ac0c 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/WraparoundTransform.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/WraparoundTransform.java
@@ -375,7 +375,7 @@ public class WraparoundTransform extends AbstractMathTransform implements Serial
* Furthermore whether a source coordinate is an integer value or not is subject to rounding errors,
* which may cause unpredictable behavior if infinite values were returned.</div>
*
- * @param point the coordinate point where to evaluate the derivative
+ * @param point the position where to evaluate the derivative
* (ignored in default implementation, may be {@code null}).
* @return transform derivative (identity matrix in default implementation).
*/
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/package-info.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/package-info.java
index 08e117e96e..45e010e1c6 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/package-info.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/package-info.java
@@ -16,7 +16,7 @@
*/
/**
- * Conversions or transformations of multi-dimensional coordinate points.
+ * Conversions or transformations of multi-dimensional coordinate tuples.
* {@link org.opengis.referencing.operation.MathTransform} provides a single API for
* coordinate conversions or transformations, including map projections.
* Each {@code MathTransform} instances can:
diff --git a/core/sis-referencing/src/test/java/org/apache/sis/internal/referencing/j2d/ShapeUtilitiesViewer.java b/core/sis-referencing/src/test/java/org/apache/sis/internal/referencing/j2d/ShapeUtilitiesViewer.java
index 8d917a9dd8..ffa167f894 100644
--- a/core/sis-referencing/src/test/java/org/apache/sis/internal/referencing/j2d/ShapeUtilitiesViewer.java
+++ b/core/sis-referencing/src/test/java/org/apache/sis/internal/referencing/j2d/ShapeUtilitiesViewer.java
@@ -86,7 +86,7 @@ public final strictfp class ShapeUtilitiesViewer extends JPanel {
private final Random random;
/**
- * Where to write the coordinate points.
+ * Where to write the coordinate tuples.
*/
private final PrintWriter out;
diff --git a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/PolarToCartesianTest.java b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/PolarToCartesianTest.java
index d0ee8b75bd..f1eb32764e 100644
--- a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/PolarToCartesianTest.java
+++ b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/PolarToCartesianTest.java
@@ -40,7 +40,7 @@ import org.junit.Test;
*/
public final strictfp class PolarToCartesianTest extends TransformTestCase {
/**
- * Returns coordinate points in polar or cylindrical coordinates and their equivalent in Cartesian coordinates.
+ * Returns coordinate tuples in polar or cylindrical coordinates and their equivalent in Cartesian coordinates.
*/
static double[][] testData(final boolean withHeight) {
final double z = 20;
diff --git a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/SphericalToCartesianTest.java b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/SphericalToCartesianTest.java
index 9428cad3d7..b69851f491 100644
--- a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/SphericalToCartesianTest.java
+++ b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/SphericalToCartesianTest.java
@@ -40,7 +40,7 @@ import org.junit.Test;
*/
public final strictfp class SphericalToCartesianTest extends TransformTestCase {
/**
- * Returns coordinate points in spherical coordinates and their equivalent in Cartesian coordinates.
+ * Returns coordinate tuples in spherical coordinates and their equivalent in Cartesian coordinates.
*/
static double[][] testData() {
final double r = 1000;