Repository: commons-math Updated Branches: refs/heads/master 4ebd5b617 -> ab7fd6c92
Javadoc fixes. Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/ab7fd6c9 Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/ab7fd6c9 Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/ab7fd6c9 Branch: refs/heads/master Commit: ab7fd6c92a05dbd20e874f7ee23c452218f09280 Parents: 4ebd5b6 Author: Phil Steitz <phil.ste...@gmail.com> Authored: Fri Dec 25 15:56:08 2015 -0700 Committer: Phil Steitz <phil.ste...@gmail.com> Committed: Fri Dec 25 15:56:08 2015 -0700 ---------------------------------------------------------------------- .../org/apache/commons/math4/FieldElement.java | 2 +- .../apache/commons/math4/RealFieldElement.java | 6 +++--- .../commons/math4/analysis/FunctionUtils.java | 20 ++++++++++---------- .../analysis/RealFieldUnivariateFunction.java | 12 ++++++------ .../math4/analysis/UnivariateFunction.java | 8 ++++---- .../analysis/differentiation/DSCompiler.java | 14 ++++++-------- .../differentiation/DerivativeStructure.java | 6 +++--- .../FiniteDifferencesDifferentiator.java | 7 ++++--- .../differentiation/SparseGradient.java | 2 +- .../math4/analysis/function/StepFunction.java | 6 +++--- 10 files changed, 41 insertions(+), 42 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/FieldElement.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/FieldElement.java b/src/main/java/org/apache/commons/math4/FieldElement.java index b7aa247..a135525 100644 --- a/src/main/java/org/apache/commons/math4/FieldElement.java +++ b/src/main/java/org/apache/commons/math4/FieldElement.java @@ -66,7 +66,7 @@ public interface FieldElement<T> { T multiply(T a) throws NullArgumentException; /** Compute this ÷ a. - * @param a element to add + * @param a element to divide by * @return a new element representing this ÷ a * @throws NullArgumentException if {@code a} is {@code null}. * @throws MathArithmeticException if {@code a} is zero http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/RealFieldElement.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/RealFieldElement.java b/src/main/java/org/apache/commons/math4/RealFieldElement.java index e88499d..1df3bbe 100644 --- a/src/main/java/org/apache/commons/math4/RealFieldElement.java +++ b/src/main/java/org/apache/commons/math4/RealFieldElement.java @@ -52,7 +52,7 @@ public interface RealFieldElement<T> extends FieldElement<T> { /** '÷' operator. * @param a right hand side parameter of the operator - * @return this÷s;a + * @return this÷a */ T divide(double a); @@ -88,7 +88,7 @@ public interface RealFieldElement<T> extends FieldElement<T> { T floor(); /** Get the whole number that is the nearest to the instance, or the even one if x is exactly half way between two integers. - * @return a double number r such that r is an integer r - 0.5 <= this <= r + 0.5 + * @return a double number r such that r is an integer r - 0.5 ≤ this ≤ r + 0.5 */ T rint(); @@ -130,7 +130,7 @@ public interface RealFieldElement<T> extends FieldElement<T> { /** * Returns the hypotenuse of a triangle with sides {@code this} and {@code y} - * - sqrt(<i>this</i><sup>2</sup> +<i>y</i><sup>2</sup>)<br/> + * - sqrt(<i>this</i><sup>2</sup> +<i>y</i><sup>2</sup>) * avoiding intermediate overflow or underflow. * * <ul> http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/analysis/FunctionUtils.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/analysis/FunctionUtils.java b/src/main/java/org/apache/commons/math4/analysis/FunctionUtils.java index 83f7467..fff715a 100644 --- a/src/main/java/org/apache/commons/math4/analysis/FunctionUtils.java +++ b/src/main/java/org/apache/commons/math4/analysis/FunctionUtils.java @@ -40,9 +40,9 @@ public class FunctionUtils { /** * Composes functions. - * <br/> + * <p> * The functions in the argument list are composed sequentially, in the - * given order. For example, compose(f1,f2,f3) acts like f1(f2(f3(x))). + * given order. For example, compose(f1,f2,f3) acts like f1(f2(f3(x))).</p> * * @param f List of functions. * @return the composite function. @@ -63,9 +63,9 @@ public class FunctionUtils { /** * Composes functions. - * <br/> + * <p> * The functions in the argument list are composed sequentially, in the - * given order. For example, compose(f1,f2,f3) acts like f1(f2(f3(x))). + * given order. For example, compose(f1,f2,f3) acts like f1(f2(f3(x))).</p> * * @param f List of functions. * @return the composite function. @@ -207,8 +207,8 @@ public class FunctionUtils { } /** - * Returns the univariate function <br/> - * {@code h(x) = combiner(f(x), g(x))}. + * Returns the univariate function + * {@code h(x) = combiner(f(x), g(x)).} * * @param combiner Combiner function. * @param f Function. @@ -271,7 +271,7 @@ public class FunctionUtils { * Creates a unary function by fixing the first argument of a binary function. * * @param f Binary function. - * @param fixed Value to which the first argument of {@code f} is set. + * @param fixed value to which the first argument of {@code f} is set. * @return the unary function h(x) = f(fixed, x) */ public static UnivariateFunction fix1stArgument(final BivariateFunction f, @@ -288,7 +288,7 @@ public class FunctionUtils { * Creates a unary function by fixing the second argument of a binary function. * * @param f Binary function. - * @param fixed Value to which the second argument of {@code f} is set. + * @param fixed value to which the second argument of {@code f} is set. * @return the unary function h(x) = f(x, fixed) */ public static UnivariateFunction fix2ndArgument(final BivariateFunction f, @@ -304,10 +304,10 @@ public class FunctionUtils { /** * Samples the specified univariate real function on the specified interval. - * <br/> + * <p> * The interval is divided equally into {@code n} sections and sample points * are taken from {@code min} to {@code max - (max - min) / n}; therefore - * {@code f} is not sampled at the upper bound {@code max}. + * {@code f} is not sampled at the upper bound {@code max}.</p> * * @param f Function to be sampled * @param min Lower bound of the interval (included). http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/analysis/RealFieldUnivariateFunction.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/analysis/RealFieldUnivariateFunction.java b/src/main/java/org/apache/commons/math4/analysis/RealFieldUnivariateFunction.java index 2894650..e34174c 100644 --- a/src/main/java/org/apache/commons/math4/analysis/RealFieldUnivariateFunction.java +++ b/src/main/java/org/apache/commons/math4/analysis/RealFieldUnivariateFunction.java @@ -20,11 +20,11 @@ import org.apache.commons.math4.RealFieldElement; /** * An interface representing a univariate real function. - * <br/> + * <p> * When a <em>user-defined</em> function encounters an error during - * evaluation, the {@link #value(FieldElement) value} method should throw a - * <em>user-defined</em> unchecked exception. - * <br/> + * evaluation, the {@link #value(RealFieldElement) value} method should throw a + * <em>user-defined</em> unchecked exception.</p> + * <p> * The following code excerpt shows the recommended way to do that using * a root solver as an example, but the same construct is applicable to * ODE integrators or optimizers. @@ -61,9 +61,9 @@ import org.apache.commons.math4.RealFieldElement; * } * } * </pre> - * + *<p> * As shown, the exception is local to the user's code and it is guaranteed - * that Apache Commons Math will not catch it. + * that Apache Commons Math will not catch it.</p> * * @param <T> the type of the field elements * @since 3.6 http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/analysis/UnivariateFunction.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/analysis/UnivariateFunction.java b/src/main/java/org/apache/commons/math4/analysis/UnivariateFunction.java index 3073d09..cf96a29 100644 --- a/src/main/java/org/apache/commons/math4/analysis/UnivariateFunction.java +++ b/src/main/java/org/apache/commons/math4/analysis/UnivariateFunction.java @@ -18,14 +18,14 @@ package org.apache.commons.math4.analysis; /** * An interface representing a univariate real function. - * <br/> + * <p> * When a <em>user-defined</em> function encounters an error during * evaluation, the {@link #value(double) value} method should throw a - * <em>user-defined</em> unchecked exception. - * <br/> + * <em>user-defined</em> unchecked exception.</p> + * <p> * The following code excerpt shows the recommended way to do that using * a root solver as an example, but the same construct is applicable to - * ODE integrators or optimizers. + * ODE integrators or optimizers.</p> * * <pre> * private static class LocalException extends RuntimeException { http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/analysis/differentiation/DSCompiler.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/analysis/differentiation/DSCompiler.java b/src/main/java/org/apache/commons/math4/analysis/differentiation/DSCompiler.java index 6cbcc01..7515a18 100644 --- a/src/main/java/org/apache/commons/math4/analysis/differentiation/DSCompiler.java +++ b/src/main/java/org/apache/commons/math4/analysis/differentiation/DSCompiler.java @@ -71,8 +71,7 @@ import org.apache.commons.math4.util.MathArrays; * <p>This class is mainly used as the engine for scalar variable {@link DerivativeStructure}. * It can also be used directly to hold several variables in arrays for more complex data * structures. User can for example store a vector of n variables depending on three x, y - * and z free parameters in one array as follows: - * <pre> + * and z free parameters in one array as follows:</p> <pre> * // parameter 0 is x, parameter 1 is y, parameter 2 is z * int parameters = 3; * DSCompiler compiler = DSCompiler.getCompiler(parameters, order); @@ -80,7 +79,7 @@ import org.apache.commons.math4.util.MathArrays; * * // pack all elements in a single array * double[] array = new double[n * size]; - * for (int i = 0; i < n; ++i) { + * for (int i = 0; i < n; ++i) { * * // we know value is guaranteed to be the first element * array[i * size] = v[i]; @@ -94,13 +93,12 @@ import org.apache.commons.math4.util.MathArrays; * * } * </pre> - * Then in another function, user can perform some operations on all elements stored - * in the single array, such as a simple product of all variables: - * <pre> + * <p>Then in another function, user can perform some operations on all elements stored + * in the single array, such as a simple product of all variables:</p> <pre> * // compute the product of all elements * double[] product = new double[size]; * prod[0] = 1.0; - * for (int i = 0; i < n; ++i) { + * for (int i = 0; i < n; ++i) { * double[] tmp = product.clone(); * compiler.multiply(tmp, 0, array, i * size, product, 0); * } @@ -120,7 +118,7 @@ import org.apache.commons.math4.util.MathArrays; * double dPdYdY = product[compiler.getPartialDerivativeIndex(0, 2, 0)]; * double dPdYdZ = product[compiler.getPartialDerivativeIndex(0, 1, 1)]; * double dPdZdZ = product[compiler.getPartialDerivativeIndex(0, 0, 2)]; - * </p> + * </pre> * @see DerivativeStructure * @since 3.1 */ http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/analysis/differentiation/DerivativeStructure.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/analysis/differentiation/DerivativeStructure.java b/src/main/java/org/apache/commons/math4/analysis/differentiation/DerivativeStructure.java index de9fe60..887d890 100644 --- a/src/main/java/org/apache/commons/math4/analysis/differentiation/DerivativeStructure.java +++ b/src/main/java/org/apache/commons/math4/analysis/differentiation/DerivativeStructure.java @@ -34,7 +34,7 @@ import org.apache.commons.math4.util.MathUtils; * numbers described in Dan Kalman's paper <a * href="http://www1.american.edu/cas/mathstat/People/kalman/pdffiles/mmgautodiff.pdf";>Doubly * Recursive Multivariate Automatic Differentiation</a>, Mathematics Magazine, vol. 75, - * no. 3, June 2002.</p>. Rall's numbers are an extension to the real numbers used + * no. 3, June 2002. Rall's numbers are an extension to the real numbers used * throughout mathematical expressions; they hold the derivative together with the * value of a function. Dan Kalman's derivative structures hold all partial derivatives * up to any specified order, with respect to any number of free parameters. Rall's @@ -109,7 +109,7 @@ public class DerivativeStructure implements RealFieldElement<DerivativeStructure * @param order derivation order * @param index index of the variable (from 0 to {@code parameters - 1}) * @param value value of the variable - * @exception NumberIsTooLargeException if {@code index >= parameters}. + * @exception NumberIsTooLargeException if {@code index ≥ parameters}. * @see #DerivativeStructure(int, int, double) */ public DerivativeStructure(final int parameters, final int order, @@ -577,7 +577,7 @@ public class DerivativeStructure implements RealFieldElement<DerivativeStructure /** * Returns the hypotenuse of a triangle with sides {@code x} and {@code y} - * - sqrt(<i>x</i><sup>2</sup> +<i>y</i><sup>2</sup>)<br/> + * - sqrt(<i>x</i><sup>2</sup> +<i>y</i><sup>2</sup>) * avoiding intermediate overflow or underflow. * * <ul> http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/analysis/differentiation/FiniteDifferencesDifferentiator.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/analysis/differentiation/FiniteDifferencesDifferentiator.java b/src/main/java/org/apache/commons/math4/analysis/differentiation/FiniteDifferencesDifferentiator.java index f1ca1da..3dfc805 100644 --- a/src/main/java/org/apache/commons/math4/analysis/differentiation/FiniteDifferencesDifferentiator.java +++ b/src/main/java/org/apache/commons/math4/analysis/differentiation/FiniteDifferencesDifferentiator.java @@ -34,7 +34,7 @@ import org.apache.commons.math4.util.FastMath; * UnivariateVectorFunction univariate vector functions} or {@link * UnivariateMatrixFunction univariate matrix functions}). These * wrapper objects compute derivatives in addition to function - * value. + * values. * </p> * <p> * The wrapper objects work by calling the underlying function on @@ -62,9 +62,10 @@ import org.apache.commons.math4.util.FastMath; * <li>step size = 1.0e-6, second order derivative error about 148</li> * <li>step size = 1.0e-6, fourth order derivative error about 6.35e+14</li> * </ul> + * <p> * This example shows that the small step size is really bad, even simply - * for second order derivative! - * </p> + * for second order derivative!</p> + * * @since 3.1 */ public class FiniteDifferencesDifferentiator http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/analysis/differentiation/SparseGradient.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/analysis/differentiation/SparseGradient.java b/src/main/java/org/apache/commons/math4/analysis/differentiation/SparseGradient.java index c590fbf..130c335 100644 --- a/src/main/java/org/apache/commons/math4/analysis/differentiation/SparseGradient.java +++ b/src/main/java/org/apache/commons/math4/analysis/differentiation/SparseGradient.java @@ -459,7 +459,7 @@ public class SparseGradient implements RealFieldElement<SparseGradient>, Seriali /** * Returns the hypotenuse of a triangle with sides {@code x} and {@code y} - * - sqrt(<i>x</i><sup>2</sup> +<i>y</i><sup>2</sup>)<br/> + * - sqrt(<i>x</i><sup>2</sup> +<i>y</i><sup>2</sup>) * avoiding intermediate overflow or underflow. * * <ul> http://git-wip-us.apache.org/repos/asf/commons-math/blob/ab7fd6c9/src/main/java/org/apache/commons/math4/analysis/function/StepFunction.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math4/analysis/function/StepFunction.java b/src/main/java/org/apache/commons/math4/analysis/function/StepFunction.java index a8289c2..08461cb 100644 --- a/src/main/java/org/apache/commons/math4/analysis/function/StepFunction.java +++ b/src/main/java/org/apache/commons/math4/analysis/function/StepFunction.java @@ -41,10 +41,10 @@ public class StepFunction implements UnivariateFunction { /** * Builds a step function from a list of arguments and the corresponding * values. Specifically, returns the function h(x) defined by <pre><code> - * h(x) = y[0] for all x < x[1] - * y[1] for x[1] <= x < x[2] + * h(x) = y[0] for all x < x[1] + * y[1] for x[1] ≤ x < x[2] * ... - * y[y.length - 1] for x >= x[x.length - 1] + * y[y.length - 1] for x ≥ x[x.length - 1] * </code></pre> * The value of {@code x[0]} is ignored, but it must be strictly less than * {@code x[1]}.
