fr.cnes.sirius.patrius.math.geometry.euclidean.threed

Class AzimuthElevationCalculator

java.lang.Object

fr.cnes.sirius.patrius.math.geometry.euclidean.threed.AzimuthElevationCalculator

public final class AzimuthElevationCalculator
extends Object

Compute mathematical Azimuth and Elevation of a Point, defined by its Cartesian coordinates in a Frame whose x, y axis and "Reference Azimuth" axis are in the same Plane. Frame x axis is defined by its frameOrientation (counted trigowise, not clockwise !) from the "Reference Azimuth", z axis points to the zenith and y axis completes the right-handed trihedra. The Point Azimuth is the angle (counted clockwise) from the "Reference Azymuth" The Point Elevation is the angle (counted trigowise) from the x,y plane and the Point

Since:

4.6.1

Author:

warrott

Method Summary

Modifier and Type	Method and Description
static double	computeAzimuthRate(PVCoordinates extPVTopo) Compute the azimuth rate of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane.
static Vector3D	computeCartesianUnitPosition(double azimuth, double elevation, double frameOrientation) Compute the cartesian unit vector corresponding to the provided azimuth/elevation angles.
static PVCoordinates	computeCartesianUnitPV(double azimuth, double azimuthDot, double elevation, double elevationDot, double frameOrientation) Compute the cartesian unit vector corresponding to the provided azimuth/elevation angles and their derivatives.
static Vector3D	computeDAzimuth(Vector3D extTopo) Compute the azimuth derivative of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane.
static Vector3D	computeDElevation(Vector3D extTopo) Compute the elevation derivative of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane.
static double	computeElevationRate(PVCoordinates extPVTopo) Compute the elevation rate of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane
static double	getAzimuth(Vector3D point, double frameOrientation) Compute the Azimuth of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane
static double	getElevation(Vector3D point) Compute the Elevation of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane

Methods inherited from class java.lang.Object

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

Method Detail

getElevation

public static double getElevation(Vector3D point)

Compute the Elevation of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane

Parameters:

point - Point Cartesian coordinates / Frame

Returns:

elevation The angle (trigowise, radian) between the x,y plane and the point

computeDElevation

public static Vector3D computeDElevation(Vector3D extTopo)

Compute the elevation derivative of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane.

Parameters:

extTopo - point in Cartesian coordinates which shall be transformed

Returns:

the elevation derivative of a point given in Cartesian coordinates in the local topocentric frame

computeElevationRate

public static double computeElevationRate(PVCoordinates extPVTopo)

Compute the elevation rate of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane

Parameters:

extPVTopo - point in Cartesian coordinates which shall be transformed

Returns:

elevation rate

getAzimuth

public static double getAzimuth(Vector3D point,
                                double frameOrientation)

Compute the Azimuth of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane

Parameters:

point - Point Cartesian coordinates / Frame

frameOrientation - Oriented (trigowise) angle (radian) between the "Reference Azimuth" and the Frame's x axis
Example : If "Reference Azimuth" is aligned with the local North of a local topocentric frame then a frameOrientation of -0.785 (=> -45°) means that the x axis of the Frame points to North-East

Returns:

azimuth The angle (clockwise, radian) between the "Reference Azimuth" and the point projected in x,y plane

computeDAzimuth

public static Vector3D computeDAzimuth(Vector3D extTopo)

Compute the azimuth derivative of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane.

Parameters:

extTopo - point in Cartesian coordinates which shall be transformed

Returns:

the azimuth derivative of a point given in Cartesian coordinates in the local topocentric frame

computeAzimuthRate

public static double computeAzimuthRate(PVCoordinates extPVTopo)

Compute the azimuth rate of a point defined by its Cartesian coordinates in a Frame whose x, y and "Reference Azimuth" axis are in the same Plane.

Parameters:

extPVTopo - point in Cartesian coordinates which shall be transformed

Returns:

azimuth rate

computeCartesianUnitPosition

public static Vector3D computeCartesianUnitPosition(double azimuth,
                                                    double elevation,
                                                    double frameOrientation)

Compute the cartesian unit vector corresponding to the provided azimuth/elevation angles.

Parameters:

azimuth - The azimuth

elevation - The elevation

frameOrientation - Oriented (trigowise) angle between the "Reference Azimuth" and the Frame's x axis

Returns:

the cartesian unit vector

computeCartesianUnitPV

public static PVCoordinates computeCartesianUnitPV(double azimuth,
                                                   double azimuthDot,
                                                   double elevation,
                                                   double elevationDot,
                                                   double frameOrientation)

Compute the cartesian unit vector corresponding to the provided azimuth/elevation angles and their derivatives.

Parameters:

azimuth - The azimuth

azimuthDot - The azimuth derivative

elevation - The elevation

elevationDot - The elevation derivative

frameOrientation - Oriented (trigowise) angle between the "Reference Azimuth" and the Frame's x axis

Returns:

the cartesian unit vector