http://git-wip-us.apache.org/repos/asf/commons-math/blob/a7b4803f/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/SubOrientedPoint.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/SubOrientedPoint.java b/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/SubOrientedPoint.java deleted file mode 100644 index 697cfaf..0000000 --- a/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/SubOrientedPoint.java +++ /dev/null @@ -1,76 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ -package org.apache.commons.math3.geometry.euclidean.oned; - -import org.apache.commons.math3.geometry.partitioning.AbstractSubHyperplane; -import org.apache.commons.math3.geometry.partitioning.Hyperplane; -import org.apache.commons.math3.geometry.partitioning.Region; -import org.apache.commons.math3.geometry.partitioning.Side; - -/** This class represents sub-hyperplane for {@link OrientedPoint}. - * <p>An hyperplane in 1D is a simple point, its orientation being a - * boolean.</p> - * <p>Instances of this class are guaranteed to be immutable.</p> - * @since 3.0 - */ -public class SubOrientedPoint extends AbstractSubHyperplane<Euclidean1D, Euclidean1D> { - - /** Simple constructor. - * @param hyperplane underlying hyperplane - * @param remainingRegion remaining region of the hyperplane - */ - public SubOrientedPoint(final Hyperplane<Euclidean1D> hyperplane, - final Region<Euclidean1D> remainingRegion) { - super(hyperplane, remainingRegion); - } - - /** {@inheritDoc} */ - @Override - public double getSize() { - return 0; - } - - /** {@inheritDoc} */ - @Override - public boolean isEmpty() { - return false; - } - - /** {@inheritDoc} */ - @Override - protected AbstractSubHyperplane<Euclidean1D, Euclidean1D> buildNew(final Hyperplane<Euclidean1D> hyperplane, - final Region<Euclidean1D> remainingRegion) { - return new SubOrientedPoint(hyperplane, remainingRegion); - } - - /** {@inheritDoc} */ - @Override - public Side side(final Hyperplane<Euclidean1D> hyperplane) { - final double global = hyperplane.getOffset(((OrientedPoint) getHyperplane()).getLocation()); - return (global < -1.0e-10) ? Side.MINUS : ((global > 1.0e-10) ? Side.PLUS : Side.HYPER); - } - - /** {@inheritDoc} */ - @Override - public SplitSubHyperplane<Euclidean1D> split(final Hyperplane<Euclidean1D> hyperplane) { - final double global = hyperplane.getOffset(((OrientedPoint) getHyperplane()).getLocation()); - return (global < -1.0e-10) ? - new SplitSubHyperplane<Euclidean1D>(null, this) : - new SplitSubHyperplane<Euclidean1D>(this, null); - } - -}
http://git-wip-us.apache.org/repos/asf/commons-math/blob/a7b4803f/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/Vector1D.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/Vector1D.java b/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/Vector1D.java deleted file mode 100644 index 1ec7a4e..0000000 --- a/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/Vector1D.java +++ /dev/null @@ -1,356 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ -package org.apache.commons.math3.geometry.euclidean.oned; - -import java.text.NumberFormat; - -import org.apache.commons.math3.exception.MathArithmeticException; -import org.apache.commons.math3.exception.util.LocalizedFormats; -import org.apache.commons.math3.geometry.Point; -import org.apache.commons.math3.geometry.Space; -import org.apache.commons.math3.geometry.Vector; -import org.apache.commons.math3.util.FastMath; -import org.apache.commons.math3.util.MathUtils; - -/** This class represents a 1D vector. - * <p>Instances of this class are guaranteed to be immutable.</p> - * @since 3.0 - */ -public class Vector1D implements Vector<Euclidean1D> { - - /** Origin (coordinates: 0). */ - public static final Vector1D ZERO = new Vector1D(0.0); - - /** Unit (coordinates: 1). */ - public static final Vector1D ONE = new Vector1D(1.0); - - // CHECKSTYLE: stop ConstantName - /** A vector with all coordinates set to NaN. */ - public static final Vector1D NaN = new Vector1D(Double.NaN); - // CHECKSTYLE: resume ConstantName - - /** A vector with all coordinates set to positive infinity. */ - public static final Vector1D POSITIVE_INFINITY = - new Vector1D(Double.POSITIVE_INFINITY); - - /** A vector with all coordinates set to negative infinity. */ - public static final Vector1D NEGATIVE_INFINITY = - new Vector1D(Double.NEGATIVE_INFINITY); - - /** Serializable UID. */ - private static final long serialVersionUID = 7556674948671647925L; - - /** Abscissa. */ - private final double x; - - /** Simple constructor. - * Build a vector from its coordinates - * @param x abscissa - * @see #getX() - */ - public Vector1D(double x) { - this.x = x; - } - - /** Multiplicative constructor - * Build a vector from another one and a scale factor. - * The vector built will be a * u - * @param a scale factor - * @param u base (unscaled) vector - */ - public Vector1D(double a, Vector1D u) { - this.x = a * u.x; - } - - /** Linear constructor - * Build a vector from two other ones and corresponding scale factors. - * The vector built will be a1 * u1 + a2 * u2 - * @param a1 first scale factor - * @param u1 first base (unscaled) vector - * @param a2 second scale factor - * @param u2 second base (unscaled) vector - */ - public Vector1D(double a1, Vector1D u1, double a2, Vector1D u2) { - this.x = a1 * u1.x + a2 * u2.x; - } - - /** Linear constructor - * Build a vector from three other ones and corresponding scale factors. - * The vector built will be a1 * u1 + a2 * u2 + a3 * u3 - * @param a1 first scale factor - * @param u1 first base (unscaled) vector - * @param a2 second scale factor - * @param u2 second base (unscaled) vector - * @param a3 third scale factor - * @param u3 third base (unscaled) vector - */ - public Vector1D(double a1, Vector1D u1, double a2, Vector1D u2, - double a3, Vector1D u3) { - this.x = a1 * u1.x + a2 * u2.x + a3 * u3.x; - } - - /** Linear constructor - * Build a vector from four other ones and corresponding scale factors. - * The vector built will be a1 * u1 + a2 * u2 + a3 * u3 + a4 * u4 - * @param a1 first scale factor - * @param u1 first base (unscaled) vector - * @param a2 second scale factor - * @param u2 second base (unscaled) vector - * @param a3 third scale factor - * @param u3 third base (unscaled) vector - * @param a4 fourth scale factor - * @param u4 fourth base (unscaled) vector - */ - public Vector1D(double a1, Vector1D u1, double a2, Vector1D u2, - double a3, Vector1D u3, double a4, Vector1D u4) { - this.x = a1 * u1.x + a2 * u2.x + a3 * u3.x + a4 * u4.x; - } - - /** Get the abscissa of the vector. - * @return abscissa of the vector - * @see #Vector1D(double) - */ - public double getX() { - return x; - } - - /** {@inheritDoc} */ - public Space getSpace() { - return Euclidean1D.getInstance(); - } - - /** {@inheritDoc} */ - public Vector1D getZero() { - return ZERO; - } - - /** {@inheritDoc} */ - public double getNorm1() { - return FastMath.abs(x); - } - - /** {@inheritDoc} */ - public double getNorm() { - return FastMath.abs(x); - } - - /** {@inheritDoc} */ - public double getNormSq() { - return x * x; - } - - /** {@inheritDoc} */ - public double getNormInf() { - return FastMath.abs(x); - } - - /** {@inheritDoc} */ - public Vector1D add(Vector<Euclidean1D> v) { - Vector1D v1 = (Vector1D) v; - return new Vector1D(x + v1.getX()); - } - - /** {@inheritDoc} */ - public Vector1D add(double factor, Vector<Euclidean1D> v) { - Vector1D v1 = (Vector1D) v; - return new Vector1D(x + factor * v1.getX()); - } - - /** {@inheritDoc} */ - public Vector1D subtract(Vector<Euclidean1D> p) { - Vector1D p3 = (Vector1D) p; - return new Vector1D(x - p3.x); - } - - /** {@inheritDoc} */ - public Vector1D subtract(double factor, Vector<Euclidean1D> v) { - Vector1D v1 = (Vector1D) v; - return new Vector1D(x - factor * v1.getX()); - } - - /** {@inheritDoc} */ - public Vector1D normalize() throws MathArithmeticException { - double s = getNorm(); - if (s == 0) { - throw new MathArithmeticException(LocalizedFormats.CANNOT_NORMALIZE_A_ZERO_NORM_VECTOR); - } - return scalarMultiply(1 / s); - } - /** {@inheritDoc} */ - public Vector1D negate() { - return new Vector1D(-x); - } - - /** {@inheritDoc} */ - public Vector1D scalarMultiply(double a) { - return new Vector1D(a * x); - } - - /** {@inheritDoc} */ - public boolean isNaN() { - return Double.isNaN(x); - } - - /** {@inheritDoc} */ - public boolean isInfinite() { - return !isNaN() && Double.isInfinite(x); - } - - /** {@inheritDoc} */ - public double distance1(Vector<Euclidean1D> p) { - Vector1D p3 = (Vector1D) p; - final double dx = FastMath.abs(p3.x - x); - return dx; - } - - /** {@inheritDoc} - * @deprecated as of 3.3, replaced with {@link #distance(Point)} - */ - @Deprecated - public double distance(Vector<Euclidean1D> p) { - return distance((Point<Euclidean1D>) p); - } - - /** {@inheritDoc} */ - public double distance(Point<Euclidean1D> p) { - Vector1D p3 = (Vector1D) p; - final double dx = p3.x - x; - return FastMath.abs(dx); - } - - /** {@inheritDoc} */ - public double distanceInf(Vector<Euclidean1D> p) { - Vector1D p3 = (Vector1D) p; - final double dx = FastMath.abs(p3.x - x); - return dx; - } - - /** {@inheritDoc} */ - public double distanceSq(Vector<Euclidean1D> p) { - Vector1D p3 = (Vector1D) p; - final double dx = p3.x - x; - return dx * dx; - } - - /** {@inheritDoc} */ - public double dotProduct(final Vector<Euclidean1D> v) { - final Vector1D v1 = (Vector1D) v; - return x * v1.x; - } - - /** Compute the distance between two vectors according to the L<sub>2</sub> norm. - * <p>Calling this method is equivalent to calling: - * <code>p1.subtract(p2).getNorm()</code> except that no intermediate - * vector is built</p> - * @param p1 first vector - * @param p2 second vector - * @return the distance between p1 and p2 according to the L<sub>2</sub> norm - */ - public static double distance(Vector1D p1, Vector1D p2) { - return p1.distance(p2); - } - - /** Compute the distance between two vectors according to the L<sub>∞</sub> norm. - * <p>Calling this method is equivalent to calling: - * <code>p1.subtract(p2).getNormInf()</code> except that no intermediate - * vector is built</p> - * @param p1 first vector - * @param p2 second vector - * @return the distance between p1 and p2 according to the L<sub>∞</sub> norm - */ - public static double distanceInf(Vector1D p1, Vector1D p2) { - return p1.distanceInf(p2); - } - - /** Compute the square of the distance between two vectors. - * <p>Calling this method is equivalent to calling: - * <code>p1.subtract(p2).getNormSq()</code> except that no intermediate - * vector is built</p> - * @param p1 first vector - * @param p2 second vector - * @return the square of the distance between p1 and p2 - */ - public static double distanceSq(Vector1D p1, Vector1D p2) { - return p1.distanceSq(p2); - } - - /** - * Test for the equality of two 1D vectors. - * <p> - * If all coordinates of two 1D vectors are exactly the same, and none are - * <code>Double.NaN</code>, the two 1D vectors are considered to be equal. - * </p> - * <p> - * <code>NaN</code> coordinates are considered to affect globally the vector - * and be equals to each other - i.e, if either (or all) coordinates of the - * 1D vector are equal to <code>Double.NaN</code>, the 1D vector is equal to - * {@link #NaN}. - * </p> - * - * @param other Object to test for equality to this - * @return true if two 1D vector objects are equal, false if - * object is null, not an instance of Vector1D, or - * not equal to this Vector1D instance - * - */ - @Override - public boolean equals(Object other) { - - if (this == other) { - return true; - } - - if (other instanceof Vector1D) { - final Vector1D rhs = (Vector1D)other; - if (rhs.isNaN()) { - return this.isNaN(); - } - - return x == rhs.x; - } - return false; - } - - /** - * Get a hashCode for the 1D vector. - * <p> - * All NaN values have the same hash code.</p> - * - * @return a hash code value for this object - */ - @Override - public int hashCode() { - if (isNaN()) { - return 7785; - } - return 997 * MathUtils.hash(x); - } - - /** Get a string representation of this vector. - * @return a string representation of this vector - */ - @Override - public String toString() { - return Vector1DFormat.getInstance().format(this); - } - - /** {@inheritDoc} */ - public String toString(final NumberFormat format) { - return new Vector1DFormat(format).format(this); - } - -} http://git-wip-us.apache.org/repos/asf/commons-math/blob/a7b4803f/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/Vector1DFormat.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/Vector1DFormat.java b/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/Vector1DFormat.java deleted file mode 100644 index 27f1905..0000000 --- a/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/Vector1DFormat.java +++ /dev/null @@ -1,135 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package org.apache.commons.math3.geometry.euclidean.oned; - -import java.text.FieldPosition; -import java.text.NumberFormat; -import java.text.ParsePosition; -import java.util.Locale; - -import org.apache.commons.math3.exception.MathParseException; -import org.apache.commons.math3.geometry.Vector; -import org.apache.commons.math3.geometry.VectorFormat; -import org.apache.commons.math3.util.CompositeFormat; - -/** - * Formats a 1D vector in components list format "{x}". - * <p>The prefix and suffix "{" and "}" can be replaced by - * any user-defined strings. The number format for components can be configured.</p> - * <p>White space is ignored at parse time, even if it is in the prefix, suffix - * or separator specifications. So even if the default separator does include a space - * character that is used at format time, both input string "{1}" and - * " { 1 } " will be parsed without error and the same vector will be - * returned. In the second case, however, the parse position after parsing will be - * just after the closing curly brace, i.e. just before the trailing space.</p> - * <p><b>Note:</b> using "," as a separator may interfere with the grouping separator - * of the default {@link NumberFormat} for the current locale. Thus it is advised - * to use a {@link NumberFormat} instance with disabled grouping in such a case.</p> - * - * @since 3.0 - */ -public class Vector1DFormat extends VectorFormat<Euclidean1D> { - - /** - * Create an instance with default settings. - * <p>The instance uses the default prefix, suffix and separator: - * "{", "}", and "; " and the default number format for components.</p> - */ - public Vector1DFormat() { - super(DEFAULT_PREFIX, DEFAULT_SUFFIX, DEFAULT_SEPARATOR, - CompositeFormat.getDefaultNumberFormat()); - } - - /** - * Create an instance with a custom number format for components. - * @param format the custom format for components. - */ - public Vector1DFormat(final NumberFormat format) { - super(DEFAULT_PREFIX, DEFAULT_SUFFIX, DEFAULT_SEPARATOR, format); - } - - /** - * Create an instance with custom prefix, suffix and separator. - * @param prefix prefix to use instead of the default "{" - * @param suffix suffix to use instead of the default "}" - */ - public Vector1DFormat(final String prefix, final String suffix) { - super(prefix, suffix, DEFAULT_SEPARATOR, CompositeFormat.getDefaultNumberFormat()); - } - - /** - * Create an instance with custom prefix, suffix, separator and format - * for components. - * @param prefix prefix to use instead of the default "{" - * @param suffix suffix to use instead of the default "}" - * @param format the custom format for components. - */ - public Vector1DFormat(final String prefix, final String suffix, - final NumberFormat format) { - super(prefix, suffix, DEFAULT_SEPARATOR, format); - } - - /** - * Returns the default 1D vector format for the current locale. - * @return the default 1D vector format. - */ - public static Vector1DFormat getInstance() { - return getInstance(Locale.getDefault()); - } - - /** - * Returns the default 1D vector format for the given locale. - * @param locale the specific locale used by the format. - * @return the 1D vector format specific to the given locale. - */ - public static Vector1DFormat getInstance(final Locale locale) { - return new Vector1DFormat(CompositeFormat.getDefaultNumberFormat(locale)); - } - - /** {@inheritDoc} */ - @Override - public StringBuffer format(final Vector<Euclidean1D> vector, final StringBuffer toAppendTo, - final FieldPosition pos) { - final Vector1D p1 = (Vector1D) vector; - return format(toAppendTo, pos, p1.getX()); - } - - /** {@inheritDoc} */ - @Override - public Vector1D parse(final String source) throws MathParseException { - ParsePosition parsePosition = new ParsePosition(0); - Vector1D result = parse(source, parsePosition); - if (parsePosition.getIndex() == 0) { - throw new MathParseException(source, - parsePosition.getErrorIndex(), - Vector1D.class); - } - return result; - } - - /** {@inheritDoc} */ - @Override - public Vector1D parse(final String source, final ParsePosition pos) { - final double[] coordinates = parseCoordinates(1, source, pos); - if (coordinates == null) { - return null; - } - return new Vector1D(coordinates[0]); - } - -} http://git-wip-us.apache.org/repos/asf/commons-math/blob/a7b4803f/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/package-info.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/package-info.java b/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/package-info.java deleted file mode 100644 index 0fa3788..0000000 --- a/src/main/java/org/apache/commons/math3/geometry/euclidean/oned/package-info.java +++ /dev/null @@ -1,24 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ -/** - * - * <p> - * This package provides basic 1D geometry components. - * </p> - * - */ -package org.apache.commons.math3.geometry.euclidean.oned; http://git-wip-us.apache.org/repos/asf/commons-math/blob/a7b4803f/src/main/java/org/apache/commons/math3/geometry/euclidean/threed/CardanEulerSingularityException.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math3/geometry/euclidean/threed/CardanEulerSingularityException.java b/src/main/java/org/apache/commons/math3/geometry/euclidean/threed/CardanEulerSingularityException.java deleted file mode 100644 index 728074d..0000000 --- a/src/main/java/org/apache/commons/math3/geometry/euclidean/threed/CardanEulerSingularityException.java +++ /dev/null @@ -1,44 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package org.apache.commons.math3.geometry.euclidean.threed; - -import org.apache.commons.math3.exception.MathIllegalStateException; -import org.apache.commons.math3.exception.util.LocalizedFormats; - -/** This class represents exceptions thrown while extractiong Cardan - * or Euler angles from a rotation. - - * @since 1.2 - */ -public class CardanEulerSingularityException - extends MathIllegalStateException { - - /** Serializable version identifier */ - private static final long serialVersionUID = -1360952845582206770L; - - /** - * Simple constructor. - * build an exception with a default message. - * @param isCardan if true, the rotation is related to Cardan angles, - * if false it is related to EulerAngles - */ - public CardanEulerSingularityException(boolean isCardan) { - super(isCardan ? LocalizedFormats.CARDAN_ANGLES_SINGULARITY : LocalizedFormats.EULER_ANGLES_SINGULARITY); - } - -} http://git-wip-us.apache.org/repos/asf/commons-math/blob/a7b4803f/src/main/java/org/apache/commons/math3/geometry/euclidean/threed/Euclidean3D.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/math3/geometry/euclidean/threed/Euclidean3D.java b/src/main/java/org/apache/commons/math3/geometry/euclidean/threed/Euclidean3D.java deleted file mode 100644 index dc06936..0000000 --- a/src/main/java/org/apache/commons/math3/geometry/euclidean/threed/Euclidean3D.java +++ /dev/null @@ -1,74 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package org.apache.commons.math3.geometry.euclidean.threed; - -import java.io.Serializable; - -import org.apache.commons.math3.geometry.Space; -import org.apache.commons.math3.geometry.euclidean.twod.Euclidean2D; - -/** - * This class implements a three-dimensional space. - * @since 3.0 - */ -public class Euclidean3D implements Serializable, Space { - - /** Serializable version identifier. */ - private static final long serialVersionUID = 6249091865814886817L; - - /** Private constructor for the singleton. - */ - private Euclidean3D() { - } - - /** Get the unique instance. - * @return the unique instance - */ - public static Euclidean3D getInstance() { - return LazyHolder.INSTANCE; - } - - /** {@inheritDoc} */ - public int getDimension() { - return 3; - } - - /** {@inheritDoc} */ - public Euclidean2D getSubSpace() { - return Euclidean2D.getInstance(); - } - - // CHECKSTYLE: stop HideUtilityClassConstructor - /** Holder for the instance. - * <p>We use here the Initialization On Demand Holder Idiom.</p> - */ - private static class LazyHolder { - /** Cached field instance. */ - private static final Euclidean3D INSTANCE = new Euclidean3D(); - } - // CHECKSTYLE: resume HideUtilityClassConstructor - - /** Handle deserialization of the singleton. - * @return the singleton instance - */ - private Object readResolve() { - // return the singleton instance - return LazyHolder.INSTANCE; - } - -}
