org.geotoolkit.referencing.operation.projection
Class LambertAzimuthalEqualArea

Object
  FormattableObject
      AbstractMathTransform
          AbstractMathTransform2D
              UnitaryProjection
                  LambertAzimuthalEqualArea

All Implemented Interfaces:

Serializable, Formattable, Parameterized, LenientComparable, MathTransform, MathTransform2D

@Immutable
public class LambertAzimuthalEqualArea
extends UnitaryProjection

Lambert Azimuthal Equal Area projection (EPSG codes 9820, 1027, 9821). See the Lambert Azimuthal Equal-Area projection on MathWorld for an overview. See any of the following providers for a list of programmatic parameters:

• LambertAzimuthalEqualArea

References

• A. Annoni, C. Luzet, E.Gubler and J. Ihde - Map Projections for Europe
• John P. Snyder (Map Projections - A Working Manual,
  U.S. Geological Survey Professional Paper 1395)

Since:

2.4

Version:

3.20

Author:

Gerald Evenden (USGS), Beate Stollberg, Martin Desruisseaux (IRD, Geomatys), Rémi Maréchal (Geomatys)

See Also:

Serialized Form

Module:

referencing/geotk-referencing (download)

View source code for this class

Nested Class Summary

Nested classes/interfaces inherited from class UnitaryProjection

UnitaryProjection.Parameters

Field Summary

Fields inherited from class UnitaryProjection

excentricity, excentricitySquared

Fields inherited from class FormattableObject

EPSG, GEOTIFF, INTERNAL, OGC, SINGLE_LINE

Constructor Summary

protected

LambertAzimuthalEqualArea(UnitaryProjection.Parameters parameters) Constructs a new map projection from the supplied parameters.

Method Summary

static MathTransform2D	create(ParameterDescriptorGroup descriptor, ParameterValueGroup values) Creates an Albers Equal Area projection from the given parameters.
boolean	equals(Object object, ComparisonMode mode) Compares the given object with this transform for equivalence.
ParameterDescriptorGroup	getParameterDescriptors() Returns the parameter descriptors for this unitary projection.
protected void	inverseTransform(double[] srcPts, int srcOff, double[] dstPts, int dstOff) Transforms the specified (x,y) coordinates and stores the result in dstPts (angles in radians).
Matrix	transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, boolean derivate) Converts the specified (λ,φ) coordinate (units in radians) and stores the result in dstPts (linear distance on a unit sphere).

Methods inherited from class UnitaryProjection

computeHashCode, finish, getParameterValues, getUnmarshalledParameters, inverse, resetWarnings, rollLongitude, unrollLongitude

Methods inherited from class AbstractMathTransform2D

getSourceDimensions, getTargetDimensions, transform

Methods inherited from class AbstractMathTransform

createTransformedShape, derivative, derivative, ensureNonNull, equals, formatWKT, getName, hashCode, isIdentity, rollLongitude, transform, transform, transform, transform, transform

Methods inherited from class FormattableObject

getDefaultIndentation, print, setDefaultIndentation, 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, transform, transform

Constructor Detail

LambertAzimuthalEqualArea

protected LambertAzimuthalEqualArea(UnitaryProjection.Parameters parameters)

Constructs a new map projection from the supplied parameters.

Parameters:

parameters - The parameters of the projection to be created.

Method Detail

create

public static MathTransform2D create(ParameterDescriptorGroup descriptor,
                                     ParameterValueGroup values)

Creates an Albers Equal Area projection from the given parameters. The descriptor argument is usually LambertAzimuthalEqualArea.PARAMETERS, but is not restricted to. If a different descriptor is supplied, it is user's responsibility to ensure that it is suitable to a Lambert Azimuthal Equal Area projection.

Parameters:

descriptor - Typically LambertAzimuthalEqualArea.PARAMETERS.

values - The parameter values of the projection to create.

Returns:

The map projection.

Since:

3.00

getParameterDescriptors

public ParameterDescriptorGroup getParameterDescriptors()

Returns the parameter descriptors for this unitary projection. Note that the returned descriptor is about the unitary projection, not the full one.

Specified by:

getParameterDescriptors in interface Parameterized

Overrides:

getParameterDescriptors in class AbstractMathTransform2D

Returns:

The parameter descriptors for this math transform, or null.

See Also:

OperationMethod.getParameters()

transform

public Matrix transform(double[] srcPts,
                        int srcOff,
                        double[] dstPts,
                        int dstOff,
                        boolean derivate)
                 throws ProjectionException

Converts the specified (λ,φ) coordinate (units in radians) and stores the result in dstPts (linear distance on a unit sphere). In addition, opportunistically computes the projection derivative if derivate is true.

Specified by:

transform in class UnitaryProjection

Parameters:

srcPts - The array containing the source point coordinate, as (longitude, latitude) angles in radians.

srcOff - The offset of the point to be converted in the source array.

dstPts - The array into which the converted point coordinate is returned (may be the same than srcPts). Ordinates will be expressed in a dimensionless unit, as a linear distance on a unit sphere or ellipse.

dstOff - The offset of the location of the converted point that is stored in the destination array.

derivate - true for computing the derivative, or false if not needed.

Returns:

The matrix of the projection derivative at the given source position, or null if the derivate argument is false.

Throws:

ProjectionException - if the point can't be converted.

Since:

3.20 (derived from 3.00)

See Also:

AbstractMathTransform.derivative(DirectPosition), AbstractMathTransform.transform(DirectPosition, DirectPosition), MathTransforms.derivativeAndTransform(MathTransform, double[], int, double[], int)

inverseTransform

protected void inverseTransform(double[] srcPts,
                                int srcOff,
                                double[] dstPts,
                                int dstOff)
                         throws ProjectionException

Transforms the specified (x,y) coordinates and stores the result in dstPts (angles in radians).

Specified by:

inverseTransform in class UnitaryProjection

Parameters:

srcPts - The array containing the source point coordinate, as linear distance on a unit sphere or ellipse.

srcOff - The offset of the point to be converted in the source array.

dstPts - the array into which the converted point coordinate is returned (may be the same than srcPts). Ordinates will be (longitude, latitude) angles in radians.

dstOff - The offset of the location of the converted point that is stored in the destination array.

Throws:

ProjectionException - if the point can't be converted.

equals

public boolean equals(Object object,
                      ComparisonMode mode)

Compares the given object with this transform for equivalence.

Specified by:

equals in interface LenientComparable

Overrides:

equals in class UnitaryProjection

Parameters:

object - The object to compare with this unitary projection for equivalence.

mode - The strictness level of the comparison. Default to STRICT.

Returns:

true if the given object is equivalent to this unitary projection.

See Also:

Utilities.deepEquals(Object, Object, ComparisonMode)