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	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