程序包 org.hipparchus.linear

类 OpenMapRealVector

java.lang.Object

org.hipparchus.linear.RealVector

org.hipparchus.linear.SparseRealVector

org.hipparchus.linear.OpenMapRealVector

所有已实现的接口:

Serializable

       public class OpenMapRealVector extends SparseRealVector implements Serializable
      

This class implements the RealVector interface with a OpenIntToDoubleHashMap backing store.

注意：此实现假定对于任何 x，等式 x * 0d == 0d 成立。但对于 NaN 不成立。此外，零条目将失去其符号。因此，某些操作（涉及 NaN 和/或无穷大）可能会产生不正确的结果，如乘法、除法或函数映射。

另请参阅:

• 序列化表格

嵌套类概要

嵌套类

修饰符和类型	类	说明
protected class	OpenMapRealVector.OpenMapEntry	Implementation of Entry optimized for OpenMap.
protected class	OpenMapRealVector.OpenMapSparseIterator	Iterator class to do iteration over just the non-zero elements.

从类继承的嵌套类/接口 org.hipparchus.linear.RealVector

RealVector.Entry, RealVector.SparseEntryIterator

字段概要

字段

修饰符和类型	字段	说明
static final double	DEFAULT_ZERO_TOLERANCE	Default Tolerance for having a value considered zero.

构造器概要

构造器

限定符	构造器	说明
	OpenMapRealVector()	Build a 0-length vector.
	OpenMapRealVector(double[] values)	Create from an array.
	OpenMapRealVector(double[] values, double epsilon)	Create from an array, specifying zero tolerance.
	OpenMapRealVector(int dimension)	Construct a vector of zeroes.
	OpenMapRealVector(int dimension, double epsilon)	Construct a vector of zeroes, specifying zero tolerance.
	OpenMapRealVector(int dimension, int expectedSize)	Build a vector with known the sparseness (for advanced use only).
	OpenMapRealVector(int dimension, int expectedSize, double epsilon)	Build a vector with known the sparseness and zero tolerance setting (for advanced use only).
	OpenMapRealVector(Double[] values)	Create from an array.
	OpenMapRealVector(Double[] values, double epsilon)	Create from an array.
	OpenMapRealVector(OpenMapRealVector v)	Copy constructor.
protected	OpenMapRealVector(OpenMapRealVector v, int resize)	Build a resized vector, for use with append.
	OpenMapRealVector(RealVector v)	Generic copy constructor.

方法概要

修饰符和类型	方法	说明
OpenMapRealVector	add(OpenMapRealVector v)	Optimized method to add two OpenMapRealVectors.
RealVector	add(RealVector v)	Compute the sum of this vector and v.
OpenMapRealVector	append(double d)	Construct a new vector by appending a double to this vector.
OpenMapRealVector	append(OpenMapRealVector v)	Optimized method to append a OpenMapRealVector.
OpenMapRealVector	append(RealVector v)	Construct a new vector by appending a vector to this vector.
OpenMapRealVector	copy()	Returns a (deep) copy of this vector.
OpenMapRealVector	ebeDivide(RealVector v)	Element-by-element division.
OpenMapRealVector	ebeMultiply(RealVector v)	Element-by-element multiplication.
boolean	equals(Object obj)	Test for the equality of two real vectors.
int	getDimension()	Returns the size of the vector.
double	getDistance(OpenMapRealVector v)	Optimized method to compute distance.
double	getDistance(RealVector v)	Distance between two vectors.
double	getEntry(int index)	Return the entry at the specified index.
double	getL1Distance(OpenMapRealVector v)	Distance between two vectors.
double	getL1Distance(RealVector v)	Distance between two vectors.
double	getLInfDistance(RealVector v)	Distance between two vectors.
double	getSparsity()	Get percentage of none zero elements as a decimal percent.
OpenMapRealVector	getSubVector(int index, int n)	Get a subvector from consecutive elements.
int	hashCode()	.
protected boolean	isDefaultValue(double value)	Determine if this value is within epsilon of zero.
boolean	isInfinite()	Check whether any coordinate of this vector is infinite and none are NaN.
boolean	isNaN()	Check whether any coordinate of this vector is NaN.
OpenMapRealVector	mapAdd(double d)	Add a value to each entry.
OpenMapRealVector	mapAddToSelf(double d)	Add a value to each entry.
void	set(double value)	Set all elements to a single value.
void	setEntry(int index, double value)	Set a single element.
void	setSubVector(int index, RealVector v)	Set a sequence of consecutive elements.
Iterator<RealVector.Entry>	sparseIterator()	Create a sparse iterator over the vector, which may omit some entries.
OpenMapRealVector	subtract(OpenMapRealVector v)	Optimized method to subtract OpenMapRealVectors.
RealVector	subtract(RealVector v)	Subtract v from this vector.
double[]	toArray()	Convert the vector to an array of doubles.
void	unitize()	Converts this vector into a unit vector.
OpenMapRealVector	unitVector()	Creates a unit vector pointing in the direction of this vector.

从类继承的方法 org.hipparchus.linear.RealVector

addToEntry, checkIndex, checkIndices, checkVectorDimensions, checkVectorDimensions, combine, combineToSelf, cosine, dotProduct, getL1Norm, getLInfNorm, getMaxIndex, getMaxValue, getMinIndex, getMinValue, getNorm, iterator, map, mapDivide, mapDivideToSelf, mapMultiply, mapMultiplyToSelf, mapSubtract, mapSubtractToSelf, mapToSelf, outerProduct, projection, unmodifiableRealVector, walkInDefaultOrder, walkInDefaultOrder, walkInDefaultOrder, walkInDefaultOrder, walkInOptimizedOrder, walkInOptimizedOrder, walkInOptimizedOrder, walkInOptimizedOrder

从类继承的方法 java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

字段详细资料

DEFAULT_ZERO_TOLERANCE

             public static final double DEFAULT_ZERO_TOLERANCE
            

Default Tolerance for having a value considered zero.

另请参阅:

• 常量字段值

构造器详细资料

OpenMapRealVector

             public OpenMapRealVector()
            

Build a 0-length vector. Zero-length vectors may be used to initialized construction of vectors by data gathering. We start with zero-length and use either the OpenMapRealVector(OpenMapRealVector, int) constructor or one of the append method (append(double), append(RealVector)) to gather data into this vector.

OpenMapRealVector

             public OpenMapRealVector(int dimension)
            

Construct a vector of zeroes.

参数:

dimension - Size of the vector.

OpenMapRealVector

             public OpenMapRealVector(int dimension, double epsilon)
            

Construct a vector of zeroes, specifying zero tolerance.

参数:

dimension - Size of the vector.

epsilon - Tolerance below which a value considered zero.

OpenMapRealVector

             protected OpenMapRealVector(OpenMapRealVector v, int resize)
            

Build a resized vector, for use with append.

参数:

v - Original vector.

resize - Amount to add.

OpenMapRealVector

             public OpenMapRealVector(int dimension, int expectedSize)
            

Build a vector with known the sparseness (for advanced use only).

参数:

dimension - Size of the vector.

expectedSize - The expected number of non-zero entries.

OpenMapRealVector

             public OpenMapRealVector(int dimension, int expectedSize, double epsilon)
            

Build a vector with known the sparseness and zero tolerance setting (for advanced use only).

参数:

dimension - Size of the vector.

expectedSize - Expected number of non-zero entries.

epsilon - Tolerance below which a value is considered zero.

OpenMapRealVector

             public OpenMapRealVector(double[] values)
            

Create from an array. Only non-zero entries will be stored.

参数:

values - Set of values to create from.

OpenMapRealVector

             public OpenMapRealVector(double[] values, double epsilon)
            

Create from an array, specifying zero tolerance. Only non-zero entries will be stored.

参数:

values - Set of values to create from.

epsilon - Tolerance below which a value is considered zero.

OpenMapRealVector

             public OpenMapRealVector(Double[] values)
            

Create from an array. Only non-zero entries will be stored.

参数:

values - The set of values to create from

OpenMapRealVector

             public OpenMapRealVector(Double[] values, double epsilon)
            

Create from an array. Only non-zero entries will be stored.

参数:

values - Set of values to create from.

epsilon - Tolerance below which a value is considered zero.

OpenMapRealVector

             public OpenMapRealVector(OpenMapRealVector v)
            

Copy constructor.

参数:

v - Instance to copy from.

OpenMapRealVector

             public OpenMapRealVector(RealVector v)
            

Generic copy constructor.

参数:

v - Instance to copy from.

方法详细资料

isDefaultValue

             protected boolean isDefaultValue(double value)
            

Determine if this value is within epsilon of zero.

参数:

value - Value to test

返回:

true if this value is within epsilon to zero, false otherwise.

add

             public RealVector add(RealVector v) throws MathIllegalArgumentException
            

Compute the sum of this vector and v. Returns a new vector. Does not change instance data.

覆盖:

add 在类中 RealVector

参数:

v - Vector to be added.

返回:

this + v.

抛出:

MathIllegalArgumentException - if v is not the same size as this vector.

add

             public OpenMapRealVector add(OpenMapRealVector v) throws MathIllegalArgumentException
            

Optimized method to add two OpenMapRealVectors. It copies the larger vector, then iterates over the smaller.

参数:

v - 要添加的向量。

返回:

this 和 v 的和。

抛出:

MathIllegalArgumentException - 如果维度不匹配。

append

             public OpenMapRealVector append(OpenMapRealVector v)
            

优化的方法，用于追加 OpenMapRealVector。

参数:

v - 要追加的向量。

返回:

将 v 追加到自身的结果。

append

             public OpenMapRealVector append(RealVector v)
            

通过追加一个向量到这个向量来构造一个新向量。

指定者:

append 在类中 RealVector

参数:

v - 要追加到此向量的向量。

返回:

一个新向量。

append

             public OpenMapRealVector append(double d)
            

通过追加一个双精度数到这个向量来构造一个新向量。

指定者:

append 在类中 RealVector

参数:

d - 要追加的双精度数。

返回:

一个新向量。

copy

             public OpenMapRealVector copy()
            

返回这个向量的（深度）复制。

指定者:

copy 在类中 RealVector

返回:

一个向量的复制。

ebeDivide

             public OpenMapRealVector ebeDivide(RealVector v) throws MathIllegalArgumentException
            

逐元素除法。

指定者:

ebeDivide 在类中 RealVector

参数:

v - 必须除以实例元素的向量。

返回:

包含所有元素 this[i] / v[i] 的向量。

抛出:

MathIllegalArgumentException - 如果 v 的大小与 this 向量不同。

ebeMultiply

             public OpenMapRealVector ebeMultiply(RealVector v) throws MathIllegalArgumentException
            

逐元素乘法。

指定者:

ebeMultiply 在类中 RealVector

参数:

v - 必须乘以实例元素的向量。

返回:

包含所有元素 this[i] * v[i] 的向量。

抛出:

MathIllegalArgumentException - 如果 v 的大小与 this 向量不同。

getSubVector

             public OpenMapRealVector getSubVector(int index, int n) throws MathIllegalArgumentException
            

获取连续元素的子向量。

指定者:

getSubVector 在类中 RealVector

参数:

index - 第一个元素的索引。

n - 要检索的元素数量。

返回:

包含 n 个元素的向量。

抛出:

MathIllegalArgumentException - 如果索引无效。

MathIllegalArgumentException - 如果元素数量不是正数。

getDimension

             public int getDimension()
            

返回向量的大小。

指定者:

getDimension 在类中 RealVector

返回:

这个向量的大小。

getDistance

             public double getDistance(OpenMapRealVector v) throws MathIllegalArgumentException
            

优化的方法来计算距离。

参数:

v - 要计算距离的向量。

返回:

this 和 v 之间的距离。

抛出:

MathIllegalArgumentException - 如果维度不匹配。

getDistance

             public double getDistance(RealVector v) throws MathIllegalArgumentException
            

两个向量之间的距离。

此方法计算与 L₂ 范数一致的距离，即元素差的平方和的平方根，或欧几里德距离。

覆盖:

getDistance 在类中 RealVector

参数:

v - 请求距离的向量。

返回:

两个向量之间的距离。

抛出:

MathIllegalArgumentException - 如果 v 与 this 向量的大小不同。

另请参阅:

• RealVector.getL1Distance(RealVector)
• RealVector.getLInfDistance(RealVector)
• RealVector.getNorm()

getEntry

             public double getEntry(int index) throws MathIllegalArgumentException
            

返回指定索引处的条目。

指定者:

getEntry 在类中 RealVector

参数:

index - 要获取的条目的索引位置。

返回:

索引处的向量条目。

抛出:

MathIllegalArgumentException - 如果索引无效。

另请参阅:

• RealVector.setEntry(int, double)

getL1Distance

             public double getL1Distance(OpenMapRealVector v) throws MathIllegalArgumentException
            

两个向量之间的距离。此方法计算与 L₁ 范数一致的距离，即元素差的绝对值之和。

参数:

v - 请求距离的向量。

返回:

这个向量与 v 之间的距离。

抛出:

MathIllegalArgumentException - 如果维度不匹配。

getL1Distance

             public double getL1Distance(RealVector v) throws MathIllegalArgumentException
            

两个向量之间的距离。

此方法计算与 L₁ 范数一致的距离，即元素差的绝对值之和。

覆盖:

getL1Distance 在类中 RealVector

参数:

v - 请求距离的向量。

返回:

两个向量之间的距离。

抛出:

MathIllegalArgumentException - 如果 v 与 this 向量的大小不同。

getLInfDistance

             public double getLInfDistance(RealVector v) throws MathIllegalArgumentException
            

两个向量之间的距离。

此方法计算与 L_∞ 范数一致的距离，即元素差的绝对值的最大值。

覆盖:

getLInfDistance 在类中 RealVector

参数:

v - 请求距离的向量。

返回:

两个向量之间的距离。

抛出:

MathIllegalArgumentException - 如果 v 与 this 向量的大小不同。

另请参阅:

• RealVector.getDistance(RealVector)
• RealVector.getL1Distance(RealVector)
• RealVector.getLInfNorm()

isInfinite

             public boolean isInfinite()
            

检查这个向量的任何坐标是否为无穷大且没有 NaN。

指定者:

isInfinite 在类中 RealVector

返回:

如果这个向量的任何坐标是无穷大且没有 NaN，则返回 true，否则返回 false。

isNaN

             public boolean isNaN()
            

检查这个向量的任何坐标是否为 NaN。

指定者:

isNaN 在类中 RealVector

返回:

如果这个向量的任何坐标是 NaN，则返回 true，否则返回 false。

mapAdd

             public OpenMapRealVector mapAdd(double d)
            

将一个值添加到每个条目。返回一个新向量。不更改实例数据。

覆盖:

mapAdd 在类中 RealVector

参数:

d - 要添加到每个条目的值。

返回:

this + d。

mapAddToSelf

             public OpenMapRealVector mapAddToSelf(double d)
            

将一个值添加到每个条目。实例在原地更改。

覆盖:

mapAddToSelf 在类中 RealVector

参数:

d - 要添加到每个条目的值。

返回:

this。

setEntry

             public void setEntry(int index, double value) throws MathIllegalArgumentException
            

设置单个元素。

指定者:

setEntry 在类中 RealVector

参数:

index - 元素索引。

value - 元素的新值。

抛出:

MathIllegalArgumentException - 如果索引无效。

另请参阅:

• RealVector.getEntry(int)

setSubVector

             public void setSubVector(int index, RealVector v) throws MathIllegalArgumentException
            

设置一系列连续的元素。

指定者:

setSubVector 在类中 RealVector

参数:

index - 要设置的第一个元素的索引。

v - 包含要设置的值的向量。

抛出:

MathIllegalArgumentException - 如果索引无效。

set

             public void set(double value)
            

将所有元素设置为单个值。

覆盖:

set 在类中 RealVector

参数:

value - 要为所有元素设置的单个值。

subtract

             public OpenMapRealVector subtract(OpenMapRealVector v) throws MathIllegalArgumentException
            

优化的方法，用于减去 OpenMapRealVectors。

参数:

v - 要从this中减去的向量。

返回:

this 和 v 的差异。

抛出:

MathIllegalArgumentException - 如果维度不匹配。

subtract

             public RealVector subtract(RealVector v) throws MathIllegalArgumentException
            

从此向量中减去v。返回一个新向量。不更改实例数据。

覆盖:

subtract 在类中 RealVector

参数:

v - 要减去的向量。

返回:

this - v。

抛出:

MathIllegalArgumentException - 如果v与this向量的大小不同。

unitVector

             public OpenMapRealVector unitVector() throws MathRuntimeException
            

创建一个指向此向量方向的单位向量。此方法不会更改实例。

覆盖:

unitVector 在类中 RealVector

返回:

指向此向量方向的单位向量。

抛出:

MathRuntimeException - 如果范数为零。

unitize

             public void unitize() throws MathRuntimeException
            

将此向量转换为单位向量。此方法会更改实例本身。

覆盖:

unitize 在类中 RealVector

抛出:

MathRuntimeException - 如果范数为零。

toArray

             public double[] toArray()
            

将向量转换为double数组。该数组与此向量数据独立：元素被复制。

覆盖:

toArray 在类中 RealVector

返回:

包含向量元素副本的数组。

hashCode

             public int hashCode()
            

. 此方法必须被RealVector的具体子类覆盖（当前实现会抛出异常）。实现注意事项：这适用于精确值，因此可能会导致a.subtract(b)为零向量，而a.hashCode() != b.hashCode()。

覆盖:

hashCode 在类中 RealVector

equals

             public boolean equals(Object obj)
            

测试两个实向量是否相等。如果两个实向量的所有坐标完全相同，并且没有一个是NaN，则认为两个实向量相等。将NaN坐标视为全局影响向量并相互相等 - 即，如果实向量的任一（或全部）坐标等于NaN，则该实向量等于所有坐标均为NaN的向量。

此方法必须被RealVector的具体子类覆盖（当前实现会抛出异常）。

实现注意事项：这执行精确比较，因此可能导致a.subtract(b}为零向量，而 a.equals(b) == false。

覆盖:

equals 在类中 RealVector

参数:

obj - 要测试是否相等的对象。

返回:

如果两个向量对象相等，则返回true，如果other为null、不是RealVector的实例或与此RealVector实例不相等，则返回false。

getSparsity

             public double getSparsity()
            

获取非零元素的百分比作为十进制百分比。

返回:

非零元素的百分比作为十进制百分比

sparseIterator

             public Iterator<RealVector.Entry> sparseIterator()
            

创建一个稀疏迭代器，该迭代器可能省略一些条目。省略的条目要么是精确的零（对于密集实现），要么是未存储的条目（对于真实稀疏向量）。不保证迭代顺序。

注意：派生类需要返回一个Iterator，只要Iterator.hasNext()返回true，就返回非null的RealVector.Entry对象。

覆盖:

sparseIterator 在类中 RealVector

返回:

一个稀疏迭代器。