Package com.irurueta.navigation.frames

Class ECIFrame

java.lang.Object

com.irurueta.navigation.frames.ECIorECEFFrame<ECIFrame>

com.irurueta.navigation.frames.ECIFrame

All Implemented Interfaces:

Frame, Serializable, Cloneable

public class ECIFrame
extends ECIorECEFFrame<ECIFrame>
implements Cloneable

Contains position, velocity and coordinates transformation matrix expressed in ECI frame. Position and velocity of this frame is expressed along ECI axes as described here: FrameType.EARTH_CENTERED_INERTIAL_FRAME.

See Also:

• Serialized Form

Field Summary

Fields inherited from class com.irurueta.navigation.frames.ECIorECEFFrame

c, clazz, NUM_POSITION_COORDINATES, NUM_VELOCITY_COORDINATES, vx, vy, vz, x, y, z

Constructor Summary

Constructors

Constructor	Description
ECIFrame()	Constructor.
ECIFrame(double x, double y, double z)	Constructor.
ECIFrame(double x, double y, double z, double vx, double vy, double vz)	Constructor.
ECIFrame(double x, double y, double z, double vx, double vy, double vz, CoordinateTransformation c)	Constructor.
ECIFrame(double x, double y, double z, CoordinateTransformation c)	Constructor.
ECIFrame(double x, double y, double z, com.irurueta.units.Speed speedX, com.irurueta.units.Speed speedY, com.irurueta.units.Speed speedZ)	Constructor.
ECIFrame(double x, double y, double z, com.irurueta.units.Speed speedX, com.irurueta.units.Speed speedY, com.irurueta.units.Speed speedZ, CoordinateTransformation c)	Constructor.
ECIFrame(com.irurueta.geometry.Point3D position)	Constructor.
ECIFrame(com.irurueta.geometry.Point3D position, double vx, double vy, double vz)	Constructor.
ECIFrame(com.irurueta.geometry.Point3D position, double vx, double vy, double vz, CoordinateTransformation c)	Constructor.
ECIFrame(com.irurueta.geometry.Point3D position, CoordinateTransformation c)	Constructor.
ECIFrame(com.irurueta.geometry.Point3D position, com.irurueta.units.Speed speedX, com.irurueta.units.Speed speedY, com.irurueta.units.Speed speedZ)	Constructor.
ECIFrame(com.irurueta.geometry.Point3D position, com.irurueta.units.Speed speedX, com.irurueta.units.Speed speedY, com.irurueta.units.Speed speedZ, CoordinateTransformation c)	Constructor.
ECIFrame(CoordinateTransformation c)	Constructor.
ECIFrame(ECIFrame input)	Constructor.
ECIFrame(com.irurueta.units.Distance positionX, com.irurueta.units.Distance positionY, com.irurueta.units.Distance positionZ)	Constructor.
ECIFrame(com.irurueta.units.Distance positionX, com.irurueta.units.Distance positionY, com.irurueta.units.Distance positionZ, double vx, double vy, double vz)	Constructor.
ECIFrame(com.irurueta.units.Distance positionX, com.irurueta.units.Distance positionY, com.irurueta.units.Distance positionZ, double vx, double vy, double vz, CoordinateTransformation c)	Constructor.
ECIFrame(com.irurueta.units.Distance positionX, com.irurueta.units.Distance positionY, com.irurueta.units.Distance positionZ, CoordinateTransformation c)	Constructor.
ECIFrame(com.irurueta.units.Distance positionX, com.irurueta.units.Distance positionY, com.irurueta.units.Distance positionZ, com.irurueta.units.Speed speedX, com.irurueta.units.Speed speedY, com.irurueta.units.Speed speedZ)	Constructor.
ECIFrame(com.irurueta.units.Distance positionX, com.irurueta.units.Distance positionY, com.irurueta.units.Distance positionZ, com.irurueta.units.Speed speedX, com.irurueta.units.Speed speedY, com.irurueta.units.Speed speedZ, CoordinateTransformation c)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected Object	clone()	Makes a copy of this instance.
CoordinateTransformation	getCoordinateTransformation()	Gets coordinate transformation matrix.
void	getCoordinateTransformation(CoordinateTransformation result)	Gets coordinate transformation matrix.
static boolean	isValidCoordinateTransformation(CoordinateTransformation c)	Checks whether provided coordinate transformation is valid or not.
void	setCoordinateTransformation(CoordinateTransformation c)	Sets coordinate transformation matrix.

Methods inherited from class com.irurueta.navigation.frames.ECIorECEFFrame

copyFrom, copyTo, equals, equals, getCoordinateTransformationMatrix, getCoordinateTransformationMatrix, getCoordinateTransformationRotation, getCoordinateTransformationRotation, getPosition, getPosition, getPositionNorm, getPositionNormAsDistance, getPositionNormAsDistance, getPositionX, getPositionX, getPositionY, getPositionY, getPositionZ, getPositionZ, getSpeedX, getSpeedX, getSpeedY, getSpeedY, getSpeedZ, getSpeedZ, getVelocityNorm, getVelocityNormAsSpeed, getVelocityNormAsSpeed, getVx, getVy, getVz, getX, getY, getZ, hashCode, setCoordinates, setCoordinateTransformationMatrix, setCoordinateTransformationMatrix, setCoordinateTransformationRotation, setPosition, setPositionCoordinates, setPositionX, setPositionY, setPositionZ, setSpeedCoordinates, setSpeedX, setSpeedY, setSpeedZ, setVelocityCoordinates, setVx, setVy, setVz, setX, setY, setZ

Methods inherited from class java.lang.Object

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

Constructor Details

ECIFrame

public ECIFrame()

Constructor. Initializes position and velocity coordinates to zero and the coordinate transformation matrix to the identity.

ECIFrame

public ECIFrame(CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(double x,
 double y,
 double z)

Constructor.

Parameters:

x - cartesian x coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

y - cartesian y coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

z - cartesian z coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

ECIFrame

public ECIFrame(com.irurueta.geometry.Point3D position)

Constructor.

Parameters:

position - body position expressed in meters (m) and resolved along ECI-frame axes.

ECIFrame

public ECIFrame(com.irurueta.units.Distance positionX,
 com.irurueta.units.Distance positionY,
 com.irurueta.units.Distance positionZ)

Constructor.

Parameters:

positionX - cartesian x coordinate of body position to be set resolved along ECI-frame axes.

positionY - cartesian y coordinate of body position to be set resolved along ECI-frame axes.

positionZ - cartesian z coordinate of body position to be set resolved along ECI-frame axes.

ECIFrame

public ECIFrame(double x,
 double y,
 double z,
 double vx,
 double vy,
 double vz)

Constructor.

Parameters:

x - cartesian x coordinate of body position expressed in meters (m) and resolved along ECI-frame axes.

y - cartesian y coordinate of body position expressed in meters (m) and resolved along ECI-frame axes.

z - cartesian z coordinate of body position expressed in meters (m) and resolved along ECI-frame axes.

vx - x coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vy - y coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vz - z coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

ECIFrame

public ECIFrame(com.irurueta.geometry.Point3D position,
 double vx,
 double vy,
 double vz)

Constructor.

Parameters:

position - body position expressed in meters (m) and resolved along ECI-frame axes.

vx - x coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vy - y coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vz - z coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

ECIFrame

public ECIFrame(com.irurueta.geometry.Point3D position,
 com.irurueta.units.Speed speedX,
 com.irurueta.units.Speed speedY,
 com.irurueta.units.Speed speedZ)

Constructor.

Parameters:

position - body position expressed in meters (m) and resolved along ECI-frame axes.

speedX - x coordinate of velocity to be set resolved along ECI-frame axes.

speedY - y coordinate of velocity to be set resolved along ECI-frame axes.

speedZ - z coordinate of velocity to be set resolved along ECI-frame axes.

ECIFrame

public ECIFrame(double x,
 double y,
 double z,
 com.irurueta.units.Speed speedX,
 com.irurueta.units.Speed speedY,
 com.irurueta.units.Speed speedZ)

Constructor.

Parameters:

x - cartesian x coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

y - cartesian y coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

z - cartesian z coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

speedX - x coordinate of velocity to be set resolved along ECI-frame axes.

speedY - y coordinate of velocity to be set resolved along ECI-frame axes.

speedZ - z coordinate of velocity to be set resolved along ECI-frame axes.

ECIFrame

public ECIFrame(com.irurueta.units.Distance positionX,
 com.irurueta.units.Distance positionY,
 com.irurueta.units.Distance positionZ,
 double vx,
 double vy,
 double vz)

Constructor.

Parameters:

positionX - cartesian x coordinate of body position to be set, resolved along ECI-frame axes.

positionY - cartesian y coordinate of body position to be set, resolved along ECI-frame axes.

positionZ - cartesian z coordinate of body position to be set, resolved along ECI-frame axes.

vx - x coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vy - y coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vz - z coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

ECIFrame

public ECIFrame(com.irurueta.units.Distance positionX,
 com.irurueta.units.Distance positionY,
 com.irurueta.units.Distance positionZ,
 com.irurueta.units.Speed speedX,
 com.irurueta.units.Speed speedY,
 com.irurueta.units.Speed speedZ)

Constructor.

Parameters:

positionX - cartesian x coordinate of body position to be set, resolved along ECI-frame axes.

positionY - cartesian y coordinate of body position to be set, resolved along ECI-frame axes.

positionZ - cartesian z coordinate of body position to be set, resolved along ECI-frame axes.

speedX - x coordinate of velocity to be set, resolved along ECI-frame axes.

speedY - y coordinate of velocity to be set, resolved along ECI-frame axes.

speedZ - z coordinate of velocity to be set, resolved along ECI-frame axes.

ECIFrame

public ECIFrame(double x,
 double y,
 double z,
 CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

x - cartesian x coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

y - cartesian y coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

z - cartesian z coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(com.irurueta.geometry.Point3D position,
 CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

position - body position expressed in meters (m) and resolved along ECI-frame axes.

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(com.irurueta.units.Distance positionX,
 com.irurueta.units.Distance positionY,
 com.irurueta.units.Distance positionZ,
 CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

positionX - cartesian x coordinate of body position to be set, resolved along ECI-frame axes.

positionY - cartesian y coordinate of body position to be set, resolved along ECI-frame axes.

positionZ - cartesian z coordinate of body position to be set, resolved along ECI-frame axes.

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(double x,
 double y,
 double z,
 double vx,
 double vy,
 double vz,
 CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

x - cartesian x coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

y - cartesian y coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

z - cartesian z coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

vx - x coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vy - y coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vz - z coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(com.irurueta.geometry.Point3D position,
 double vx,
 double vy,
 double vz,
 CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

position - body position expressed in meters (m) and resolved along ECI-frame axes.

vx - x coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vy - y coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vz - z coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(com.irurueta.geometry.Point3D position,
 com.irurueta.units.Speed speedX,
 com.irurueta.units.Speed speedY,
 com.irurueta.units.Speed speedZ,
 CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

position - body position expressed in meters (m) and resolved along ECI-frame axes.

speedX - x coordinate of velocity to be set, resolved along ECI-frame axes.

speedY - y coordinate of velocity to be set, resolved along ECI-frame axes.

speedZ - z coordinate of velocity to be set, resolved along ECI-frame axes.

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(double x,
 double y,
 double z,
 com.irurueta.units.Speed speedX,
 com.irurueta.units.Speed speedY,
 com.irurueta.units.Speed speedZ,
 CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

x - cartesian x coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

y - cartesian y coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

z - cartesian z coordinate of body position expressed in meters (m) with respect ECI frame, resolved along ECI-frame axes.

speedX - x coordinate of velocity to be set, resolved along ECI-frame axes.

speedY - y coordinate of velocity to be set, resolved along ECI-frame axes.

speedZ - z coordinate of velocity to be set, resolved along ECI-frame axes.

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(com.irurueta.units.Distance positionX,
 com.irurueta.units.Distance positionY,
 com.irurueta.units.Distance positionZ,
 double vx,
 double vy,
 double vz,
 CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

positionX - cartesian x coordinate of body position to be set, resolved along ECI-frame axes.

positionY - cartesian y coordinate of body position to be set, resolved along ECI-frame axes.

positionZ - cartesian z coordinate of body position to be set, resolved along ECI-frame axes.

vx - x coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vy - y coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

vz - z coordinate of velocity of body frame expressed in meters per second (m/s) and resolved along ECI-frame axes.

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(com.irurueta.units.Distance positionX,
 com.irurueta.units.Distance positionY,
 com.irurueta.units.Distance positionZ,
 com.irurueta.units.Speed speedX,
 com.irurueta.units.Speed speedY,
 com.irurueta.units.Speed speedZ,
 CoordinateTransformation c)
         throws InvalidSourceAndDestinationFrameTypeException

Constructor.

Parameters:

positionX - cartesian x coordinate of body position to be set, resolved along ECI-frame axes.

positionY - cartesian y coordinate of body position to be set, resolved along ECI-frame axes.

positionZ - cartesian z coordinate of body position to be set, resolved along ECI-frame axes.

speedX - x coordinate of velocity to be set, resolved along ECI-frame axes.

speedY - y coordinate of velocity to be set, resolved along ECI-frame axes.

speedZ - z coordinate of velocity to be set, resolved along ECI-frame axes.

c - Body to ECI coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

ECIFrame

public ECIFrame(ECIFrame input)

Constructor.

Parameters:

input - ECI frame to copy data from.

Method Details

getCoordinateTransformation

public CoordinateTransformation getCoordinateTransformation()

Gets coordinate transformation matrix.

Specified by:

getCoordinateTransformation in interface Frame

Returns:

coordinate transformation matrix.

getCoordinateTransformation

public void getCoordinateTransformation(CoordinateTransformation result)

Gets coordinate transformation matrix.

Specified by:

getCoordinateTransformation in interface Frame

Parameters:

result - instance where coordinate transformation matrix will be copied to.

setCoordinateTransformation

public void setCoordinateTransformation(CoordinateTransformation c)
                                 throws InvalidSourceAndDestinationFrameTypeException

Sets coordinate transformation matrix. Provided value must be a body to ECI transformation matrix.

Specified by:

setCoordinateTransformation in interface Frame

Parameters:

c - coordinate transformation matrix to be set.

Throws:

InvalidSourceAndDestinationFrameTypeException - if source or destination frame types are invalid.

isValidCoordinateTransformation

public static boolean isValidCoordinateTransformation(CoordinateTransformation c)

Checks whether provided coordinate transformation is valid or not. Only body to ECI transformation matrices are considered to be valid.

Parameters:

c - coordinate transformation matrix to be checked.

Returns:

true if provided value is valid, false otherwise.

clone

protected Object clone()
                throws CloneNotSupportedException

Makes a copy of this instance.

Overrides:

clone in class Object

Returns:

a copy of this instance.

Throws:

CloneNotSupportedException - if clone fails for some reason.