org.geotools.referencing.operation.projection

Class CassiniSoldner

Object

Formattable

AbstractMathTransform

MapProjection

CassiniSoldner

All Implemented Interfaces:

Serializable, MathTransform, MathTransform2D

public class CassiniSoldner
extends MapProjection

Cassini-Soldner Projection (EPSG code 9806). The Cassini-Soldner Projection is the ellipsoidal version of the Cassini projection for the sphere. It is not conformal but as it is relatively simple to construct it was extensively used in the last century and is still useful for mapping areas with limited longitudinal extent. It has now largely been replaced by the conformal Transverse Mercator which it resembles. Like this, it has a straight central meridian along which the scale is true, all other meridians and parallels are curved, and the scale distortion increases rapidly with increasing distance from the central meridian.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CassiniSoldner.Provider The MathTransformProvider for a CassiniSoldner projection.

Nested classes/interfaces inherited from class MapProjection

MapProjection.AbstractProvider

Field Summary

Fields inherited from class MapProjection

centralMeridian, en0, en1, en2, en3, en4, excentricity, excentricitySquared, falseEasting, falseNorthing, globalScale, invertible, isSpherical, latitudeOfOrigin, LOGGER, scaleFactor, semiMajor, semiMinor, SKIP_SANITY_CHECKS

Fields inherited from class Formattable

SINGLE_LINE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CassiniSoldner(ParameterValueGroup values)

Method Summary

Modifier and Type	Method and Description
ParameterDescriptorGroup	getParameterDescriptors() Returns the parameter descriptors for this map projection.
protected Point2D	inverseTransformNormalized(double x, double y, Point2D ptDst) Transforms the specified (x,y) coordinate and stores the result in ptDst.
protected Point2D	transformNormalized(double lam, double phi, Point2D ptDst) Transforms the specified (x,y) coordinate (units in radians) and stores the result in ptDst (linear distance on a unit sphere).

Methods inherited from class MapProjection

checkReciprocal, equals, getParameterValues, getSourceDimensions, getTargetDimensions, getToleranceForAssertions, hashCode, inv_mlfn, inverse, mlfn, orthodromicDistance, resetWarnings, transform, transform, transform

Methods inherited from class AbstractMathTransform

createTransformedShape, derivative, derivative, ensureNonNull, formatWKT, getName, isIdentity, needCopy, normalizeAngle, rollLongitude, transform, transform, transform

Methods inherited from class Formattable

cleanupThreadLocals, toString, toWKT, toWKT, toWKT, toWKT

Methods inherited from class Object

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

Methods inherited from interface MathTransform2D

createTransformedShape, derivative

Methods inherited from interface MathTransform

derivative, isIdentity, toWKT, transform, transform, transform

Constructor Detail

CassiniSoldner

protected CassiniSoldner(ParameterValueGroup values)
                  throws ParameterNotFoundException

Throws:

ParameterNotFoundException

Method Detail

getParameterDescriptors

public ParameterDescriptorGroup getParameterDescriptors()

Returns the parameter descriptors for this map projection. This is used for a providing a default implementation of MapProjection.getParameterValues(), as well as arguments checking.

Specified by:

getParameterDescriptors in class MapProjection

Returns:

The parameter descriptors for this math transform, or null.

See Also:

OperationMethod.getParameters()

inverseTransformNormalized

protected Point2D inverseTransformNormalized(double x,
                                             double y,
                                             Point2D ptDst)
                                      throws ProjectionException

Transforms the specified (x,y) coordinate and stores the result in ptDst.

Specified by:

inverseTransformNormalized in class MapProjection

Parameters:

x - The easting of the coordinate, linear distance on a unit sphere or ellipse.

y - The northing of the coordinate, linear distance on a unit sphere or ellipse.

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 x, y and storing the result in ptDst.

Throws:

ProjectionException - if the point can't be transformed.

transformNormalized

protected Point2D transformNormalized(double lam,
                                      double phi,
                                      Point2D ptDst)
                               throws ProjectionException

Transforms the specified (x,y) coordinate (units in radians) and stores the result in ptDst (linear distance on a unit sphere).

Specified by:

transformNormalized in class MapProjection

Parameters:

lam - The longitude of the coordinate, in radians.

phi - 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 a dimensionless unit, as a linear distance on a unit sphere or ellipse.

Returns:

the coordinate point after transforming (lambda, phi) and storing the result in ptDst.

Throws:

ProjectionException - if the point can't be transformed.