org.geotoolkit.referencing.operation.provider
Class MapProjection

Object
  FormattableObject
      AbstractIdentifiedObject
          DefaultOperationMethod
              MathTransformProvider
                  MapProjection

All Implemented Interfaces:

Serializable, Deprecable, LenientComparable, Formattable, IdentifiedObject, OperationMethod

Direct Known Subclasses:

AlbersEqualArea, CassiniSoldner, EquidistantCylindrical, Krovak, LambertAzimuthalEqualArea, LambertConformal1SP, LambertConformal2SP, Mercator1SP, Mercator2SP, MillerCylindrical, NewZealandMapGrid, ObliqueMercator, Orthographic, Polyconic, PseudoMercator, Stereographic, TransverseMercator

@Immutable
public abstract class MapProjection
extends MathTransformProvider

The base provider for map projections. This base class defines the descriptors for the most commonly used parameters. Subclasses will declare the parameters they use in a descriptor group named PARAMETERS.

Since:

2.0

Version:

3.20

Author:

Martin Desruisseaux (IRD, Geomatys)

See Also:

Map projections on MathWorld, Map projections on the atlas of Canada, Geotk coordinate operations matrix, Serialized Form

Module:

referencing/geotk-referencing (download)

View source code for this class

Field Summary

static ParameterDescriptor<Double>

XY_PLANE_ROTATION Deprecated. Invoke PARAMETERS.descriptor(String) instead.

Fields inherited from class DefaultOperationMethod

sourceDimension, targetDimension

Fields inherited from interface OperationMethod

FORMULA_KEY

Fields inherited from interface IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

protected

MapProjection(ParameterDescriptorGroup parameters) Constructs a math transform provider from a set of parameters.

Method Summary

protected abstract MathTransform2D	createMathTransform(ParameterValueGroup values) Creates a map projection from the specified group of parameter values.
Class<? extends Projection>	getOperationType() Returns the operation type for this map projection.

Methods inherited from class MathTransformProvider

ensureValidValues, formatWKT

Methods inherited from class DefaultOperationMethod

checkDimensions, computeHashCode, equals, getFormula, getParameters, getSourceDimensions, getTargetDimensions

Methods inherited from class AbstractIdentifiedObject

equals, getAlias, getIdentifier, getIdentifiers, getName, getName, getRemarks, hashCode, isDeprecated, nameMatches

Methods inherited from class FormattableObject

print, toString, toWKT, toWKT

Methods inherited from class Object

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

Methods inherited from interface IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Field Detail

XY_PLANE_ROTATION

@Deprecated
public static final ParameterDescriptor<Double> XY_PLANE_ROTATION

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the ESRI "XY_Plane_Rotation" parameter value. The rotation is applied before the false easting and false northing translation, if any. Valid values range is [-360 … 360]°. This parameter is optional and its default value is 0°.

This is an ESRI-specific parameter, but its usage could be extended to any projections. The choice to allow this parameter or not is taken on a projection-by-projection basis.

Since:

3.00

Constructor Detail

MapProjection

protected MapProjection(ParameterDescriptorGroup parameters)

Constructs a math transform provider from a set of parameters. The provider identifiers will be the same than the parameter ones.

Parameters:

parameters - The set of parameters (never null).

Method Detail

getOperationType

public Class<? extends Projection> getOperationType()

Returns the operation type for this map projection.

Overrides:

getOperationType in class MathTransformProvider

Returns:

The GeoAPI interface implemented by this operation.

createMathTransform

protected abstract MathTransform2D createMathTransform(ParameterValueGroup values)
                                                throws ParameterNotFoundException

Creates a map projection from the specified group of parameter values.

Specified by:

createMathTransform in class MathTransformProvider

Parameters:

values - The group of parameter values.

Returns:

The created map projection.

Throws:

ParameterNotFoundException - if a required parameter was not found.