faa.tg.vector
Class NED_VelocityVector

java.lang.Object
  faa.tg.vector.Tg3dVector<Speed,Speed,Speed,Speed>
      faa.tg.vector.VelocityVector
          faa.tg.vector.NED_VelocityVector

All Implemented Interfaces:

Immutable, java.io.Serializable

public class NED_VelocityVector
extends VelocityVector
implements Immutable

 An NED_VelocityVector represents a velocity by containing the x,y,z 
 Speed components in the North-East-Down rectangular coordinate
 frame.
 The North-East-Down frame is a coordinate system where x describes
 north/south, y describes east/west, and z describes down/up.  It is a
 rectangular coordinate frame that rotates as the subject travels to keep
 the Z axis aligned with down/up; therefore, it simulates a flat map.
 

See the source: NED_VelocityVector.java

Version:

$Id: NED_VelocityVector.java,v 3.6 2008/12/12 20:25:49 danaw Exp $

Author:

Michael Capito, Dana N. Whicker, TGF/L-3 Titan Corp

See Also:

Speed, Serialized Form

Field Summary

static java.lang.String	CVS_VERSION_ID The CVS Version ID
(package private) static long	serialVersionUID

Fields inherited from class faa.tg.vector.Tg3dVector

component1, component2, component3, magnitude

Constructor Summary

NED_VelocityVector(DIS_VelocityVector dis, Position pos)
Method to calculate the aircraft's velocity in the NED frame.

NED_VelocityVector(GroundTrackHeading gtHeading, GroundTrackSpeed gtSpeed, AltitudeRate altRate)
Constructs a new NED_VelocityVector using a ground track heading, a ground track speed, and an altitude rate.

NED_VelocityVector(PositionSimTime start, PositionSimTime end)
Constructs a new NED_VelocityVector using two 4D points.

NED_VelocityVector(Speed xComponent_North, Speed yComponent_East, Speed zComponent_Down)
Constructs a new NED_VelocityVector; represents the object for measuring speed using the north-east-down frame: it contains x, y, and z components.

Method Summary

private static Speed	calcX(PositionSimTime start, PositionSimTime end) Calculates the x component of the NED_VelocityVector from two 4D points.
private static Speed	calcY(PositionSimTime start, PositionSimTime end) Calculates the y component of the NED_VelocityVector from two 4D points.
private static Speed	calcZ(PositionSimTime start, PositionSimTime end) Calculates the z component of the NED_VelocityVector from two 4D points.
AltitudeRate	getAltitudeRate() Returns the altitude rate (in this case, the negative of the down vector).
FlightPathAngle	getFlightPathAngle() Returns the flight path angle relative to the plane that is tangent to the surface of the Earth directly under the aircraft.
GroundTrackHeading	getGroundTrackHeading() Returns the ground track heading (in this case, the combination of the north and east vectors).
GroundTrackSpeed	getGroundTrackSpeed() Returns the ground track speed for this velocity vector.
Angle	interceptAngle(NED_VelocityVector otherNED) Returns the intercept angle of this NED_VelocityVector and the specified NED_VelocityVector: assumes that the velocity vectors are coplanar.
static NED_VelocityVector	newNED(TrueAirspeed updatedTrueAirspeed, FlightPathRelAirAngle updatedFlightPathAngle, TrueHeading updatedAircraftHeading, LocalWind localWind) Constructs and returns an NED_VelocityVector after calculating the speed parameters.
java.lang.String	toDraText() Return the output text String representation of this object.
java.lang.String	toString() Returns a string representation of this object

Methods inherited from class faa.tg.vector.VelocityVector

calcMagnitude, getMagnitude, getXComponent, getYComponent, getZComponent

Methods inherited from class faa.tg.vector.Tg3dVector

getComponent1, getComponent2, getComponent3

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

static final long serialVersionUID

See Also:

Constant Field Values

CVS_VERSION_ID

public static final java.lang.String CVS_VERSION_ID

The CVS Version ID

See Also:

Constant Field Values

Constructor Detail

NED_VelocityVector

public NED_VelocityVector(DIS_VelocityVector dis,
                          Position pos)

Method to calculate the aircraft's velocity in the NED frame. Does not currently account for an elliptical Earth--assumes geodetic latitude is the same as the geocentric latitude. See The Engineering Analysis and Design of the Aircraft Dynamics Model For the FAA Target Generation Facility equations (2.83) and (2.125)

Parameters:

dis - The DIS velocity vector to construct the new NED from.

pos - The position of the aircraft.

See Also:

NED_VelocityVector

NED_VelocityVector

public NED_VelocityVector(PositionSimTime start,
                          PositionSimTime end)

Constructs a new NED_VelocityVector using two 4D points.

Parameters:

start - The starting position and time.

end - The ending position and time.

NED_VelocityVector

public NED_VelocityVector(GroundTrackHeading gtHeading,
                          GroundTrackSpeed gtSpeed,
                          AltitudeRate altRate)

Constructs a new NED_VelocityVector using a ground track heading, a ground track speed, and an altitude rate.

Parameters:

gtHeading - The ground track heading.

gtSpeed - The ground track speed.

altRate - The altitude rate.

NED_VelocityVector

public NED_VelocityVector(Speed xComponent_North,
                          Speed yComponent_East,
                          Speed zComponent_Down)

Constructs a new NED_VelocityVector; represents the object for measuring speed using the north-east-down frame: it contains x, y, and z components. Each Speed has a magnitude and represents one direction. The North-East-Down frame is a coordinate system where x describes north/south, y describes east/west, and z describes down/up.

Parameters:

xComponent_North - The North component (South if negative).

yComponent_East - The East component (West if negative).

zComponent_Down - The Down component (Up if negative).

Method Detail

newNED

public static NED_VelocityVector newNED(TrueAirspeed updatedTrueAirspeed,
                                        FlightPathRelAirAngle updatedFlightPathAngle,
                                        TrueHeading updatedAircraftHeading,
                                        LocalWind localWind)

Constructs and returns an NED_VelocityVector after calculating the speed parameters.

Parameters:

updatedTrueAirspeed - The updated true airspeed of the aircraft.

updatedFlightPathAngle - Updated flight path angle of the aircraft.

updatedAircraftHeading - Updated true heading of the aircraft.

Returns:

The newly calculated velocity vector.

toDraText

public java.lang.String toDraText()

Return the output text String representation of this object.

Returns:

The output text String representation of this Object.

interceptAngle

public Angle interceptAngle(NED_VelocityVector otherNED)

Returns the intercept angle of this NED_VelocityVector and the specified NED_VelocityVector: assumes that the velocity vectors are coplanar.

getGroundTrackHeading

public GroundTrackHeading getGroundTrackHeading()

Returns the ground track heading (in this case, the combination of the north and east vectors).

getGroundTrackSpeed

public GroundTrackSpeed getGroundTrackSpeed()

Returns the ground track speed for this velocity vector.

getAltitudeRate

public AltitudeRate getAltitudeRate()

Returns the altitude rate (in this case, the negative of the down vector).

getFlightPathAngle

public FlightPathAngle getFlightPathAngle()

Returns the flight path angle relative to the plane that is tangent to the surface of the Earth directly under the aircraft.

calcX

private static Speed calcX(PositionSimTime start,
                           PositionSimTime end)

Calculates the x component of the NED_VelocityVector from two 4D points.

Parameters:

start - The starting position and time as a 4D point.

end - The ending position and time as a 4D point.

calcY

private static Speed calcY(PositionSimTime start,
                           PositionSimTime end)

Calculates the y component of the NED_VelocityVector from two 4D points.

Parameters:

start - The starting position and time as a 4D point.

end - The ending position and time as a 4D point.

calcZ

private static Speed calcZ(PositionSimTime start,
                           PositionSimTime end)

Calculates the z component of the NED_VelocityVector from two 4D points.

Parameters:

start - The starting position and time as a 4D point.

end - The ending position and time as a 4D point.

toString

public java.lang.String toString()

Returns a string representation of this object

Overrides:

toString in class java.lang.Object

Returns:

this object as a String