jsci.maths.vectors

Class IntegerVector

java.lang.Object

jsci.maths.vectors.MathVector

jsci.maths.vectors.AbstractIntegerVector

jsci.maths.vectors.IntegerVector

All Implemented Interfaces:

java.io.Serializable, Module.Member, AbelianGroup.Member, Member

public class IntegerVector
extends AbstractIntegerVector

An array-based implementation of an integer vector.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
IntegerVector(int dim) Constructs an empty vector.
IntegerVector(int[] array) Constructs a vector by wrapping an array.

Method Summary

Modifier and Type	Method and Description
AbelianGroup.Member	add(AbelianGroup.Member v) Returns the addition of this vector and another.
AbstractIntegerVector	add(AbstractIntegerVector v) Returns the addition of this vector and another.
IntegerVector	add(IntegerVector v)
boolean	equals(java.lang.Object a) Compares two integer vectors for equality.
int	getComponent(int n) Returns a component of this vector.
double	infNorm() Returns the l-norm.
AbelianGroup.Member	negate() Returns the negative of this vector.
double	norm() Returns the l2-norm (magnitude).
double	norm(int n) Returns the ln-norm.
AbstractIntegerVector	scalarMultiply(int x) Returns the multiplication of this vector by a scalar.
Module.Member	scalarMultiply(Ring.Member x) Returns the multiplication of this vector by a scalar.
int	scalarProduct(AbstractIntegerVector v) Returns the scalar product of this vector and another.
int	scalarProduct(IntegerVector v)
void	setComponent(int n, int x) Sets the value of a component of this vector.
AbelianGroup.Member	subtract(AbelianGroup.Member v) Returns the subtraction of this vector by another.
AbstractIntegerVector	subtract(AbstractIntegerVector v) Returns the subtraction of this vector by another.
IntegerVector	subtract(IntegerVector v)
AbstractComplexVector	toComplexVector() Converts this vector to a complex vector.
AbstractDoubleVector	toDoubleVector() Converts this vector to a double vector.
java.lang.String	toString() Returns a comma delimited string representing the value of this vector.

Methods inherited from class jsci.maths.vectors.AbstractIntegerVector

getSet, hashCode

Methods inherited from class jsci.maths.vectors.MathVector

dimension

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

IntegerVector

public IntegerVector(int dim)

Constructs an empty vector.

Parameters:

dim - the dimension of the vector.

IntegerVector

public IntegerVector(int[] array)

Constructs a vector by wrapping an array.

Parameters:

array - an assigned value

Method Detail

equals

public boolean equals(java.lang.Object a)

Compares two integer vectors for equality.

Overrides:

equals in class AbstractIntegerVector

Parameters:

a - an integer vector

toString

public java.lang.String toString()

Returns a comma delimited string representing the value of this vector.

Overrides:

toString in class AbstractIntegerVector

toDoubleVector

public AbstractDoubleVector toDoubleVector()

Converts this vector to a double vector.

Overrides:

toDoubleVector in class AbstractIntegerVector

Returns:

a double vector

toComplexVector

public AbstractComplexVector toComplexVector()

Converts this vector to a complex vector.

Returns:

a complex vector

getComponent

public int getComponent(int n)

Returns a component of this vector.

Specified by:

getComponent in class AbstractIntegerVector

Parameters:

n - index of the vector component

Throws:

VectorDimensionException - If attempting to access an invalid component.

setComponent

public void setComponent(int n,
                         int x)

Sets the value of a component of this vector.

Specified by:

setComponent in class AbstractIntegerVector

Parameters:

n - index of the vector component

x - an integer

Throws:

VectorDimensionException - If attempting to access an invalid component.

norm

public double norm(int n)

Returns the lⁿ-norm.

Overrides:

norm in class AbstractIntegerVector

norm

public double norm()

Returns the l²-norm (magnitude).

Overrides:

norm in class AbstractIntegerVector

infNorm

public double infNorm()

Returns the l-norm.

Overrides:

infNorm in class AbstractIntegerVector

negate

public AbelianGroup.Member negate()

Returns the negative of this vector.

add

public AbelianGroup.Member add(AbelianGroup.Member v)

Returns the addition of this vector and another.

Parameters:

v - a group member

add

public AbstractIntegerVector add(AbstractIntegerVector v)

Returns the addition of this vector and another.

Specified by:

add in class AbstractIntegerVector

Parameters:

v - an integer vector

Throws:

VectorDimensionException - If the vectors are different sizes.

add

public IntegerVector add(IntegerVector v)

subtract

public AbelianGroup.Member subtract(AbelianGroup.Member v)

Returns the subtraction of this vector by another.

Parameters:

v - a group member

subtract

public AbstractIntegerVector subtract(AbstractIntegerVector v)

Returns the subtraction of this vector by another.

Specified by:

subtract in class AbstractIntegerVector

Parameters:

v - an integer vector

Throws:

VectorDimensionException - If the vectors are different sizes.

subtract

public IntegerVector subtract(IntegerVector v)

scalarMultiply

public Module.Member scalarMultiply(Ring.Member x)

Returns the multiplication of this vector by a scalar.

Parameters:

x - a ring member

scalarMultiply

public AbstractIntegerVector scalarMultiply(int x)

Returns the multiplication of this vector by a scalar.

Specified by:

scalarMultiply in class AbstractIntegerVector

Parameters:

x - an integer

scalarProduct

public int scalarProduct(AbstractIntegerVector v)

Returns the scalar product of this vector and another.

Specified by:

scalarProduct in class AbstractIntegerVector

Parameters:

v - an integer vector

Throws:

VectorDimensionException - If the vectors are different sizes.

scalarProduct

public int scalarProduct(IntegerVector v)