org.da.protoframework.uaappli.helper.projection

Class ProjectionHelper

java.lang.Object

org.da.protoframework.uaappli.helper.projection.ProjectionHelper

public class ProjectionHelper
extends java.lang.Object

A helper for projections.

Field Summary

Fields

Modifier and Type	Field and Description
static double	EARTH_RADIUS Earth radius in meters
static double	EARTHSCALE Earth radius in Nauticals Miles (1852 m).
static double	FT_TO_METERS Conversion constant from Feet to meters (used for altitude)
static double	NM_TO_METERS Conversion constant from Nautical Miles to meters (used for distance)

Constructor Summary

Constructors

Constructor and Description
ProjectionHelper()

Method Summary

Modifier and Type	Method and Description
double	getBearing(MapPosition vector) Compute the angle between two points given their relative position in meters.
double	getBearing(MapPosition point1, MapPosition point2) Compute the bearing between two points given their positions.
double	getBearing(MapPosition vector, short unit) Compute the angle between two points given their relative position in meters.
double	getBearingFromLatLong(MapPosition point1, MapPosition point2) Compute the bearing between two points given their position in latitude / longitude.
double	getBearingFromLatLong(MapPosition point1, MapPosition point2, short unit) Compute the bearing between two points given their position in latitude / longitude.
double	getBearingFromNorthEast(MapPosition point1, MapPosition point2) Compute the bearing between two points given their position in meter.
double	getBearingFromNorthEast(MapPosition point1, MapPosition point2, short unit) Compute the bearing between two points given their position in meter.
double	getDistance(MapPosition vector) Compute the distance between two points given their relative position.
double	getDistanceTo(double radians)
double	getDistanceTo(double lat1, double lon1, double lat2, double lon2, short unit) Compute the distance between two points from (latitude, longitude).
double	getDistanceTo(MapPosition point1, MapPosition point2) Compute the distance between two points from (latitude, longitude).
MapPosition	getEastNorthPosition(double lat, double lon) Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.
MapPosition	getEastNorthPosition(double lat, double lon, short unit) Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.
MapPosition	getEastNorthPosition(MapPosition latlongPosition) Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.
MapPosition	getEastNorthPosition(MapPosition latlongPosition, short unit) Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.
MapPosition	getLatLongPosition(double eastNM, double northNM) Compute the reverse projection from (east, north) coordinates to (Latitude, Longitude) using the Lambert approximation formulas.
MapPosition	getLatLongPosition(double latDEG, double longDEG, float eastNM, float northNM) Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.
MapPosition	getLatLongPosition(double eastNM, double northNM, short unit) Compute the reverse projection from (east, north) coordinates to (Latitude, Longitude) using the Lambert approximation formulas.
MapPosition	getLatLongPosition(MapPosition eastNorthPosition) Compute the reverse projection from (east, north) coordinates to (Latitude, Longitude) using the Lambert approximation formulas.
MapPosition	getLatLongPosition(MapPosition refPoint, double distanceMM, double bearing) Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.
MapPosition	getLatLongPosition(MapPosition refPoint, double distanceMM, double bearing, short unit) Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.
MapPosition	getLatLongPosition(MapPosition refPoint, MapPosition relativePosition) Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.
MapPosition	getLatLongPositionFromMM(double latDEG, double longDEG, long xMM, long yMM) Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.
MapPosition	getLatLongPositionFromMM(long xMM, long yMM) Compute the reverse projection from (x, y) coordinates from the reference of the MapHorz (the PRP) to (Latitude, Longitude) using the Lambert approximation formulas.
MapPosition	getLatLongPositionFromMM(MapPosition refpoint, double distanceMM, double bearing) Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.
MapPosition	getLatLongPositionFromMM(MapPosition refpoint, double distanceMM, double bearing, short unit) Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.
MapPosition	getLatLongPositionFromMM(MapPosition refpoint, MapPosition mmPosition) Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.
MapPosition	getLatLongPositionFromMM(MapPosition refpoint, MapPosition mmPosition, short unit) Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.
double	getOrientation() Return the North orientation defined in degrees.
MapPosition	getVector(double latDEG1, double longDEG1, double latDEG2, double longDEG2) Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.
MapPosition	getVector(MapPosition point1, MapPosition point2) Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.
void	setOrientation(double orientation) Set the North orientation defined.
void	setOrientation(double orientation, short unit) Set the North orientation defined.
void	setPRP(double refPRPX, double refPRPY) Set the reference world position for the projection (latitude and longitude only in the current version of the standard).
void	setPRP(double refPRPX, double refPRPY, short unit) Set the reference world position for the projection (latitude and longitude only in the current version of the standard).
void	setRange(double range, int rangeMM) Set the range.

Methods inherited from class java.lang.Object

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

Field Detail

EARTH_RADIUS

public static final double EARTH_RADIUS

Earth radius in meters

See Also:

Constant Field Values

NM_TO_METERS

public static final double NM_TO_METERS

Conversion constant from Nautical Miles to meters (used for distance)

See Also:

Constant Field Values

FT_TO_METERS

public static final double FT_TO_METERS

Conversion constant from Feet to meters (used for altitude)

See Also:

Constant Field Values

EARTHSCALE

public static final double EARTHSCALE

Earth radius in Nauticals Miles (1852 m).

See Also:

Constant Field Values

Constructor Detail

ProjectionHelper

public ProjectionHelper()

Method Detail

setPRP

public void setPRP(double refPRPX,
                   double refPRPY)

Set the reference world position for the projection (latitude and longitude only in the current version of the standard). The coordinates are in DEG360.

Parameters:

refPRPX - PRP X coordinate for the projection (latitude in the current version of the standard)

refPRPY - PRP Y coordinate for the projection (longitude in the current version of the standard)

setPRP

public void setPRP(double refPRPX,
                   double refPRPY,
                   short unit)

Set the reference world position for the projection (latitude and longitude only in the current version of the standard).

Parameters:

refPRPX - PRP X coordinate for the projection (latitude in the current version of the standard)

refPRPY - PRP Y coordinate for the projection (longitude in the current version of the standard)

unit - the angle unit

setOrientation

public final void setOrientation(double orientation)

Set the North orientation defined. The coordinates are in DEG360.

Parameters:

orientation - the North orientation

setOrientation

public final void setOrientation(double orientation,
                                 short unit)

Set the North orientation defined.

Parameters:

orientation - the North orientation

unit - the angle unit

getOrientation

public double getOrientation()

Return the North orientation defined in degrees.

Returns:

the North orientation

setRange

public void setRange(double range,
                     int rangeMM)

Set the range.

Parameters:

range - the range in nautical miles

rangeMM - the range in 100th MM

getLatLongPosition

public MapPosition getLatLongPosition(MapPosition refPoint,
                                      MapPosition relativePosition)

Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.

Parameters:

refPoint - the reference position in (latitude, longitude)

relativePosition - the relative position in nautical miles (relative to the reference position)

Returns:

the (latitude, longitude) position of the relative point

getLatLongPosition

public MapPosition getLatLongPosition(MapPosition refPoint,
                                      double distanceMM,
                                      double bearing)

Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point. The coordinates are in DEG360.

Parameters:

refPoint - the reference position in (latitude, longitude)

distanceMM - the distance in 100th of mm

bearing - the bearing

Returns:

the (latitude, longitude) position of the relative point

getLatLongPosition

public MapPosition getLatLongPosition(MapPosition refPoint,
                                      double distanceMM,
                                      double bearing,
                                      short unit)

Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.

Parameters:

refPoint - the reference position in (latitude, longitude)

distanceMM - the distance in 100th of mm

bearing - the bearing

unit - the bearing unit

Returns:

the (latitude, longitude) position of the relative point

getLatLongPosition

public MapPosition getLatLongPosition(double latDEG,
                                      double longDEG,
                                      float eastNM,
                                      float northNM)

Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.

Parameters:

latDEG - the latitude of the reference point in degrees

longDEG - the longitude of the reference point in degrees

eastNM - the east position in nautical miles of the relative point

northNM - the north position in nautical miles of the relative point

Returns:

the (latitude, longitude) position of the relative point

getLatLongPositionFromMM

public MapPosition getLatLongPositionFromMM(MapPosition refpoint,
                                            MapPosition mmPosition)

Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.

Parameters:

refpoint - the reference point in latitude, longitude

mmPosition - the relative position in 100th of mm

Returns:

the (latitude, longitude) position of the relative point in degrees

getLatLongPositionFromMM

public MapPosition getLatLongPositionFromMM(MapPosition refpoint,
                                            MapPosition mmPosition,
                                            short unit)

Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.

Parameters:

refpoint - the reference point in latitude, longitude

mmPosition - the relative position in 100th of mm

unit - the angles unit

Returns:

the (latitude, longitude) position of the relative point in degrees

getLatLongPositionFromMM

public MapPosition getLatLongPositionFromMM(MapPosition refpoint,
                                            double distanceMM,
                                            double bearing)

Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.

Parameters:

refpoint - the referecne point in latitude, longitude

distanceMM - the relative distance in 100th of mm

bearing - the relative bearing

Returns:

the (latitude, longitude) position of the relative point in degrees

getLatLongPositionFromMM

public MapPosition getLatLongPositionFromMM(MapPosition refpoint,
                                            double distanceMM,
                                            double bearing,
                                            short unit)

Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.

Parameters:

refpoint - the reference point in latitude, longitude

distanceMM - the relative distance in 100th of mm

bearing - the relative bearing

unit - the bearing unit

Returns:

the (latitude, longitude) position of the relative point in degrees

getLatLongPositionFromMM

public MapPosition getLatLongPositionFromMM(double latDEG,
                                            double longDEG,
                                            long xMM,
                                            long yMM)

Return the (latitude, longitude) position of a point which is at a (east, north) position relative to a reference point.

Parameters:

latDEG - the latitude of the reference point in degrees

longDEG - the longitude of the reference point in degrees

xMM - x position in 100th of mm

yMM - y position in 100th of mm

Returns:

the (latitude, longitude) position of the relative point in degrees

getVector

public MapPosition getVector(double latDEG1,
                             double longDEG1,
                             double latDEG2,
                             double longDEG2)

Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.

Parameters:

latDEG1 - latitude in degrees of the first point

longDEG1 - longitude in degrees of the first point

latDEG2 - latitude in degrees of the second point

longDEG2 - longitude in degrees of the second point

Returns:

the vector in (east, north) coordinates (NM unit)

getVector

public MapPosition getVector(MapPosition point1,
                             MapPosition point2)

Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.

Parameters:

point1 - the first point

point2 - the second point

Returns:

the vector in (east, north) coordinates (NM unit)

getDistance

public double getDistance(MapPosition vector)

Compute the distance between two points given their relative position.

Parameters:

vector - the vector

Returns:

the distance

getDistanceTo

public double getDistanceTo(double lat1,
                            double lon1,
                            double lat2,
                            double lon2,
                            short unit)

Compute the distance between two points from (latitude, longitude).

Parameters:

lat1 - latitude in degrees of the first point

lon1 - longitude in degrees of the first point

lat2 - latitude in degrees of the second point

lon2 - longitude in degrees of the second point

unit - the angle units

Returns:

the distance

getDistanceTo

public double getDistanceTo(MapPosition point1,
                            MapPosition point2)

Compute the distance between two points from (latitude, longitude).

Parameters:

point1 - the first point

point2 - the second point

Returns:

the distance

getDistanceTo

public double getDistanceTo(double radians)

getBearingFromLatLong

public double getBearingFromLatLong(MapPosition point1,
                                    MapPosition point2)

Compute the bearing between two points given their position in latitude / longitude.

Parameters:

point1 - the first point

point2 - the second point

Returns:

the bearing

getBearingFromLatLong

public double getBearingFromLatLong(MapPosition point1,
                                    MapPosition point2,
                                    short unit)

Compute the bearing between two points given their position in latitude / longitude.

Parameters:

point1 - the first point

point2 - the second point

unit - the unit

Returns:

the bearing

getBearingFromNorthEast

public double getBearingFromNorthEast(MapPosition point1,
                                      MapPosition point2)

Compute the bearing between two points given their position in meter.

Parameters:

point1 - the first point

point2 - the second point

Returns:

the bearing

getBearing

public double getBearing(MapPosition point1,
                         MapPosition point2)

Compute the bearing between two points given their positions. The unit of the bearing will be consideresd as North/East except if the unit of the first coordinate is explictly an angle.

Parameters:

point1 - the first point

point2 - the second point

Returns:

the bearing

getBearingFromNorthEast

public double getBearingFromNorthEast(MapPosition point1,
                                      MapPosition point2,
                                      short unit)

Compute the bearing between two points given their position in meter.

Parameters:

point1 - the first point

point2 - the second point

unit - the bearing unit

Returns:

the bearing

getBearing

public double getBearing(MapPosition vector)

Compute the angle between two points given their relative position in meters.

Parameters:

vector - the vector

Returns:

the bearing

getBearing

public double getBearing(MapPosition vector,
                         short unit)

Compute the angle between two points given their relative position in meters.

Parameters:

vector - the vector

unit - the bearing unit

Returns:

the bearing

getEastNorthPosition

public MapPosition getEastNorthPosition(MapPosition latlongPosition)

Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas. The coordinates are assumed to be in degrees.

Parameters:

latlongPosition - the latitude and longitude position in degrees

Returns:

the position in (east, north) coordinates (NM unit)

getEastNorthPosition

public MapPosition getEastNorthPosition(MapPosition latlongPosition,
                                        short unit)

Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.

Parameters:

latlongPosition - the latitude and longitude position in degrees

unit - the unit for the latitude and longitude

Returns:

the position in (east, north) coordinates (NM unit)

getEastNorthPosition

public MapPosition getEastNorthPosition(double lat,
                                        double lon)

Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas. The coordinates are assumed to be in degrees.

Parameters:

lat - latitude

lon - longitude

Returns:

the position in (east, north) coordinates (NM unit)

getEastNorthPosition

public MapPosition getEastNorthPosition(double lat,
                                        double lon,
                                        short unit)

Compute the projection from (latitude, longitude) coordinates to (east, north) using the Lambert approximation formulas.

Parameters:

lat - latitude

lon - longitude

unit - the unit for the latitude and longitude

Returns:

the position in (east, north) coordinates (NM unit)

getLatLongPosition

public MapPosition getLatLongPosition(MapPosition eastNorthPosition)

Compute the reverse projection from (east, north) coordinates to (Latitude, Longitude) using the Lambert approximation formulas.

Parameters:

eastNorthPosition - the (east, north) position in meters

Returns:

the position in (latitude, longitude) (in degrees)

getLatLongPosition

public MapPosition getLatLongPosition(double eastNM,
                                      double northNM)

Compute the reverse projection from (east, north) coordinates to (Latitude, Longitude) using the Lambert approximation formulas.

Parameters:

eastNM - east coordinate in NM

northNM - north coordinate in NM

Returns:

the position in (latitude, longitude) (in degrees)

getLatLongPosition

public MapPosition getLatLongPosition(double eastNM,
                                      double northNM,
                                      short unit)

Compute the reverse projection from (east, north) coordinates to (Latitude, Longitude) using the Lambert approximation formulas.

Parameters:

eastNM - east coordinate in NM

northNM - north coordinate in NM

unit - the angle unit

Returns:

the position in (latitude, longitude) (in degrees)

getLatLongPositionFromMM

public MapPosition getLatLongPositionFromMM(long xMM,
                                            long yMM)

Compute the reverse projection from (x, y) coordinates from the reference of the MapHorz (the PRP) to (Latitude, Longitude) using the Lambert approximation formulas.

Parameters:

xMM - x position in 100th of mm

yMM - y position in 100th of mm

Returns:

the position in (latitude, longitude) (in degrees)