fr.cnes.sirius.patrius.projections

Class IdentityProjection

java.lang.Object

fr.cnes.sirius.patrius.projections.AbstractProjection

fr.cnes.sirius.patrius.projections.IdentityProjection

All Implemented Interfaces:

IProjection, Serializable

public class IdentityProjection
extends AbstractProjection

This is the identity projection defined by
X = Lon
Y = Lat

The pivot point has a latitude and longitude to 0.

Since:

3.2

Version:

$Id$

Author:

Galpin Thomas

See Also:

Serialized Form

Concurrency :

not thread-safe

Constructor Summary

Constructors

Constructor and Description
IdentityProjection(EllipsoidBodyShape ellipsoid) Constructor with EllipsoidBodyShape object.

Method Summary

Modifier and Type	Method and Description
EllipsoidPoint	applyInverseTo(double x, double y) Inverse projection.
EllipsoidPoint	applyInverseTo(double x, double y, double alt) This is the Two standard parallel Mercator Projection model.
Vector2D	applyTo(double lat, double lon) Returns Easting value and Northing value in meters from latitude and longitude coordinates.
Vector2D	applyTo(EllipsoidPoint point) Returns Easting value and Northing value in meters from the point coordinates.
boolean	canMap(EllipsoidPoint point) Returns a boolean depending if the ellipsoid point can be map with the selected projection method.
double	getDistortionFactor(double lat) Getter for the scale factor at a specific latitude.
EnumLineProperty	getLineProperty() Getter for the line property.
double	getMaximumEastingValue() Getter for the maximum value for X projected.
double	getMaximumLatitude() Getter for the maximum latitude that the projection can map.
boolean	isConformal() Inform the user if the direct transformation is a conformal 's one (If yes, it preserves angles).
boolean	isEquivalent() Inform the user if the direct transformation is an equivalent 's one (If yes, it preserves surfaces).

Methods inherited from class fr.cnes.sirius.patrius.projections.AbstractProjection

applyInverseTo, applyInverseTo, applyTo, applyToAndDiscretize, discretize, discretizeAndApplyTo, discretizeCircleAndApplyTo, discretizeRhumbAndApplyTo, getPivotPoint, getReference

Methods inherited from class java.lang.Object

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

Constructor Detail

IdentityProjection

public IdentityProjection(EllipsoidBodyShape ellipsoid)

Constructor with EllipsoidBodyShape object.

Parameters:

ellipsoid - ellipsoid shape

Method Detail

canMap

public final boolean canMap(EllipsoidPoint point)

Returns a boolean depending if the ellipsoid point can be map with the selected projection method.

Parameters:

point - point to test if representable

Returns:

true if the ellipsoid point can be represented on the map with the chosen projection method

applyTo

public final Vector2D applyTo(EllipsoidPoint point)

Returns Easting value and Northing value in meters from the point coordinates.

Parameters:

point - the point to transform

Returns:

Vector2D containing Easting value and Northing value in meters

applyTo

public final Vector2D applyTo(double lat,
                              double lon)

Returns Easting value and Northing value in meters from latitude and longitude coordinates.

Parameters:

lat - latitude of the point to project

lon - longitude of the point to project

Returns:

Vector2D containing Easting value and Northing value in meters

applyInverseTo

public final EllipsoidPoint applyInverseTo(double x,
                                           double y)

Inverse projection.
Returns ellipsoid coordinates.

Parameters:

x - abscissa coordinate

y - ordinate coordinate

Returns:

ellipsoid coordinates

applyInverseTo

public final EllipsoidPoint applyInverseTo(double x,
                                           double y,
                                           double alt)

This is the Two standard parallel Mercator Projection model. The latitude and the longitude of the given point to convert can be defined from any natural origin and the user can set the altitude.

Parameters:

x - abscissa coordinate

y - ordinate coordinate

alt - altitude coordinate

Returns:

coordinate

isConformal

public final boolean isConformal()

Inform the user if the direct transformation is a conformal 's one (If yes, it preserves angles).

Returns:

a boolean

isEquivalent

public final boolean isEquivalent()

Inform the user if the direct transformation is an equivalent 's one (If yes, it preserves surfaces).

Returns:

a boolean

getLineProperty

public EnumLineProperty getLineProperty()

Getter for the line property.

Returns:

line property

getMaximumLatitude

public final double getMaximumLatitude()

Getter for the maximum latitude that the projection can map.

Returns:

the maximum latitude that the projection can map

getMaximumEastingValue

public double getMaximumEastingValue()

Getter for the maximum value for X projected.

Returns:

the maximum value for X projected

getDistortionFactor

public double getDistortionFactor(double lat)

Getter for the scale factor at a specific latitude.
The result is the fraction Mercator distance / real distance.

WARNING: this method must not be used with the IdentityProjection class : it always returns an PatriusException.

Specified by:

getDistortionFactor in class AbstractProjection

Parameters:

lat - latitude

Returns:

the distortion factor