程序包 org.hipparchus.linear

类 SparseFieldVector<T extends FieldElement<T>>

java.lang.Object

org.hipparchus.linear.SparseFieldVector<T>

类型参数:

T - 字段元素的类型

所有已实现的接口:

Serializable, FieldVector<T>

       public class SparseFieldVector<T extends FieldElement<T>> extends Object implements FieldVector<T>, Serializable
      

该类使用OpenIntToFieldHashMap作为后端存储实现了FieldVector接口。

注意：此实现假定对于任何x，等式x * 0d == 0d成立。但对于NaN来说并非如此。此外，零条目将失去其符号。因此，某些操作（涉及NaN和/或无穷大）可能会导致不正确的结果。

另请参阅:

• 序列化表格

构造器概要

构造器

限定符	构造器	说明
	SparseFieldVector(Field<T> field)	构建一个长度为0的向量。
	SparseFieldVector(Field<T> field, int dimension)	构造一个零向量。
	SparseFieldVector(Field<T> field, int dimension, int expectedSize)	构建一个已知稀疏度的向量（仅供高级使用）。
	SparseFieldVector(Field<T> field, T[] values)	从字段数组创建。
	SparseFieldVector(SparseFieldVector<T> v)	复制构造函数。
protected	SparseFieldVector(SparseFieldVector<T> v, int resize)	构建一个调整大小的向量，用于追加。

方法概要

修饰符和类型	方法	说明
FieldVector<T>	add(FieldVector<T> v)	计算this和v的和。
FieldVector<T>	add(SparseFieldVector<T> v)	优化的方法来添加稀疏向量。
FieldVector<T>	append(FieldVector<T> v)	通过将一个向量附加到此向量来构造一个向量。
FieldVector<T>	append(SparseFieldVector<T> v)	通过将一个向量附加到此向量来构造一个向量。
FieldVector<T>	append(T d)	通过将一个T附加到此向量来构造一个向量。
protected void	checkVectorDimensions(int n)	检查实例维度是否等于某个预期值。
FieldVector<T>	copy()	返回此向量的（深层）副本。
T	dotProduct(FieldVector<T> v)	计算点积。
FieldVector<T>	ebeDivide(FieldVector<T> v)	逐元素除法。
FieldVector<T>	ebeMultiply(FieldVector<T> v)	逐元素乘法。
boolean	equals(Object obj)
int	getDimension()	返回向量的大小。
T	getEntry(int index)	返回指定索引处的条目。
Field<T>	getField()	获取向量的字段元素类型。
FieldVector<T>	getSubVector(int index, int n)	从连续元素中获取子向量。
int	hashCode()
FieldVector<T>	mapAdd(T d)	将加法操作映射到每个条目。
FieldVector<T>	mapAddToSelf(T d)	将加法操作映射到每个条目。
FieldVector<T>	mapDivide(T d)	将除法操作映射到每个条目。
FieldVector<T>	mapDivideToSelf(T d)	将除法操作映射到每个条目。
FieldVector<T>	mapInv()	将1/x函数映射到每个条目。
FieldVector<T>	mapInvToSelf()	将1/x函数映射到每个条目。
FieldVector<T>	mapMultiply(T d)	将乘法操作映射到每个条目。
FieldVector<T>	mapMultiplyToSelf(T d)	将乘法操作映射到每个条目。
FieldVector<T>	mapSubtract(T d)	将减法操作映射到每个条目。
FieldVector<T>	mapSubtractToSelf(T d)	将减法操作映射到每个条目。
FieldMatrix<T>	outerProduct(FieldVector<T> v)	计算外积。
FieldMatrix<T>	outerProduct(SparseFieldVector<T> v)	当两个向量都是稀疏向量时，计算外积的优化方法。
FieldVector<T>	projection(FieldVector<T> v)	找到此向量在另一个向量上的正交投影。
void	set(T value)	将所有元素设置为单个值。
void	setEntry(int index, T value)	设置单个元素。
void	setSubVector(int index, FieldVector<T> v)	设置一组连续元素。
FieldVector<T>	subtract(FieldVector<T> v)	计算this减去v。
SparseFieldVector<T>	subtract(SparseFieldVector<T> v)	计算this减去v的优化方法。
T[]	toArray()	将向量转换为T数组。
T	walkInDefaultOrder(FieldVectorChangingVisitor<T> visitor)	以默认顺序（增加索引）访问（可能更改）此向量的所有条目。
T	walkInDefaultOrder(FieldVectorChangingVisitor<T> visitor, int start, int end)	以默认顺序（增加索引）访问（可能更改）此向量的一些条目。
T	walkInDefaultOrder(FieldVectorPreservingVisitor<T> visitor)	以默认顺序（增加索引）访问（但不更改）此向量的所有条目。
T	walkInDefaultOrder(FieldVectorPreservingVisitor<T> visitor, int start, int end)	以默认顺序（增加索引）访问（但不更改）此向量的一些条目。
T	walkInOptimizedOrder(FieldVectorChangingVisitor<T> visitor)	以优化顺序访问（可能更改）此向量的所有条目。
T	walkInOptimizedOrder(FieldVectorChangingVisitor<T> visitor, int start, int end)	以优化顺序访问（可能更改）此向量的一些条目。
T	walkInOptimizedOrder(FieldVectorPreservingVisitor<T> visitor)	以优化顺序访问（但不更改）此向量的所有条目。
T	walkInOptimizedOrder(FieldVectorPreservingVisitor<T> visitor, int start, int end)	以优化顺序访问（但不更改）此向量的一些条目。

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

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

构造器详细资料

SparseFieldVector

             public SparseFieldVector(Field<T> field)
            

构建一个长度为0的向量。零长度向量可用于通过数据收集初始化向量的构造。我们从零长度开始，使用SparseFieldVector(SparseFieldVector, int)构造函数或append方法之一（append(FieldVector)或append(SparseFieldVector)）将数据收集到此向量中。

参数:

field - 元素所属的字段。

SparseFieldVector

             public SparseFieldVector(Field<T> field, int dimension)
            

构造一个零向量。

参数:

field - 元素所属的字段。

dimension - 向量的大小。

SparseFieldVector

             protected SparseFieldVector(SparseFieldVector<T> v, int resize)
            

构建一个调整大小的向量，用于追加。

参数:

v - 原始向量

resize - 要添加的数量。

SparseFieldVector

             public SparseFieldVector(Field<T> field, int dimension, int expectedSize)
            

构建一个已知稀疏度的向量（仅供高级使用）。

参数:

field - 元素所属的字段。

dimension - 向量的大小。

expectedSize - 非零条目的预期数量。

SparseFieldVector

             public SparseFieldVector(Field<T> field, T[] values) throws NullArgumentException
            

从字段数组创建。只存储非零条目。

参数:

field - 元素所属的字段。

values - 要从中创建的值集。

抛出:

NullArgumentException - 如果值为null

SparseFieldVector

             public SparseFieldVector(SparseFieldVector<T> v)
            

复制构造函数。

参数:

v - 要复制的实例。

方法详细资料

add

             public FieldVector<T> add(SparseFieldVector<T> v) throws MathIllegalArgumentException
            

优化的方法来添加稀疏向量。

参数:

v - 要添加的向量。

返回:

this + v。

抛出:

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

append

             public FieldVector<T> append(SparseFieldVector<T> v)
            

通过将一个向量附加到此向量来构造一个向量。

参数:

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

返回:

一个新向量。

append

             public FieldVector<T> append(FieldVector<T> v)
            

通过将一个向量附加到此向量来构造一个向量。

指定者:

append 在接口中 FieldVector<T extends FieldElement<T>>

参数:

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

返回:

一个新向量

append

             public FieldVector<T> append(T d) throws NullArgumentException
            

通过将一个T附加到此向量来构造一个向量。

指定者:

append 在接口中 FieldVector<T extends FieldElement<T>>

参数:

d - 要附加的T。

返回:

一个新向量

抛出:

NullArgumentException - 如果d为null

copy

             public FieldVector<T> copy()
            

返回此向量的（深层）副本。

指定者:

copy 在接口中 FieldVector<T extends FieldElement<T>>

返回:

向量副本

dotProduct

             public T dotProduct(FieldVector<T> v) throws MathIllegalArgumentException
            

计算点积。

指定者:

dotProduct 在接口中 FieldVector<T extends FieldElement<T>>

参数:

v - 用于计算点积的向量

返回:

this 和 v 的标量点积

抛出:

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

ebeDivide

             public FieldVector<T> ebeDivide(FieldVector<T> v) throws MathIllegalArgumentException, MathRuntimeException
            

逐元素除法。

指定者:

ebeDivide 在接口中 FieldVector<T extends FieldElement<T>>

参数:

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

返回:

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

抛出:

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

MathRuntimeException - 如果 v 的一个条目为零

ebeMultiply

             public FieldVector<T> ebeMultiply(FieldVector<T> v) throws MathIllegalArgumentException
            

逐元素乘法。

指定者:

ebeMultiply 在接口中 FieldVector<T extends FieldElement<T>>

参数:

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

返回:

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

抛出:

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

getDimension

             public int getDimension()
            

返回向量的大小。

指定者:

getDimension 在接口中 FieldVector<T extends FieldElement<T>>

返回:

大小

getEntry

             public T getEntry(int index) throws MathIllegalArgumentException
            

返回指定索引处的条目。

指定者:

getEntry 在接口中 FieldVector<T extends FieldElement<T>>

参数:

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

返回:

index 处的向量条目。

抛出:

MathIllegalArgumentException - 如果索引无效

另请参阅:

• FieldVector.setEntry(int, FieldElement)

getField

             public Field<T> getField()
            

获取向量的字段元素类型。

指定者:

getField 在接口中 FieldVector<T extends FieldElement<T>>

返回:

向量的字段元素类型

getSubVector

             public FieldVector<T> getSubVector(int index, int n) throws MathIllegalArgumentException
            

获取连续元素的子向量。

指定者:

getSubVector 在接口中 FieldVector<T extends FieldElement<T>>

参数:

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

n - 要检索的元素数量。

返回:

包含 n 个元素的向量。

抛出:

MathIllegalArgumentException - 如果索引无效

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

mapAdd

             public FieldVector<T> mapAdd(T d) throws NullArgumentException
            

将加法操作映射到每个条目。

指定者:

mapAdd 在接口中 FieldVector<T extends FieldElement<T>>

参数:

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

返回:

this + d

抛出:

NullArgumentException - 如果 d 为 null

mapAddToSelf

             public FieldVector<T> mapAddToSelf(T d) throws NullArgumentException
            

将加法操作映射到每个条目。

此方法会更改实例。

指定者:

mapAddToSelf 在接口中 FieldVector<T extends FieldElement<T>>

参数:

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

返回:

为方便起见，返回 this

抛出:

NullArgumentException - 如果 d 为 null

mapDivide

             public FieldVector<T> mapDivide(T d) throws NullArgumentException, MathRuntimeException
            

将除法操作映射到每个条目。

指定者:

mapDivide 在接口中 FieldVector<T extends FieldElement<T>>

参数:

d - 要将所有条目除以的值

返回:

this / d

抛出:

NullArgumentException - 如果 d 为 null

MathRuntimeException - 如果 d 为零

mapDivideToSelf

             public FieldVector<T> mapDivideToSelf(T d) throws NullArgumentException, MathRuntimeException
            

将除法操作映射到每个条目。

此方法会更改实例。

指定者:

mapDivideToSelf 在接口中 FieldVector<T extends FieldElement<T>>

参数:

d - value to divide all entries by

返回:

for convenience, return this

抛出:

NullArgumentException - if d is null.

MathRuntimeException - if d is zero.

mapInv

             public FieldVector<T> mapInv() throws MathRuntimeException
            

Map the 1/x function to each entry.

指定者:

mapInv 在接口中 FieldVector<T extends FieldElement<T>>

返回:

包含将函数应用于每个条目的结果的向量。

抛出:

MathRuntimeException - 如果其中一个条目为零。

mapInvToSelf

             public FieldVector<T> mapInvToSelf() throws MathRuntimeException
            

将1/x函数映射到每个条目。

此方法会更改实例。

指定者:

mapInvToSelf 在接口中 FieldVector<T extends FieldElement<T>>

返回:

为方便起见，返回this

抛出:

MathRuntimeException - 如果其中一个条目为零。

mapMultiply

             public FieldVector<T> mapMultiply(T d) throws NullArgumentException
            

将乘法操作映射到每个条目。

指定者:

mapMultiply 在接口中 FieldVector<T extends FieldElement<T>>

参数:

d - 要将所有条目乘以的值

返回:

this * d

抛出:

NullArgumentException - 如果d为null。

mapMultiplyToSelf

             public FieldVector<T> mapMultiplyToSelf(T d) throws NullArgumentException
            

将乘法操作映射到每个条目。

此方法会更改实例。

指定者:

mapMultiplyToSelf 在接口中 FieldVector<T extends FieldElement<T>>

参数:

d - 要将所有条目乘以的值

返回:

为方便起见，返回this

抛出:

NullArgumentException - 如果d为null。

mapSubtract

             public FieldVector<T> mapSubtract(T d) throws NullArgumentException
            

将减法操作映射到每个条目。

指定者:

mapSubtract 在接口中 FieldVector<T extends FieldElement<T>>

参数:

d - 要从每个条目中减去的值

返回:

this - d

抛出:

NullArgumentException - 如果d为null

mapSubtractToSelf

             public FieldVector<T> mapSubtractToSelf(T d) throws NullArgumentException
            

将减法操作映射到每个条目。

此方法会更改实例。

指定者:

mapSubtractToSelf 在接口中 FieldVector<T extends FieldElement<T>>

参数:

d - 要从每个条目中减去的值

返回:

为方便起见，返回this

抛出:

NullArgumentException - 如果d为null

outerProduct

             public FieldMatrix<T> outerProduct(SparseFieldVector<T> v)
            

当两个向量都是稀疏时，计算外积的优化方法。

参数:

v - 要计算外积的向量

返回:

实例和v之间的矩阵外积

outerProduct

             public FieldMatrix<T> outerProduct(FieldVector<T> v)
            

计算外积。

指定者:

outerProduct 在接口中 FieldVector<T extends FieldElement<T>>

参数:

v - 要计算外积的向量

返回:

实例和v之间的矩阵外积

projection

             public FieldVector<T> projection(FieldVector<T> v) throws MathIllegalArgumentException, MathRuntimeException
            

找到此向量在另一个向量上的正交投影。

指定者:

projection 在接口中 FieldVector<T extends FieldElement<T>>

参数:

v - 要投影到this上的向量

返回:

this在v上的投影

抛出:

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

MathRuntimeException - 如果v是空向量。

set

             public void set(T value)
            

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

指定者:

set 在接口中 FieldVector<T extends FieldElement<T>>

参数:

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

抛出:

NullArgumentException - 如果值为null

setEntry

             public void setEntry(int index, T value) throws MathIllegalArgumentException, NullArgumentException
            

设置单个元素。

指定者:

setEntry 在接口中 FieldVector<T extends FieldElement<T>>

参数:

index - 元素索引。

value - 元素的新值。

抛出:

NullArgumentException - 如果值为null

MathIllegalArgumentException - 如果索引无效。

另请参阅:

• FieldVector.getEntry(int)

setSubVector

             public void setSubVector(int index, FieldVector<T> v) throws MathIllegalArgumentException
            

设置一组连续的元素。

指定者:

setSubVector 在接口中 FieldVector<T extends FieldElement<T>>

参数:

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

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

抛出:

MathIllegalArgumentException - 如果索引无效。

subtract

             public SparseFieldVector<T> subtract(SparseFieldVector<T> v) throws MathIllegalArgumentException
            

计算this减去v的优化方法。

参数:

v - 要减去的向量

返回:

this - v

抛出:

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

subtract

             public FieldVector<T> subtract(FieldVector<T> v) throws MathIllegalArgumentException
            

计算this减去v。

指定者:

subtract 在接口中 FieldVector<T extends FieldElement<T>>

参数:

v - 要减去的向量

返回:

this - v

抛出:

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

toArray

             public T[] toArray()
            

将向量转换为T数组。

数组与向量数据独立，其元素被复制。

指定者:

toArray 在接口中 FieldVector<T extends FieldElement<T>>

返回:

包含向量元素副本的数组

checkVectorDimensions

             protected void checkVectorDimensions(int n) throws MathIllegalArgumentException
            

检查实例维度是否等于某个预期值。

参数:

n - 预期维度。

抛出:

MathIllegalArgumentException - 如果维度不匹配。

add

             public FieldVector<T> add(FieldVector<T> v) throws MathIllegalArgumentException
            

计算this和v的和。

指定者:

add 在接口中 FieldVector<T extends FieldElement<T>>

参数:

v - 要添加的向量

返回:

this + v

抛出:

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

walkInDefaultOrder

             public T walkInDefaultOrder(FieldVectorPreservingVisitor<T> visitor)
            

访问（但不更改）默认顺序（索引递增）中此向量的所有条目。

参数:

visitor - 用于处理此向量条目的访问者

返回:

在遍历结束时由FieldVectorPreservingVisitor.end()返回的值

walkInDefaultOrder

             public T walkInDefaultOrder(FieldVectorPreservingVisitor<T> visitor, int start, int end) throws MathIllegalArgumentException
            

访问（但不更改）默认顺序（索引递增）中此向量的某些条目。

参数:

visitor - 用于处理此向量条目的访问者

start - 要访问的第一个条目的索引

end - 要访问的最后一个条目的索引（包括）

返回:

在遍历结束时由FieldVectorPreservingVisitor.end()返回的值

抛出:

MathIllegalArgumentException - 如果end < start。

MathIllegalArgumentException - 如果索引无效。

walkInOptimizedOrder

             public T walkInOptimizedOrder(FieldVectorPreservingVisitor<T> visitor)
            

访问（但不更改）优化顺序中此向量的所有条目。选择访问条目的顺序以导致最有效的实现；这可能取决于此抽象类的具体实现。

参数:

visitor - 用于处理此向量条目的访问者

返回:

在遍历结束时由FieldVectorPreservingVisitor.end()返回的值

walkInOptimizedOrder

             public T walkInOptimizedOrder(FieldVectorPreservingVisitor<T> visitor, int start, int end) throws MathIllegalArgumentException
            

访问（但不更改）优化顺序中此向量的某些条目。选择访问条目的顺序以导致最有效的实现；这可能取决于此抽象类的具体实现。

参数:

visitor - 用于处理此向量条目的访问者

start - 要访问的第一个条目的索引

end - 要访问的最后一个条目的索引（包括）

返回:

在遍历结束时由FieldVectorPreservingVisitor.end()返回的值

抛出:

MathIllegalArgumentException - 如果end < start。

MathIllegalArgumentException - 如果索引无效。

walkInDefaultOrder

             public T walkInDefaultOrder(FieldVectorChangingVisitor<T> visitor)
            

访问（并可能更改）默认顺序（索引递增）中此向量的所有条目。

参数:

visitor - 用于处理和修改此向量条目的访问者

返回:

在遍历结束时由FieldVectorChangingVisitor.end()返回的值

walkInDefaultOrder

             public T walkInDefaultOrder(FieldVectorChangingVisitor<T> visitor, int start, int end) throws MathIllegalArgumentException
            

访问（并可能更改）默认顺序（索引递增）中此向量的某些条目。

参数:

visitor - 用于处理此向量条目的访问者

start - 要访问的第一个条目的索引

end - 要访问的最后一个条目的索引（包括）

返回:

在遍历结束时由FieldVectorChangingVisitor.end()返回的值

抛出:

MathIllegalArgumentException - 如果end < start。

MathIllegalArgumentException - 如果索引无效。

walkInOptimizedOrder

             public T walkInOptimizedOrder(FieldVectorChangingVisitor<T> visitor)
            

访问（并可能更改）优化顺序中此向量的所有条目。选择访问条目的顺序以导致最有效的实现；这可能取决于此抽象类的具体实现。

参数:

visitor - 用于处理此向量条目的访问者

返回:

在遍历结束时由FieldVectorChangingVisitor.end()返回的值

walkInOptimizedOrder

             public T walkInOptimizedOrder(FieldVectorChangingVisitor<T> visitor, int start, int end) throws MathIllegalArgumentException
            

访问（并可能更改）优化顺序中此向量的某些条目。选择访问条目的顺序以导致最有效的实现；这可能取决于此抽象类的具体实现。

参数:

visitor - 用于处理此向量条目的访问者

start - 要访问的第一个条目的索引

end - 要访问的最后一个条目的索引（包括）

返回:

在遍历结束时由FieldVectorChangingVisitor.end()返回的值

抛出:

MathIllegalArgumentException - 如果end < start。

MathIllegalArgumentException - 如果索引无效。

hashCode

             public int hashCode()
            

覆盖:

hashCode 在类中 Object

equals

             public boolean equals(Object obj)
            

覆盖:

equals 在类中 Object