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
GeodeticPoint	applyInverseTo(double x, double y) Inverse projection.
GeodeticPoint	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(GeodeticPoint geoPoint) Returns Easting value and Northing value in meters from geodetic coordinates.
boolean	canMap(GeodeticPoint coordinates) Returns a boolean depending if the geodetic point can be map with the selected projection method.
double	getDistortionFactor(double lat) Returns the scale factor at a specific latitude.
EnumLineProperty	getLineProperty() Getter for 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 - : geodetic system of reference

Method Detail

canMap

public final boolean canMap(GeodeticPoint coordinates)

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

Parameters:

coordinates - geodetic point to test if representable.

Returns:

True if the geodetic point can be represented on the map with the chosen projection method.

applyTo

public final Vector2D applyTo(GeodeticPoint geoPoint)

Returns Easting value and Northing value in meters from geodetic coordinates.

Parameters:

geoPoint - the geodetic 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 GeodeticPoint applyInverseTo(double x,
                                          double y)

Inverse projection. Returns geodetic coordinates.

Parameters:

x - abscissa coordinate

y - ordinate coordinate

Returns:

geodetic coordinates.

applyInverseTo

public final GeodeticPoint 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 line property .

Returns:

line property.

getMaximumLatitude

public final double getMaximumLatitude()

Getter for the maximum latitude that the projection can map.

Returns:

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)

Returns 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