org.deegree.model.csct.ct
Class MapProjection

java.lang.Object
  org.deegree.model.csct.ct.AbstractMathTransform
      org.deegree.model.csct.ct.MapProjection

All Implemented Interfaces:

MathTransform, MathTransform2D

Direct Known Subclasses:

ConicProjection, CylindricalProjection, PlanarProjection

abstract class MapProjection
extends AbstractMathTransform
implements MathTransform2D

Provides transformation services between ellipsoidal and cartographic projections. Ellipsoidal height values remain unchanged.

Version:

1.0

Author:

Andr� Gosselin, Martin Desruisseaux

Nested Class Summary

(package private) static class

MapProjection.Provider Informations about a MapProjection.

Field Summary

protected double	a Longueur de l'axe majeur de la terre, en m�tres.
protected double	b Longueur de l'axe mineur de la terre, en m�tres.
protected double	centralLatitude Central latitude in radians.
protected double	centralMeridian Central longitude in radians.
protected double	e Excentricit� de l'ellipse.
(package private) static double	EPS Marge de tol�rance pour les comparaisons de nombre r�els.
protected double	es Carr� de l'excentricit� de l'ellipse: e� = (a�-b�)/a�.
protected double	false_easting
protected double	false_northing
protected boolean	isSpherical Indique si le mod�le terrestre est sph�rique.
(package private) static double	TOL Marge de tol�rance pour les calculs it�ratifs.

Constructor Summary

protected

MapProjection(Projection parameters) Construct a new map projection from the suplied parameters.

Method Summary

(package private) double	cphi2(double ts) Iteratively solve equation (7-9) from Snyder.
Shape	createTransformedShape(Shape shape) Transforme la forme g�om�trique shape sp�cifi�e.
boolean	equals(Object object) Compares the specified object with this map projection for equality.
int	getDimSource() Gets the dimension of input points.
int	getDimTarget() Gets the dimension of output points.
abstract String	getName() Returns a human readable name localized for the specified locale.
int	hashCode() Returns a hash value for this map projection.
MathTransform	inverse() Returns the inverse of this map projection.
void	inverseTransform(double[] src, int srcOffset, double[] dest, int dstOffset, int numPts) Inverse transforms a list of coordinate point ordinal values.
protected abstract Point2D	inverseTransform(double x, double y, Point2D ptDst) Transforms the specified coordinate and stores the result in ptDst.
void	inverseTransform(float[] src, int srcOffset, float[] dest, int dstOffset, int numPts) Inverse transforms a list of coordinate point ordinal values.
Point2D	inverseTransform(Point2D ptSrc, Point2D ptDst) Inverse transforms the specified ptSrc and stores the result in ptDst.
boolean	isIdentity() Returns false since map projections are not identity transforms.
(package private) static double	latitudeToRadians(double y, boolean edge) Convertit en radians une latitude exprim�e en degr�s.
(package private) static double	longitudeToRadians(double x, boolean edge) Convertit en radians une longitude exprim�e en degr�s.
(package private) double	msfn(double s, double c) Compute function f(s,c,es) = c/sqrt(1 - s�*es) needed for the true scale latitude (Snyder, p. 47), where s and c are the sine and cosine of the true scale latitude, and es the eccentricity squared.
String	toString() Retourne une cha�ne de caract�res repr�sentant cette projection cartographique.
(package private) void	toString(StringBuffer buffer) Impl�mentation de la partie entre crochets de la cha�ne retourn�e par toString().
void	transform(double[] src, int srcOffset, double[] dest, int dstOffset, int numPts) Transforms a list of coordinate point ordinal values.
protected abstract Point2D	transform(double x, double y, Point2D ptDst) Transforms the specified coordinate and stores the result in ptDst.
void	transform(float[] src, int srcOffset, float[] dest, int dstOffset, int numPts) Transforms a list of coordinate point ordinal values.
Point2D	transform(Point2D ptSrc, Point2D ptDst) Transforms the specified ptSrc and stores the result in ptDst.
(package private) double	tsfn(double phi, double sinphi) Compute function (15-9) from Snyder equivalent to negative of function (7-7).

Methods inherited from class org.deegree.model.csct.ct.AbstractMathTransform

addParameter, addParameter, createTransformedShape, derivative, derivative, paramMT, transform

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.deegree.model.csct.ct.MathTransform2D

derivative

Methods inherited from interface org.deegree.model.csct.ct.MathTransform

derivative, transform

Field Detail

EPS

static final double EPS

Marge de tol�rance pour les comparaisons de nombre r�els.

See Also:

Constant Field Values

TOL

static final double TOL

Marge de tol�rance pour les calculs it�ratifs.

See Also:

Constant Field Values

isSpherical

protected final boolean isSpherical

Indique si le mod�le terrestre est sph�rique. La valeur true indique que le mod�le est sph�rique, c'est-�-dire que les champs a et b ont la m�me valeur.

e

protected final double e

Excentricit� de l'ellipse. L'excentricit� est 0 si l'ellipso�de est sph�rique, c'est-�-dire si isSpherical est true.

es

protected final double es

Carr� de l'excentricit� de l'ellipse: e� = (a�-b�)/a�.

a

protected final double a

Longueur de l'axe majeur de la terre, en m�tres. Sa valeur par d�faut d�pend de l'�llipso�de par d�faut (par exemple "WGS 1984").

b

protected final double b

Longueur de l'axe mineur de la terre, en m�tres. Sa valeur par d�faut d�pend de l'�llipso�de par d�faut (par exemple "WGS 1984").

centralMeridian

protected double centralMeridian

Central longitude in radians. Default value is 0, the Greenwich meridian. Consider this field as final. It is not final only because TransverseMercatorProjection need to modify it at construction time.

centralLatitude

protected double centralLatitude

Central latitude in radians. Default value is 0, the equator. Consider this field as final. It is not final only because some class need to modify it at construction time.

false_easting

protected double false_easting

false_northing

protected double false_northing

Constructor Detail

MapProjection

protected MapProjection(Projection parameters)
                 throws MissingParameterException

Construct a new map projection from the suplied parameters.

Parameters:

parameters - The parameter values in standard units. The following parameter are recognized:

• "semi_major" (default to WGS 1984)
• "semi_minor" (default to WGS 1984)
• "central_meridian" (default to 0�)
• "latitude_of_origin" (default to 0�)

Throws:

MissingParameterException - if a mandatory parameter is missing.

Method Detail

getName

public abstract String getName()

Returns a human readable name localized for the specified locale.

Overrides:

getName in class AbstractMathTransform

Returns:

The transform name localized in the specified locale if possible, or null if no name is available in any locale.

getDimSource

public final int getDimSource()

Gets the dimension of input points.

Specified by:

getDimSource in interface MathTransform

Returns:

the dimension of input points.

See Also:

"org.opengis.ct.CT_MathTransform#getDimSource()"

getDimTarget

public final int getDimTarget()

Gets the dimension of output points.

Specified by:

getDimTarget in interface MathTransform

Returns:

the dimension of output points.

See Also:

"org.opengis.ct.CT_MathTransform#getDimTarget()"

longitudeToRadians

static double longitudeToRadians(double x,
                                 boolean edge)
                          throws IllegalArgumentException

Convertit en radians une longitude exprim�e en degr�s. Au passage, cette m�thode v�rifiera si la longitude est bien dans les limites permises (�180�). Cette m�thode est utile pour v�rifier la validit� des param�tres de la projection, comme #setCentralLongitude.

Parameters:

x - Longitude � v�rifier, en degr�s.

edge - true pour accepter les longitudes de �180�.

Returns:

Longitude en radians.

Throws:

IllegalArgumentException - si la longitude est invalide.

latitudeToRadians

static double latitudeToRadians(double y,
                                boolean edge)
                         throws IllegalArgumentException

Convertit en radians une latitude exprim�e en degr�s. Au passage, cette m�thode v�rifiera si la latitude est bien dans les limites permises (�90�). Cette m�thode est utile pour v�rifier la validit� des param�tres de la projection, comme #setCentralLongitude.

Parameters:

y - Latitude � v�rifier, en degr�s.

edge - true pour accepter les latitudes de �90�.

Returns:

Latitude en radians.

Throws:

IllegalArgumentException - si la latitude est invalide.

transform

protected abstract Point2D transform(double x,
                                     double y,
                                     Point2D ptDst)
                              throws TransformException

Transforms the specified coordinate and stores the result in ptDst. This method is guaranteed to be invoked with values of x in the range [-PI..PI] and values of y in the range [-PI/2..PI/2].

Parameters:

x - The longitude of the coordinate, in radians.

y - The latitude of the coordinate, in radians.

ptDst - the specified coordinate point that stores the result of transforming ptSrc, or null. Ordinates will be in metres.

Returns:

the coordinate point after transforming ptSrc and stroring the result in ptDst.

Throws:

TransformException - if the point can't be transformed.

transform

public final Point2D transform(Point2D ptSrc,
                               Point2D ptDst)
                        throws TransformException

Transforms the specified ptSrc and stores the result in ptDst.

Specified by:

transform in interface MathTransform2D

Overrides:

transform in class AbstractMathTransform

Parameters:

ptSrc - the specified coordinate point to be transformed. Ordinates must be in degrees.

ptDst - the specified coordinate point that stores the result of transforming ptSrc, or null. Ordinates will be in metres.

Returns:

the coordinate point after transforming ptSrc and stroring the result in ptDst.

Throws:

TransformException - if the point can't be transformed.

See Also:

MathTransform2D.transform(Point2D,Point2D)

transform

public final void transform(double[] src,
                            int srcOffset,
                            double[] dest,
                            int dstOffset,
                            int numPts)
                     throws TransformException

Transforms a list of coordinate point ordinal values. Ordinates must be (longitude,latitude) pairs in degrees.

Specified by:

transform in interface MathTransform

Parameters:

src - the array containing the source point coordinates.

srcOffset - the offset to the first point to be transformed in the source array.

dest - the array into which the transformed point coordinates are returned. May be the same than srcPts.

dstOffset - the offset to the location of the first transformed point that is stored in the destination array.

numPts - the number of point objects to be transformed.

Throws:

TransformException - if a point can't be transformed. This method try to transform every points even if some of them can't be transformed. Non-transformable points will have value Double.NaN. If more than one point can't be transformed, then this exception may be about an arbitrary point.

transform

public final void transform(float[] src,
                            int srcOffset,
                            float[] dest,
                            int dstOffset,
                            int numPts)
                     throws TransformException

Transforms a list of coordinate point ordinal values. Ordinates must be (longitude,latitude) pairs in degrees.

Specified by:

transform in interface MathTransform

Overrides:

transform in class AbstractMathTransform

Parameters:

src - the array containing the source point coordinates.

srcOffset - the offset to the first point to be transformed in the source array.

dest - the array into which the transformed point coordinates are returned. May be the same than srcPts.

dstOffset - the offset to the location of the first transformed point that is stored in the destination array.

numPts - the number of point objects to be transformed.

Throws:

TransformException - if a point can't be transformed. This method try to transform every points even if some of them can't be transformed. Non-transformable points will have value Float.NaN. If more than one point can't be transformed, then this exception may be about an arbitrary point.

createTransformedShape

public final Shape createTransformedShape(Shape shape)
                                   throws TransformException

Transforme la forme g�om�trique shape sp�cifi�e. Cette projection peut remplacer certaines lignes droites par des courbes. Tous les points de la forme g�om�trique seront copi�s. Cette m�thode n'est donc pas � conseiller si shape est volumineux, par exemple s'il repr�sente une bathym�trie enti�re.

Specified by:

createTransformedShape in interface MathTransform2D

Overrides:

createTransformedShape in class AbstractMathTransform

Parameters:

shape - Forme g�om�trique � transformer. Les coordonn�es des points de cette forme doivent �tre exprim�es en degr�s de latitudes et de longitudes.

Returns:

Forme g�om�trique transform�e. Les coordonn�es des points de cette forme seront exprim�es en m�tres.

Throws:

TransformException - si une transformation a �chou�e.

See Also:

MathTransform2D.createTransformedShape(Shape)

inverseTransform

protected abstract Point2D inverseTransform(double x,
                                            double y,
                                            Point2D ptDst)
                                     throws TransformException

Transforms the specified coordinate and stores the result in ptDst. This method shall returns x values in the range [-PI..PI] and y values in the range [-PI/2..PI/2]. It will be checked by the caller, so this method doesn't need to performs this check.

Parameters:

x - The longitude of the coordinate, in metres.

y - The latitude of the coordinate, in metres.

ptDst - the specified coordinate point that stores the result of transforming ptSrc, or null. Ordinates will be in radians.

Returns:

the coordinate point after transforming ptSrc and stroring the result in ptDst.

Throws:

TransformException - if the point can't be transformed.

inverseTransform

public final Point2D inverseTransform(Point2D ptSrc,
                                      Point2D ptDst)
                               throws TransformException

Inverse transforms the specified ptSrc and stores the result in ptDst.

Parameters:

ptSrc - the specified coordinate point to be transformed. Ordinates must be in metres.

ptDst - the specified coordinate point that stores the result of transforming ptSrc, or null. Ordinates will be in degrees.

Returns:

the coordinate point after transforming ptSrc and stroring the result in ptDst.

Throws:

TransformException - if the point can't be transformed.

inverseTransform

public final void inverseTransform(double[] src,
                                   int srcOffset,
                                   double[] dest,
                                   int dstOffset,
                                   int numPts)
                            throws TransformException

Inverse transforms a list of coordinate point ordinal values. Ordinates must be (x,y) pairs in metres.

Throws:

TransformException - if a point can't be transformed. This method try to transform every points even if some of them can't be transformed. Non-transformable points will have value Double.NaN. If more than one point can't be transformed, then this exception may be about an arbitrary point.

inverseTransform

public final void inverseTransform(float[] src,
                                   int srcOffset,
                                   float[] dest,
                                   int dstOffset,
                                   int numPts)
                            throws TransformException

Inverse transforms a list of coordinate point ordinal values. Ordinates must be (x,y) pairs in metres.

Throws:

TransformException - if a point can't be transformed. This method try to transform every points even if some of them can't be transformed. Non-transformable points will have value Float.NaN. If more than one point can't be transformed, then this exception may be about an arbitrary point.

cphi2

final double cphi2(double ts)
            throws TransformException

Iteratively solve equation (7-9) from Snyder.

Throws:

TransformException

msfn

final double msfn(double s,
                  double c)

Compute function f(s,c,es) = c/sqrt(1 - s�*es) needed for the true scale latitude (Snyder, p. 47), where s and c are the sine and cosine of the true scale latitude, and es the eccentricity squared.

tsfn

final double tsfn(double phi,
                  double sinphi)

Compute function (15-9) from Snyder equivalent to negative of function (7-7).

inverse

public final MathTransform inverse()

Returns the inverse of this map projection.

Specified by:

inverse in interface MathTransform

Overrides:

inverse in class AbstractMathTransform

Returns:

The inverse transform.

isIdentity

public final boolean isIdentity()

Returns false since map projections are not identity transforms.

Specified by:

isIdentity in interface MathTransform

Returns:

true if this MathTransform is an identity transform; false otherwise.

hashCode

public int hashCode()

Returns a hash value for this map projection.

Overrides:

hashCode in class AbstractMathTransform

equals

public boolean equals(Object object)

Compares the specified object with this map projection for equality.

Overrides:

equals in class AbstractMathTransform

toString

public final String toString()

Retourne une cha�ne de caract�res repr�sentant cette projection cartographique. Cette cha�ne de caract�res contiendra entre autres le nom de la projection, les coordonn�es du centre et celles de l'origine.

Overrides:

toString in class AbstractMathTransform

toString

void toString(StringBuffer buffer)

Impl�mentation de la partie entre crochets de la cha�ne retourn�e par toString().