svn commit: r1667810 - /sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java

[de...@apache.org]

Author: desruisseaux
Date: Thu Mar 19 16:38:58 2015
New Revision: 1667810

URL: http://svn.apache.org/r1667810
Log:
Renamed normalize(boolean) as normalization(boolean) because "normalize" was suggesting that the method performs
a normalization, which was not the intend. Instead, the method returns information about the normalization.

Modified:
    sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java

Modified: sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java?rev=1667810&r1=1667809&r2=1667810&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/NonLinearParameters.java [UTF-8] Thu Mar 19 16:38:58 2015
@@ -67,7 +67,7 @@ public abstract class NonLinearParameter
 
     /**
      * The descriptor that represents this tuple as a whole. The parameter values may take effect in either the
-     * {@linkplain #normalize(boolean) normalize/denormalize} transforms or in the kernel.
+     * {@linkplain #normalization(boolean) normalize/denormalize} transforms or in the kernel.
      *
      * @see #getParameterDescriptors()
      */
@@ -76,11 +76,11 @@ public abstract class NonLinearParameter
     /**
      * The affine transform to be applied before (<cite>normalize</cite>) and after (<cite>denormalize</cite>)
      * the kernel operation. On {@code NonLinearParameters} construction, those affines are initially identity
-     * transforms, to be modified in-place by callers of {@link #normalize(boolean)}.
+     * transforms, to be modified in-place by callers of {@link #normalization(boolean)}.
      * After {@link #createConcatenatedTransform(MathTransformFactory, MathTransform)} has been invoked,
      * they are typically (but not necessarily) replaced by the {@link LinearTransform} instance itself.
      *
-     * @see #normalize(boolean)
+     * @see #normalization(boolean)
      */
     private Matrix normalize, denormalize;
 
@@ -88,7 +88,7 @@ public abstract class NonLinearParameter
      * Creates a new {@code NonLinearParameters} for the given coordinate operation method.
      * The {@linkplain org.apache.sis.referencing.operation.DefaultOperationMethod#getParameters() method parameters}
      * shall describe the parameters of this tuple as a whole, including the affine transforms applied before and after
-     * the non-linear kernel. Subclasses shall initialize those {@linkplain #normalize(boolean) normalize/denormalize}
+     * the non-linear kernel. Subclasses shall initialize those {@linkplain #normalization(boolean) normalize/denormalize}
      * affine transforms when they have enough information for doing so.
      *
      * @param method The operation method for which to describe the non-linear parameters.
@@ -103,7 +103,7 @@ public abstract class NonLinearParameter
     /**
      * Creates a matrix for a linear part of the tupple.
      * It is important that the matrices created here are instances of {@link MatrixSIS}, in order
-     * to allow {@link #normalize(boolean)} to return the reference to the (de)normalize matrices.
+     * to allow {@link #normalization(boolean)} to return the reference to the (de)normalize matrices.
      */
     private static MatrixSIS linear(final String name, final Integer size) {
         if (size == null) {
@@ -121,7 +121,7 @@ public abstract class NonLinearParameter
      *         or {@code false} for the <cite>denormalize</cite> transform to apply after the kernel.
      * @return The requested normalize ({@code true}) or denormalize ({@code false}) affine transform.
      */
-    public final MatrixSIS normalize(final boolean norm) {
+    public final MatrixSIS normalization(final boolean norm) {
         return MatrixSIS.castOrCopy(norm ? normalize : denormalize);
     }
 
@@ -148,7 +148,7 @@ public abstract class NonLinearParameter
 
     /**
      * Returns the descriptor that represents this tuple as a whole. The parameter values may take effect
-     * in either the {@linkplain #normalize(boolean) normalize/denormalize} transforms or in the kernel.
+     * in either the {@linkplain #normalization(boolean) normalize/denormalize} transforms or in the kernel.
      *
      * <div class="note"><b>Note:</b>
      * The definition of "kernel" is left to implementors. In the particular case of Apache SIS implementation of map