etomica.space3d

Class OrientationFull3D

java.lang.Object

etomica.space3d.OrientationFull3D

All Implemented Interfaces:

IOrientation, IOrientation3D, IOrientationFull3D, java.io.Serializable

public class OrientationFull3D
extends java.lang.Object
implements IOrientationFull3D, java.io.Serializable

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected IVectorMutable	direction
protected Tensor3D	rotationTensor
protected IVectorMutable	secondaryDirection
protected IVectorMutable	v2
protected IVectorMutable	v3

Constructor Summary

Constructors

Constructor and Description
OrientationFull3D(ISpace space) Default constructor sets orientation to point in the X direction.

Method Summary

Modifier and Type	Method and Description
void	E(IOrientation o) Copies the given orientation to this one.
IVector	getDirection() Returns a unit vector pointing in the orientation's direction.
IVector	getSecondaryDirection() Returns a unit vector pointing in the orientation's secondary direction.
void	randomRotation(IRandom random, double tStep) Applies a random rotation of angle selected uniformly from 0 to tStep.
void	relax() Normalizes both direction and secondaryDirection
void	rotateBy(double dt, IVector axis) Rotates orientation by the given value about the given axis.
void	setDirection(IVector newDirection) Sets this orientation to point in the given direction.
void	setDirections(IVector newPrimaryDirection, IVector newSecondaryDirection) Sets the orientation's primary and secondary direction to be the given directions.

Methods inherited from class java.lang.Object

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

Field Detail

direction

protected final IVectorMutable direction

secondaryDirection

protected final IVectorMutable secondaryDirection

v2

protected final IVectorMutable v2

v3

protected final IVectorMutable v3

rotationTensor

protected final Tensor3D rotationTensor

Constructor Detail

OrientationFull3D

public OrientationFull3D(ISpace space)

Default constructor sets orientation to point in the X direction.

Method Detail

E

public void E(IOrientation o)

Description copied from interface: IOrientation

Copies the given orientation to this one.

Specified by:

E in interface IOrientation

getDirection

public IVector getDirection()

Description copied from interface: IOrientation

Returns a unit vector pointing in the orientation's direction. This vector should not be modified.

Specified by:

getDirection in interface IOrientation

getSecondaryDirection

public IVector getSecondaryDirection()

Description copied from interface: IOrientationFull3D

Returns a unit vector pointing in the orientation's secondary direction. This vector should not be modified.

Specified by:

getSecondaryDirection in interface IOrientationFull3D

setDirection

public void setDirection(IVector newDirection)

Sets this orientation to point in the given direction.

Specified by:

setDirection in interface IOrientation

Throws:

an - exception if vector has 0 length

setDirections

public void setDirections(IVector newPrimaryDirection,
                          IVector newSecondaryDirection)

Description copied from interface: IOrientationFull3D

Sets the orientation's primary and secondary direction to be the given directions. The two vectors should be orthogonal.

Specified by:

setDirections in interface IOrientationFull3D

rotateBy

public void rotateBy(double dt,
                     IVector axis)

Rotates orientation by the given value about the given axis. The axis must have unit length, but need not be perpendicular to the current orientation direction.

Specified by:

rotateBy in interface IOrientation3D

randomRotation

public void randomRotation(IRandom random,
                           double tStep)

Applies a random rotation of angle selected uniformly from 0 to tStep. The rotation axis is selected randomly.

Specified by:

randomRotation in interface IOrientation

relax

public void relax()

Normalizes both direction and secondaryDirection