diff options
Diffstat (limited to 'src/main/java/org/apache/commons/math3/optim/PointVectorValuePair.java')
-rw-r--r-- | src/main/java/org/apache/commons/math3/optim/PointVectorValuePair.java | 139 |
1 files changed, 139 insertions, 0 deletions
diff --git a/src/main/java/org/apache/commons/math3/optim/PointVectorValuePair.java b/src/main/java/org/apache/commons/math3/optim/PointVectorValuePair.java new file mode 100644 index 0000000..c0ba93e --- /dev/null +++ b/src/main/java/org/apache/commons/math3/optim/PointVectorValuePair.java @@ -0,0 +1,139 @@ +/* + * 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.optim; + +import org.apache.commons.math3.util.Pair; + +import java.io.Serializable; + +/** + * This class holds a point and the vectorial value of an objective function at that point. + * + * @see PointValuePair + * @see org.apache.commons.math3.analysis.MultivariateVectorFunction + * @since 3.0 + */ +public class PointVectorValuePair extends Pair<double[], double[]> implements Serializable { + /** Serializable UID. */ + private static final long serialVersionUID = 20120513L; + + /** + * Builds a point/objective function value pair. + * + * @param point Point coordinates. This instance will store a copy of the array, not the array + * passed as argument. + * @param value Value of the objective function at the point. + */ + public PointVectorValuePair(final double[] point, final double[] value) { + this(point, value, true); + } + + /** + * Build a point/objective function value pair. + * + * @param point Point coordinates. + * @param value Value of the objective function at the point. + * @param copyArray if {@code true}, the input arrays will be copied, otherwise they will be + * referenced. + */ + public PointVectorValuePair( + final double[] point, final double[] value, final boolean copyArray) { + super( + copyArray ? ((point == null) ? null : point.clone()) : point, + copyArray ? ((value == null) ? null : value.clone()) : value); + } + + /** + * Gets the point. + * + * @return a copy of the stored point. + */ + public double[] getPoint() { + final double[] p = getKey(); + return p == null ? null : p.clone(); + } + + /** + * Gets a reference to the point. + * + * @return a reference to the internal array storing the point. + */ + public double[] getPointRef() { + return getKey(); + } + + /** + * Gets the value of the objective function. + * + * @return a copy of the stored value of the objective function. + */ + @Override + public double[] getValue() { + final double[] v = super.getValue(); + return v == null ? null : v.clone(); + } + + /** + * Gets a reference to the value of the objective function. + * + * @return a reference to the internal array storing the value of the objective function. + */ + public double[] getValueRef() { + return super.getValue(); + } + + /** + * Replace the instance with a data transfer object for serialization. + * + * @return data transfer object that will be serialized + */ + private Object writeReplace() { + return new DataTransferObject(getKey(), getValue()); + } + + /** Internal class used only for serialization. */ + private static class DataTransferObject implements Serializable { + /** Serializable UID. */ + private static final long serialVersionUID = 20120513L; + + /** Point coordinates. @Serial */ + private final double[] point; + + /** Value of the objective function at the point. @Serial */ + private final double[] value; + + /** + * Simple constructor. + * + * @param point Point coordinates. + * @param value Value of the objective function at the point. + */ + DataTransferObject(final double[] point, final double[] value) { + this.point = point.clone(); + this.value = value.clone(); + } + + /** + * Replace the deserialized data transfer object with a {@link PointValuePair}. + * + * @return replacement {@link PointValuePair} + */ + private Object readResolve() { + return new PointVectorValuePair(point, value, false); + } + } +} |