de.tsl2.nano.math.vector

Class Vector

java.lang.Object

de.tsl2.nano.math.vector.Coordinate

de.tsl2.nano.math.vector.Vector

All Implemented Interfaces:

Serializable, Comparable<Vector>

Direct Known Subclasses:

Vector3D

public class Vector
extends Coordinate
implements Comparable<Vector>

Simple-handling numeric n-dim vector with common calculations. See Coordinate for further informations.

Author:

ts

See Also:

Serialized Form

Field Summary

Fields inherited from class de.tsl2.nano.math.vector.Coordinate

x

Constructor Summary

Constructors

Constructor and Description
Vector(float... v)

Method Summary

Modifier and Type	Method and Description
void	add(float... v) add
void	add(Vector v) add
static Vector	add(Vector v1, Vector... vv) add
float	angle(Vector v) through the scalar product it is possible to calculate the angle between two vectors.
int	compareTo(Vector o)
static Vector	create(int dim, float defaultValue) create
float	distance(float... v) distance as scalar.
Vector	distance(Vector v2) distance between this and v2. see subtract(Vector, Vector...).
static Vector	e(int dim, int row) creates an n-dim normalized vector with number 1 on given row.
static List<Vector>	fromStream(InputStream stream)
static Vector	invert(Vector v) invert given vector
protected static int	isEVector(Vector v) isEVector
float	len() length of current vector
void	multiply(float[]... m) multiply with an equal-dim matrix
float	multiply(Vector v) delegates to scalar(float...)
void	multiply(Vector[] m) multiply with an equal-dim matrix
void	normalize() normalize vector
static Vector	normalize(Vector v) normalize the given vector
void	orthogonizeInPlaneWith(Vector v2) orthogonizeInPlaneWith
protected float	scalar(float... v) scalar / inner / dot product
float	scalar(Vector v) see scalar(float...)
static Vector	scale(Vector v, float f) scale
protected void	subtract(float... v) subtract
void	subtract(Vector v) subtract
static Vector	subtract(Vector v1, Vector... vv) subtract
static InputStream	toStream(List<Vector> vl)

Methods inherited from class de.tsl2.nano.math.vector.Coordinate

checkDimension, checkDimension, clone, dimension, equals, hashCode, scale, scale, set, set, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Vector

public Vector(float... v)

Parameters:

v - any vector

Method Detail

create

public static Vector create(int dim,
                            float defaultValue)

create

Parameters:

dim - dimension

defaultValue - default value for each cell

Returns:

new vector

scale

public static Vector scale(Vector v,
                           float f)

scale

Parameters:

v - vector to be scaled

f - scale factor

Returns:

new vector instance, scaled by f.

add

public void add(Vector v)

add

Parameters:

v - vector to add

add

public static Vector add(Vector v1,
                         Vector... vv)

add

Parameters:

v1 - source vector to add the vectors vv to.

vv - adding vectors

Returns:

new vector instance as sum of all vectors

add

public void add(float... v)

add

Overrides:

add in class Coordinate

Parameters:

v - coordinate to add

subtract

public static Vector subtract(Vector v1,
                              Vector... vv)

subtract

Parameters:

v1 - source vector to subtract the vectors vv from.

vv - subtractions vectors

Returns:

new vector instance as subtraction

subtract

protected void subtract(float... v)

subtract

Parameters:

v - vector to subtract

subtract

public void subtract(Vector v)

subtract

Parameters:

v - vector to subtract

scalar

public float scalar(Vector v)

see scalar(float...)

scalar

protected float scalar(float... v)

scalar / inner / dot product

Parameters:

v - second operand of scalar

Returns:

scalar product of this and v

multiply

public float multiply(Vector v)

delegates to scalar(float...)

angle

public float angle(Vector v)

through the scalar product it is possible to calculate the angle between two vectors.

Parameters:

v - another vector to calc the inner angle to

Returns:

inner angle between the two vectors

multiply

public void multiply(float[]... m)

multiply with an equal-dim matrix

Parameters:

m - matrix

multiply

public void multiply(Vector[] m)

multiply with an equal-dim matrix

Parameters:

m - matrix

len

public float len()

length of current vector

Returns:

distance

public Vector distance(Vector v2)

distance between this and v2. see subtract(Vector, Vector...).

Parameters:

v2 - second operand

Returns:

distance between the two vectors

distance

public float distance(float... v)

distance as scalar.

Parameters:

v - second operand

Returns:

scalar distance

normalize

public static Vector normalize(Vector v)

normalize the given vector

Parameters:

v - vector to normalize

Returns:

new normalized vector instance

normalize

public void normalize()

normalize vector

orthogonizeInPlaneWith

public void orthogonizeInPlaneWith(Vector v2)

orthogonizeInPlaneWith

Parameters:

v2 - second operand in plane with current vector.

isEVector

protected static int isEVector(Vector v)

isEVector

Returns:

axis/row of 1

e

public static Vector e(int dim,
                       int row)

creates an n-dim normalized vector with number 1 on given row.

Parameters:

dim - dimension

row - coordinate position of 1.

Returns:

new vector instance

invert

public static Vector invert(Vector v)

invert given vector

Parameters:

v - vector to invert

Returns:

new vector instance

compareTo

public int compareTo(Vector o)

Specified by:

compareTo in interface Comparable<Vector>

fromStream

public static List<Vector> fromStream(InputStream stream)

toStream

public static InputStream toStream(List<Vector> vl)