Conversions

Conversions

DIS Blueprint Function Library. Houses functions for common geospatial conversions and for common PDU accessor functions.

public class Conversions

Includes

• GlmSharp
• OpenDis.Dis1998
• System
• UnityEngine

Back to Top

---

Functions

Access		Return	Name	Description
Public	Static	void	ApplyHeadingPitchRollToNorthEastDownVector(FHeadingPitchRoll HeadingPitchRollDegrees, FNorthEastDown NorthEastDownVectors, out Vector3 outX, out Vector3 outY, out Vector3 outZ)	Applies the given heading, pitch, and roll in degrees to the local East North Down vectors
Private	Static	void	ApplyHeadingPitchToNorthEastDownVector(double headingDegrees, double pitchDegrees, FNorthEastDown NorthEastDownVectors, out Vector3 outX, out Vector3 outY, out Vector3 outZ)	Rotates the given East, North, and Up vectors by the given Heading and Pitch
Private	Static	void	ApplyRollToNorthEastDownVector(double rollDegrees, FNorthEastDown NorthEastDownVectors, out Vector3 outX, out Vector3 outY, out Vector3 outZ)	Rotates the given East, North, and Up vectors by the given Heading and Pitch
Public	Static	Vector3Double	CalculateEcefXYZFromLatLonHeight(FLatLonAlt latLonHeightDegreesMeters)	Converts Latitude, Longitude, and Height (LLH) to DIS X, Y, Z coordinates (ECEF) all in double (64-bit) precision
Public	Static	FHeadingPitchRoll	CalculateHeadingPitchRollDegreesFromPsiThetaPhiDegreesAtLatLon(FPsiThetaPhi psiThetaPhiDegrees, FLatLonAlt latLonAlt)	Calculates the Heading, Pitch, and Roll in degrees from the given DIS orientation values Psi, Theta, and Phi in degrees at the given Latitude and Longitude
Public	Static	FHeadingPitchRoll	CalculateHeadingPitchRollDegreesFromPsiThetaPhiRadiansAtLatLon(FPsiThetaPhi psiThetaPhiRadians, FLatLonAlt latLonAlt)	Calculates the Heading, Pitch, and Roll in degrees from the given DIS orientation values Psi, Theta, and Phi in radians at the given Latitude and Longitude
Public	Static	FHeadingPitchRoll	CalculateHeadingPitchRollRadiansFromPsiThetaPhiDegreesAtLatLon(FPsiThetaPhi psiThetaPhiDegrees, FLatLonAlt latLonAlt)	Calculates the Heading, Pitch, and Roll in radians from the given DIS orientation values Psi, Theta, and Phi in degrees at the given Latitude and Longitude
Public	Static	FHeadingPitchRoll	CalculateHeadingPitchRollRadiansFromPsiThetaPhiRadiansAtLatLon(FPsiThetaPhi psiThetaPhiRadians, FLatLonAlt latLonAlt)	Calculates the Heading, Pitch, and Roll in radians from the given DIS orientation values Psi, Theta, and Phi in radians at the given Latitude and Longitude
Public	Static	void	CalculateLatLonFromNorthEastDownVectors(FNorthEastDown NorthEastDownVectors, out double latitudeDegrees, out double longitudeDegrees)	Calculates the latitude and longitude at the given East, North, and Up vectors
Public	Static	bool	CalculateLatLonHeightFromEcefXYZ(Vector3Double ecefLocation, out FLatLonAlt latLonAltLocation)	Converts DIS X, Y, Z coordinates (ECEF) to Latitude, Longitude, and Height (LLH) all in double (64-bit) precision
Public	Static	FNorthEastDown	CalculateNorthEastDownVectorsFromLatLon(FLatLonAlt latLonAlt)	Calculates the East, North, and Up vectors at given latitude and longitude
Public	Static	FPsiThetaPhi	CalculatePsiThetaPhiDegreesFromHeadingPitchRollDegreesAtLatLon(FHeadingPitchRoll HeadingPitchRollDegrees, FLatLonAlt latLonAlt)	Calculates the DIS orientation values Psi, Theta, and Phi in degrees with the given Heading, Pitch, and Roll in degrees at the given Latitude and Longitude
Public	Static	FPsiThetaPhi	CalculatePsiThetaPhiDegreesFromHeadingPitchRollRadiansAtLatLon(FHeadingPitchRoll HeadingPitchRollRadians, FLatLonAlt latLonAlt)	Calculates the DIS orientation values Psi, Theta, and Phi in degrees with the given Heading, Pitch, and Roll in radians at the given Latitude and Longitude
Public	Static	FPsiThetaPhi	CalculatePsiThetaPhiRadiansFromHeadingPitchRollDegreesAtLatLon(FHeadingPitchRoll HeadingPitchRollDegrees, FLatLonAlt latLonAlt)	Calculates the DIS orientation values Psi, Theta, and Phi in radians with the given Heading, Pitch, and Roll in degrees at the given Latitude and Longitude
Public	Static	FPsiThetaPhi	CalculatePsiThetaPhiRadiansFromHeadingPitchRollRadiansAtLatLon(FHeadingPitchRoll HeadingPitchRollRadians, FLatLonAlt latLonAlt)	Calculates the DIS orientation values Psi, Theta, and Phi in radians with the given Heading, Pitch, and Roll in radians at the given Latitude and Longitude
Public	Static	dmat4	CreateRotationMatrix(Vector3 AxisVector, double thetaRadians)	Creates a 4x4 rotation matrix around the given axis of rotation rotating by Theta radians
Public	Static	dmat3	CreateRotationMatrix(dvec3 AxisVector, double ThetaRadians)	Creates a 3x3 rotation matrix around the given axis of rotation rotating by Theta radians
Public	Static	dmat3	CreateSkewMatrix(dvec3 nVector)	Creates a 3x3 n^x matrix used for creating a rotation matrix
Public	Static	dmat4	CreateSkewMatrix4x4(Vector3 nVector)	Creates a 4x4 n^x matrix used for creating a rotation matrix
Public	Static	FEastNorthUp	GetEastNorthUpVectorsFromNorthEastDownVectors(FNorthEastDown NorthEastDownVectors)	Get the East, North, and Up vectors from the North, East, and Down vector struct
Public	Static	void	GetEcefXYZAndPsiThetaPhiDegreesFromUnity(Vector3 UnityRotation, Vector3 UnityLocation, GeoreferenceSystem GeoReferencingSystem, out Vector3Double EcefXYZ, out FPsiThetaPhi PsiThetaPhiDegrees, Vector3 OriginRebasingOffset)	Gets the ECEF location and the Psi (Yaw), Theta (Pitch), and Phi (Roll) in degrees of the given Unity rotation at the given Unity location
Public	Static	void	GetEcefXYZAndPsiThetaPhiRadiansFromUnity(Vector3 UnityRotation, Vector3 UnityLocation, GeoreferenceSystem GeoReferencingSystem, out Vector3Double EcefXYZ, out FPsiThetaPhi PsiThetaPhiRadians, Vector3 OriginRebasingOffset)	Gets the ECEF location and the Psi (Yaw), Theta (Pitch), and Phi (Roll) in radians of the given Unity rotation at the given Unity location
Public	Static	FHeadingPitchRoll	GetHeadingPitchRollFromUnityRotation(Vector3 UnityRotation, Vector3 UnityLocation, GeoreferenceSystem GeoReferencingSystem)	Gets the Heading, Pitch, and Roll in degrees of the given Unity rotation at the given Unity location
Public	Static	void	GetNEDVectorRotationOffset(FNorthEastDown StartNEDVectors, FNorthEastDown DestinationNEDVectors, out double RollOffset, out double PitchOffset, out double YawOffset)	Gets the rotational offset between the two given NED vectors
Public	Static	FNorthEastDown	GetNorthEastDownVectorsFromEastNorthUpVectors(FEastNorthUp EastNorthUpVectors)	Get the North, East, and Down vectors from the East, North, and Up vector struct
Public	Static	FPsiThetaPhi	GetPsiThetaPhiDegreesFromUnityRotation(Vector3 UnityRotation, Vector3 UnityLocation, GeoreferenceSystem GeoReferencingSystem, Vector3 OriginRebasingOffset)	Gets the Psi (Yaw), Theta (Pitch), and Phi (Roll) in degrees of the given Unity rotation at the given Unity location
Public	Static	FPsiThetaPhi	GetPsiThetaPhiRadiansFromUnityRotation(Vector3 UnityRotation, Vector3 UnityLocation, GeoreferenceSystem GeoReferencingSystem, Vector3 OriginRebasingOffset)	Gets the Psi (Yaw), Theta (Pitch), and Phi (Roll) in radians of the given Unity rotation at the given Unity location
Public	Static	void	GetUnityLocationAndOrientationFromEntityStatePdu(EntityStatePdu EntityStatePdu, GeoreferenceSystem GeoReferencingSystem, out Vector3 UnityLocation, out Vector3 UnityRotation, Vector3 OriginRebasingOffset)	Gets the Unity X, Y, Z coordinates and rotation from a DIS entity state PDU. Location values returned change depending on if GeoReferencing System is set to Flat Earth or Round Earth.
Public	Static	Vector3	GetUnityRotationFromEntityStatePdu(EntityStatePdu EntityStatePduIn, GeoreferenceSystem GeoReferencingSystem)	Gets Unity rotation from a DIS entity state PDU
Public	Static	Vector3	GetUnityRotationFromHeadingPitchRollDegreesAtLatLon(FHeadingPitchRoll HeadingPitchRollDegrees, FLatLonAlt latLonAlt, GeoreferenceSystem GeoReferencingSystem)	Get the Unity rotation from the given Heading, Pitch, Roll rotation in degrees
Public	Static	Vector3	GetUnityRotationFromHeadingPitchRollRadiansAtLatLon(FHeadingPitchRoll HeadingPitchRollRadians, FLatLonAlt latLonAlt, GeoreferenceSystem GeoReferencingSystem)	Get the Unity rotation from the given Heading, Pitch, Roll rotation in radians
Public	Static	Vector3	GetUnityRotationFromPsiThetaPhiDegreesAtLatLon(FPsiThetaPhi PsiThetaPhiDegrees, FLatLonAlt latLonAlt, GeoreferenceSystem GeoReferencingSystem)	Get the Unity rotation from the given Psi, Theta, Phi rotation in degrees
Public	Static	Vector3	GetUnityRotationFromPsiThetaPhiRadiansAtLatLon(FPsiThetaPhi PsiThetaPhiRadians, FLatLonAlt latLonAlt, GeoreferenceSystem GeoReferencingSystem)	Get the Unity rotation from the given Psi, Theta, Phi rotation in radians
Public	Static	Vector3	RotateVectorAroundAxisByDegrees(Vector3 vectorToRotate, double thetaRadians, Vector3 axisVector)	Rotates the vector VectorToRotate around given axis AxisVector by Theta degrees
Public	Static	dvec3	RotateVectorAroundAxisByDegrees(dvec3 vectorToRotate, double thetaRadians, dvec3 axisVector)	Rotates the vector VectorToRotate around given axis AxisVector by Theta degrees
Public	Static	Vector3	RotateVectorAroundAxisByRadians(Vector3 vectorToRotate, double thetaRadians, Vector3 axisVector)	Rotates the vector VectorToRotate around given axis AxisVector by Theta radians
Public	Static	dvec3	RotateVectorAroundAxisByRadians(dvec3 vectorToRotate, double thetaRadians, dvec3 axisVector)	Rotates the vector VectorToRotate around given axis AxisVector by Theta radians
Public	Static	Vector3	UnwindRotation(Vector3 RotationDegrees)	Takes in a rotation in degrees and finds the shortest route along each axis. (ex: [348, -181, 89] becomes [-12, 179, 89]).

Back to Top

---

Details

ApplyHeadingPitchRollToNorthEastDownVector

public static void ApplyHeadingPitchRollToNorthEastDownVector
(
    FHeadingPitchRoll HeadingPitchRollDegrees,
    FNorthEastDown NorthEastDownVectors,
    out Vector3 outX,
    out Vector3 outY,
    out Vector3 outZ)

Applies the given heading, pitch, and roll in degrees to the local East North Down vectors.

Parameter	Description
HeadingPitchRollDegrees	The degrees from North of the facing direction (heading), the degrees rotated about the local Y axis (pitch), and the degrees rotated about the local X axis (roll)
NorthEastDownVectors	The vectors pointing to the North, to the East, and toward the center of the Earth
outX	The x axis (forward) vector with the heading and pitch applied
outY	The y axis (right) vector with the heading and pitch applied
outZ	The z axis (down) vector with the heading and pitch applied

Back to Top

---

ApplyHeadingPitchToNorthEastDownVector

public static void ApplyHeadingPitchToNorthEastDownVector(
    double headingDegrees,
    double pitchDegrees,
    FNorthEastDown NorthEastDownVectors,
    out Vector3 outX,
    out Vector3 outY,
    out Vector3 outZ
)

Rotates the given East, North, and Up vectors by the given Heading and Pitch.

Parameter	Description
headingDegrees	The degrees from North of the facing direction (spin left and right)
pitchDegrees	The degrees rotated about the local Y axis (front tip up and down)
NorthEastDownVectors	The vectors pointing to the North, to the East, and toward the center of the Earth
outX	The x axis (forward) vector with the heading and pitch applied
outY	The y axis (right) vector with the heading and pitch applied
outZ	the z axis (up) vector with the heading and pitch applied

Back to Top

---

ApplyRollToNorthEastDownVector

public static void ApplyRollToNorthEastDownVector
(
    double rollDegrees,
    FNorthEastDown NorthEastDownVectors,
    out Vector3 outX,
    out Vector3 outY,
    out Vector3 outZ
)

Rotates the given East, North, and Up vectors by the given Heading and Pitch.

Parameter	Description
rollDegrees	The degrees rotated about the local X axis (tilt left and right)
NorthEastDownVectors	The vectors pointing to the North, to the East, and toward the center of the Earth
outX	The x axis (forward) vector with the heading and pitch applied
outY	The y axis (right) vector with the heading and pitch applied
outZ	the z axis (up) vector with the heading and pitch applied

Back to Top

---

CalculateEcefXYZFromLatLonHeight

public static Vector3Double CalculateEcefXYZFromLatLonHeight
(
    FLatLonAlt latLonHeightDegreesMeters
)

Converts Latitude, Longitude, and Height (LLH) to DIS X, Y, Z coordinates (ECEF) all in double (64-bit) precision.

Parameter	Description
LatLonHeightDegreesMeters	The latitude in degrees, longitude in degrees, and height in meters

Returns
The converted ECEF location

Back to Top

---

CalculateHeadingPitchRollDegreesFromPsiThetaPhiDegreesAtLatLon

public static FHeadingPitchRoll CalculateHeadingPitchRollDegreesFromPsiThetaPhiDegreesAtLatLon
(
    FPsiThetaPhi psiThetaPhiDegrees,
    FLatLonAlt latLonAlt
)

Calculates the Heading, Pitch, and Roll in degrees from the given DIS orientation values Psi, Theta, and Phi in degrees at the given Latitude and Longitude.

Parameter	Description
psiThetaPhiDegrees	The rotation about the Z axis in degrees (Psi),the rotation about the Y axis in degrees (Theta), the rotation about the X axis in degrees (Phi)
latLonAlt	The target latitude, longitude, and altitude given in degrees

Returns
The degrees from North of the facing direction (heading), the degrees rotated about the local Y axis (pitch), and the degrees rotated about the local X axis (roll)

Back to Top

---

CalculateHeadingPitchRollDegreesFromPsiThetaPhiRadiansAtLatLon

public static FHeadingPitchRoll CalculateHeadingPitchRollDegreesFromPsiThetaPhiRadiansAtLatLon
(
    FPsiThetaPhi psiThetaPhiRadians,
    FLatLonAlt latLonAlt
)

Calculates the Heading, Pitch, and Roll in degrees from the given DIS orientation values Psi, Theta, and Phi in radians at the given Latitude and Longitude.

Parameter	Description
psiThetaPhiRadians	The rotation about the Z axis in radians (Psi),the rotation about the Y axis in radians (Theta), the rotation about the X axis in radians (Phi)
latLonAlt	The target latitude, longitude, and altitude given in degrees

Returns
The degrees from North of the facing direction (heading), the degrees rotated about the local Y axis (pitch), and the degrees rotated about the local X axis (roll)

Back to Top

---

CalculateHeadingPitchRollRadiansFromPsiThetaPhiDegreesAtLatLon

public static FHeadingPitchRoll CalculateHeadingPitchRollRadiansFromPsiThetaPhiDegreesAtLatLon
(
    FPsiThetaPhi psiThetaPhiDegrees,
    FLatLonAlt latLonAlt
)

Calculates the Heading, Pitch, and Roll in radians from the given DIS orientation values Psi, Theta, and Phi in degrees at the given Latitude and Longitude.

Parameter	Description
psiThetaPhiDegrees	The rotation about the Z axis in degrees (Psi),the rotation about the Y axis in degrees (Theta), the rotation about the X axis in degrees (Phi)
latLonAlt	The target latitude, longitude, and altitude given in degrees

Returns
The radians from North of the facing direction (heading), the radians rotated about the local Y axis (pitch), and the radians rotated about the local X axis (roll)

Back to Top

---

CalculateHeadingPitchRollRadiansFromPsiThetaPhiRadiansAtLatLon

public static FHeadingPitchRoll CalculateHeadingPitchRollRadiansFromPsiThetaPhiRadiansAtLatLon
(
    FPsiThetaPhi psiThetaPhiRadians,
    FLatLonAlt latLonAlt
)

Calculates the Heading, Pitch, and Roll in radians from the given DIS orientation values Psi, Theta, and Phi in radians at the given Latitude and Longitude.

Parameter	Description
psiThetaPhiRadians	The rotation about the Z axis in radians (Psi),the rotation about the Y axis in radians (Theta), the rotation about the X axis in radians (Phi)
latLonAlt	The target latitude, longitude, and altitude given in degrees

Returns
The radians from North of the facing direction (heading), the radians rotated about the local Y axis (pitch), and the radians rotated about the local X axis (roll)

Back to Top

---

CalculateLatLonFromNorthEastDownVectors

public static void CalculateLatLonFromNorthEastDownVectors
(
    FNorthEastDown NorthEastDownVectors,
    out double latitudeDegrees,
    out double longitudeDegrees
)

Calculates the latitude and longitude at the given East, North, and Up vectors.

Parameter	Description
NorthEastDownVectors	The vectors pointing to the North, to the East, and toward the center of the Earth
latitudeDegrees	The target latitude given in degrees
longitudeDegrees	The target longitude given in degrees

Back to Top

---

CalculateLatLonHeightFromEcefXYZ

public static bool CalculateLatLonHeightFromEcefXYZ
(
    Vector3Double ecefLocation,
    out FLatLonAlt latLonAltLocation
)

Converts DIS X, Y, Z coordinates (ECEF) to Latitude, Longitude, and Height (LLH) all in double (64-bit) precision.

Parameter	Description
ecefLocation	The ECEF location
latLonAltLocation	The converted latitude in degrees, longitude in degrees, and altitude in meters

Returns
Whether or not the calculation was successful. Will only be unsuccessful if the given ECEF coordinates result in a NaN calculation.

Back to Top

---

CalculateNorthEastDownVectorsFromLatLon

public static FNorthEastDown CalculateNorthEastDownVectorsFromLatLon
(
    FLatLonAlt latLonAlt
)

Calculates the East, North, and Up vectors at given latitude and longitude.

Parameter	Description
latLonAlt	The target latitude, longitude, and altitude given in degrees

Returns
The local vectors pointing North, pointing East, and toward the center of the Earth at the given latitude and longitude

Back to Top

---

CalculatePsiThetaPhiDegreesFromHeadingPitchRollDegreesAtLatLon

public static FPsiThetaPhi CalculatePsiThetaPhiDegreesFromHeadingPitchRollDegreesAtLatLon
(
    FHeadingPitchRoll HeadingPitchRollDegrees,
    FLatLonAlt latLonAlt
)

Calculates the DIS orientation values Psi, Theta, and Phi in degrees with the given Heading, Pitch, and Roll in degrees at the given Latitude and Longitude.

Parameter	Description
HeadingPitchRollDegrees	The degrees from North of the facing direction (heading), the degrees rotated about the local Y axis (pitch), and the degrees rotated about the local X axis (roll)
latLonAlt	The target latitude, longitude, and altitude given in degrees

Returns
The rotation about the Z axis in degrees (Psi),the rotation about the Y axis in degrees (Theta), the rotation about the X axis in degrees (Phi)

Back to Top

---

CalculatePsiThetaPhiDegreesFromHeadingPitchRollRadiansAtLatLon

public static FPsiThetaPhi CalculatePsiThetaPhiDegreesFromHeadingPitchRollRadiansAtLatLon
(
    FHeadingPitchRoll HeadingPitchRollRadians,
    FLatLonAlt latLonAlt
)

Calculates the DIS orientation values Psi, Theta, and Phi in degrees with the given Heading, Pitch, and Roll in radians at the given Latitude and Longitude.

Parameter	Description
HeadingPitchRollRadians	The radians from North of the facing direction (heading), the radians rotated about the local Y axis (pitch), and the radians rotated about the local X axis (roll)
latLonAlt	The target latitude, longitude, and altitude given in degrees

Returns
The rotation about the Z axis in degrees (Psi),the rotation about the Y axis in degrees (Theta), the rotation about the X axis in degrees (Phi)

Back to Top

---

CalculatePsiThetaPhiRadiansFromHeadingPitchRollDegreesAtLatLon

public static FPsiThetaPhi CalculatePsiThetaPhiRadiansFromHeadingPitchRollDegreesAtLatLon
(
    FHeadingPitchRoll HeadingPitchRollDegrees,
    FLatLonAlt latLonAlt
)

Calculates the DIS orientation values Psi, Theta, and Phi in radians with the given Heading, Pitch, and Roll in degrees at the given Latitude and Longitude.

Parameter	Description
HeadingPitchRollDegrees	The degrees from North of the facing direction (heading), the degrees rotated about the local Y axis (pitch), and the degrees rotated about the local X axis (roll)
latLonAlt	The target latitude, longitude, and altitude given in degrees

Returns
The rotation about the Z axis in radians (Psi),the rotation about the Y axis in radians (Theta), the rotation about the X axis in radians (Phi)

Back to Top

---

CalculatePsiThetaPhiRadiansFromHeadingPitchRollRadiansAtLatLon

public static FPsiThetaPhi CalculatePsiThetaPhiRadiansFromHeadingPitchRollRadiansAtLatLon
(
    FHeadingPitchRoll HeadingPitchRollRadians,
    FLatLonAlt latLonAlt
)

Calculates the DIS orientation values Psi, Theta, and Phi in radians with the given Heading, Pitch, and Roll in radians at the given Latitude and Longitude.

Parameter	Description
HeadingPitchRollRadians	The radians from North of the facing direction (heading), the radians rotated about the local Y axis (pitch), and the radians rotated about the local X axis (roll)
latLonAlt	The target latitude, longitude, and altitude given in degrees

Returns
The rotation about the Z axis in radians (Psi),the rotation about the Y axis in radians (Theta), the rotation about the X axis in radians (Phi)

Back to Top

---

CreateRotationMatrix

public static dmat4 CreateRotationMatrix
(
    Vector3 AxisVector,
    double thetaRadians
)

Creates a 4x4 rotation matrix around the given axis of rotation rotating by Theta radians.

Parameter	Description
AxisVector	A vector representing the axis of rotation
ThetaRadians	The amount to rotate given in radians

Returns
The resultant rotation matrix to rotate Theta radians around axis AxisVector

Back to Top

---

CreateRotationMatrix

public static dmat3 CreateRotationMatrix
(
    dvec3 AxisVector,
    double ThetaRadians
)

Creates a 3x3 rotation matrix around the given axis of rotation rotating by Theta radians.

Parameter	Description
AxisVector	A 3x1 vector representing the axis of rotation
ThetaRadians	The amount to rotate given in radians

Returns
The resultant rotation matrix to rotate Theta radians around axis AxisVector

Back to Top

---

CreateSkewMatrix

public static dmat3 CreateSkewMatrix
(
    dvec3 nVector
)

Creates a 3x3 n^x matrix used for creating a rotation matrix

Parameter	Description
nVector	A 3x1 vector representing the axis of rotation

Returns
A 3x3 n^x matrix used for creating a rotation matrix

Back to Top

---

CreateSkewMatrix4x4

public static dmat4 CreateSkewMatrix4x4
(
    dvec3 nVector
)

Creates a 4x4 n^x matrix used for creating a rotation matrix.

Parameter	Description
nVector	A 3x1 vector representing the axis of rotation

Returns
A 4x4 n^x matrix used for creating a rotation matrix

Back to Top

---

GetEastNorthUpVectorsFromNorthEastDownVectors

public static FEastNorthUp GetEastNorthUpVectorsFromNorthEastDownVectors
(
    FNorthEastDown NorthEastDownVectors
)

Get the East, North, and Up vectors from the North, East, and Down vector struct.

Parameter	Description
NorthEastDownVectors	The North, East, and Down vectors representing the current orientation

Returns
The resulting East, North, and Up vectors representing the current orientation

Back to Top

---

GetEcefXYZAndPsiThetaPhiDegreesFromUnity

public static void GetEcefXYZAndPsiThetaPhiDegreesFromUnity
(
    Vector3 UnityRotation,
    Vector3 UnityLocation,
    GeoreferenceSystem GeoReferencingSystem,
    out Vector3Double EcefXYZ,
    out FPsiThetaPhi PsiThetaPhiDegrees,
    Vector3 OriginRebasingOffset = default
)

Gets the ECEF location and the Psi (Yaw), Theta (Pitch), and Phi (Roll) in degrees of the given Unity rotation at the given Unity location.

Parameter	Description
UnityRotation	The Unity rotation in world space
UnityLocation	The Unity location in world space
GeoReferencingSystem	The GeoReferencing System reference
EcefXYZ	The ECEF location of the given Unity location
PsiThetaPhiDegrees	The Psi (Yaw), Theta (Pitch), and Phi (Roll) in degrees
OriginRebasingOffset	Any offset that the Unity origin location has had applied to it. Used to take origin shifting into account.

Back to Top

---

GetEcefXYZAndPsiThetaPhiRadiansFromUnity

public static void GetEcefXYZAndPsiThetaPhiRadiansFromUnity
(
    Vector3 UnityRotation,
    Vector3 UnityLocation,
    GeoreferenceSystem GeoReferencingSystem,
    out Vector3Double EcefXYZ,
    out FPsiThetaPhi PsiThetaPhiRadians,
    Vector3 OriginRebasingOffset = default
)

Gets the ECEF location and the Psi (Yaw), Theta (Pitch), and Phi (Roll) in radians of the given Unity rotation at the given Unity location

Parameter	Description
UnityRotation	The Unity rotation in world space
UnityLocation	The Unity location in world space
GeoReferencingSystem	The GeoReferencing System reference
EcefXYZ	The ECEF location of the given Unity location
PsiThetaPhiRadians	The Psi (Yaw), Theta (Pitch), and Phi (Roll) in radians
OriginRebasingOffset	Any offset that the Unity origin location has had applied to it. Used to take origin shifting into account.

Back to Top

---

GetHeadingPitchRollFromUnityRotation

public static FHeadingPitchRoll GetHeadingPitchRollFromUnityRotation
(
    Vector3 UnityRotation,
    Vector3 UnityLocation,
    GeoreferenceSystem GeoReferencingSystem
)

Gets the Heading, Pitch, and Roll in degrees of the given Unity rotation at the given Unity location

Parameter	Description
UnityRotation	The Unity rotation in world space
UnityLocation	The Unity location in world space
GeoReferencingSystem	The GeoReferencing Subsystem reference.

Returns
The heading from North, pitch, and roll in degrees

Back to Top

---

GetNEDVectorRotationOffset

public static void GetNEDVectorRotationOffset
(
    FNorthEastDown StartNEDVectors,
    FNorthEastDown DestinationNEDVectors,
    out double RollOffset,
    out double PitchOffset,
    out double YawOffset
)

Gets the rotational offset between the two given NED vectors

Parameter	Description
StartNEDVectors	The North, East, Down vectors of the starting location
DestinationNEDVectors	The North, East, Down vectors of the destination location
RollOffset	The Unity Engine Roll offset in degrees to go from the origin to the destination
PitchOffset	The Unity Engine Roll offset in degrees to go from the origin to the destination
YawOffset	The Unity Engine Roll offset in degrees to go from the origin to the destination

Back to Top

---

GetNorthEastDownVectorsFromEastNorthUpVectors

public static FNorthEastDown GetNorthEastDownVectorsFromEastNorthUpVectors
(
    FEastNorthUp EastNorthUpVectors
)

Get the North, East, and Down vectors from the East, North, and Up vector struct.

Parameter	Description
EastNorthUpVectors	The East, North, and Up vectors representing the current orientation

Returns
The resulting North, East, and Down vectors representing the current orientation

Back to Top

---

GetPsiThetaPhiDegreesFromUnityRotation

public static FPsiThetaPhi GetPsiThetaPhiDegreesFromUnityRotation
(
    Vector3 UnityRotation,
    Vector3 UnityLocation,
    GeoreferenceSystem GeoReferencingSystem,
    Vector3 OriginRebasingOffset = default
)

Gets the Psi (Yaw), Theta (Pitch), and Phi (Roll) in degrees of the given Unity rotation at the given Unity location

Parameter	Description
UnityRotation	The Unity rotation in world space
UnityLocation	The Unity location in world space
GeoReferencingSystem	The GeoReferencing System reference
OriginRebasingOffset	Any offset that the Unity origin location has had applied to it. Used to take origin shifting into account.

Returns
The Psi (Yaw), Theta (Pitch), and Phi (Roll) in degrees

Back to Top

---

GetPsiThetaPhiRadiansFromUnityRotation

public static FPsiThetaPhi GetPsiThetaPhiRadiansFromUnityRotation
(
    Vector3 UnityRotation,
    Vector3 UnityLocation,
    GeoreferenceSystem GeoReferencingSystem,
    Vector3 OriginRebasingOffset = default
)

Gets the Psi (Yaw), Theta (Pitch), and Phi (Roll) in radians of the given Unity rotation at the given Unity location.

Parameter	Description
UnityRotation	The Unity rotation in world space
UnityLocation	The Unity location in world space
GeoReferencingSystem	The GeoReferencing System reference
OriginRebasingOffset	Any offset that the Unity origin location has had applied to it. Used to take origin shifting into account.

Returns
The Psi (Yaw), Theta (Pitch), and Phi (Roll) in radians

Back to Top

---

GetUnityLocationAndOrientationFromEntityStatePdu

public static void GetUnityLocationAndOrientationFromEntityStatePdu
(
    EntityStatePdu EntityStatePdu,
    GeoreferenceSystem GeoReferencingSystem,
    out Vector3 UnityLocation,
    out Vector3 UnityRotation,
    Vector3 OriginRebasingOffset = default
)

Gets the Unity X, Y, Z coordinates and rotation from a DIS entity state PDU. Location values returned change depending on if GeoReferencing System is set to Flat Earth or Round Earth.

Parameter	Description
EntityStatePdu	The DIS PDU struct indicating the current state of the DIS entity
GeoReferencingSystem	The GeoReferencing System reference
UnityLocation	The location of the entity in Unity
UnityRotation	The rotation of the entity in Unity
OriginRebasingOffset	Any offset that the Unity origin location has had applied to it. Used to take origin shifting into account.

Back to Top

---

GetUnityRotationFromEntityStatePdu

public static Vector3 GetUnityRotationFromEntityStatePdu
(
    EntityStatePdu EntityStatePduIn,
    GeoreferenceSystem GeoReferencingSystem
)

Gets Unity rotation from a DIS entity state PDU.

Parameter	Description
EntityStatePdu	The DIS PDU struct indicating the current state of the DIS entity
GeoReferencingSystem	The GeoReferencing Subsystem reference.

Returns
The rotation of the entity in Unity

Back to Top

---

GetUnityRotationFromHeadingPitchRollDegreesAtLatLon

public static Vector3 GetUnityRotationFromHeadingPitchRollDegreesAtLatLon
(
    FHeadingPitchRoll HeadingPitchRollDegrees,
    FLatLonAlt latLonAlt,
    GeoreferenceSystem GeoReferencingSystem
)

Get the Unity rotation from the given Heading, Pitch, Roll rotation in degrees.

Parameter	Description
HeadingPitchRollDegrees	The Heading, Pitch, Roll rotation in degrees to get the Unity rotation from
latLonAlt	The target latitude, longitude, and altitude given in degrees
GeoReferencingSystem	The GeoReferencing Subsystem reference.

Returns
The Unity rotation of the given Heading, Pitch, Roll rotation

Back to Top

---

GetUnityRotationFromHeadingPitchRollRadiansAtLatLon

public static Vector3 GetUnityRotationFromHeadingPitchRollRadiansAtLatLon
(
    FHeadingPitchRoll HeadingPitchRollRadians,
    FLatLonAlt latLonAlt,
    GeoreferenceSystem GeoReferencingSystem
)

Get the Unity rotation from the given Heading, Pitch, Roll rotation in radians.

Parameter	Description
HeadingPitchRollRadians	The Heading, Pitch, Roll rotation in radians to get the Unity rotation from
latLonAlt	The target latitude, longitude, and altitude given in degrees
GeoReferencingSystem	The GeoReferencing Subsystem reference.

Returns
The Unity rotation of the given Heading, Pitch, Roll rotation

Back to Top

---

GetUnityRotationFromPsiThetaPhiDegreesAtLatLon

public static Vector3 GetUnityRotationFromPsiThetaPhiDegreesAtLatLon
(
    FPsiThetaPhi PsiThetaPhiDegrees,
    FLatLonAlt latLonAlt,
    GeoreferenceSystem GeoReferencingSystem
)

Get the Unity rotation from the given Psi, Theta, Phi rotation in degrees.

Parameter	Description
PsiThetaPhiDegrees	The Psi, Theta, Phi rotation in degrees to get the Unity rotation from
latLonAlt	The target latitude, longitude, and altitude given in degrees
GeoReferencingSystem	The GeoReferencing Subsystem reference.

Returns
The Unity rotation of the given Psi, Theta, Phi rotation

Back to Top

---

GetUnityRotationFromPsiThetaPhiRadiansAtLatLon

public static Vector3 GetUnityRotationFromPsiThetaPhiRadiansAtLatLon
(
    FPsiThetaPhi PsiThetaPhiRadians,
    FLatLonAlt latLonAlt,
    GeoreferenceSystem GeoReferencingSystem
)

Get the Unity rotation from the given Psi, Theta, Phi rotation in radians.

Parameter	Description
PsiThetaPhiRadians	The Psi, Theta, Phi rotation in radians to get the Unity rotation from
latLonAlt	The target latitude, longitude, and altitude given in degrees
GeoReferencingSystem	The GeoReferencing Subsystem reference.

Returns
The Unity rotation of the given Psi, Theta, Phi rotation

Back to Top

---

RotateVectorAroundAxisByDegrees

public static Vector3 RotateVectorAroundAxisByDegrees
(
    Vector3 vectorToRotate,
    double thetaDegrees,
    Vector3 axisVector
)

Rotates the vector VectorToRotate around given axis AxisVector by Theta degrees.

Parameter	Description
vectorToRotate	The target vector to rotate
thetaDegrees	The desired amount to rotation in degrees
axisVector	The vector indicating the axis of rotation

Returns
The resultant rotated vector

Back to Top

---

RotateVectorAroundAxisByDegrees

public static dvec3 RotateVectorAroundAxisByDegrees
(
    dvec3 vectorToRotate,
    double thetaDegrees,
    dvec3 axisVector
)

Rotates the vector VectorToRotate around given axis AxisVector by Theta degrees

Parameter	Description
vectorToRotate	The target vector to rotate
thetaDegrees	The desired amount to rotation in degrees
axisVector	The vector indicating the axis of rotation

Returns
The resultant rotated vector

Back to Top

---

RotateVectorAroundAxisByRadians

public static Vector3 RotateVectorAroundAxisByRadians
(
    Vector3 vectorToRotate,
    double thetaRadians,
    Vector3 axisVector
)

Rotates the vector VectorToRotate around given axis AxisVector by Theta radians

Parameter	Description
vectorToRotate	The target vector to rotate
thetaRadians	The desired amount to rotation in radians
axisVector	The vector indicating the axis of rotation

Returns
The resultant rotated vector

Back to Top

---

RotateVectorAroundAxisByRadians

public static dvec3 RotateVectorAroundAxisByRadians
(
    dvec3 vectorToRotate,
    double thetaRadians,
    dvec3 axisVector
)

Rotates the vector VectorToRotate around given axis AxisVector by Theta radians.

Parameter	Description
vectorToRotate	The target vector to rotate
thetaRadians	The desired amount to rotation in radians
axisVector	The vector indicating the axis of rotation

Returns
The resultant rotated vector

Back to Top

---

UnwindRotation

public static Vector3 UnwindRotation
(
    Vector3 RotationDegrees
)

Takes in a rotation in degrees and finds the shortest route along each axis. (ex: [348, -181, 89] becomes [-12, 179, 89])

Parameter	Description
RotationDegrees	Vector3 in degrees to unwind.

Returns
Vector3 containing shortest route rotations along each axis.

Back to Top

---