org.geotoolkit.referencing.operation
Class DefaultConversion

Object
  FormattableObject
      AbstractIdentifiedObject
          AbstractCoordinateOperation
              DefaultSingleOperation
                  DefaultConversion

All Implemented Interfaces:

Serializable, Formattable, LenientComparable, IdentifiedObject, Conversion, CoordinateOperation, SingleOperation

Direct Known Subclasses:

DefaultProjection, DefiningConversion

@Immutable
public class DefaultConversion
extends DefaultSingleOperation
implements Conversion

An operation on coordinates that does not include any change of Datum. The best-known example of a coordinate conversion is a map projection. The parameters describing coordinate conversions are defined rather than empirically derived.

Note that some conversions have no parameters.

Since:

2.0

Version:

3.01

Author:

Martin Desruisseaux (IRD)

See Also:

DefaultTransformation, Serialized Form

Module:

referencing/geotk-referencing (download)

View source code for this class

Field Summary

Fields inherited from class DefaultSingleOperation

method

Fields inherited from class AbstractCoordinateOperation

domainOfValidity, EMPTY_ACCURACY_ARRAY, sourceCRS, targetCRS, transform

Fields inherited from class FormattableObject

EPSG, GEOTIFF, INTERNAL, OGC, SINGLE_LINE

Fields inherited from interface CoordinateOperation

COORDINATE_OPERATION_ACCURACY_KEY, DOMAIN_OF_VALIDITY_KEY, OPERATION_VERSION_KEY, SCOPE_KEY

Fields inherited from interface IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

DefaultConversion(Conversion definition, CoordinateReferenceSystem sourceCRS, CoordinateReferenceSystem targetCRS, MathTransform transform)
Constructs a new conversion with the same values than the specified one, together with the specified source and target CRS.

DefaultConversion(Map<String,?> properties, CoordinateReferenceSystem sourceCRS, CoordinateReferenceSystem targetCRS, MathTransform transform, OperationMethod method)
Constructs a conversion from a set of properties.

Method Summary

static Conversion

create(Conversion definition, CoordinateReferenceSystem sourceCRS, CoordinateReferenceSystem targetCRS, MathTransform transform, Class<? extends Conversion> typeHint) Returns a conversion from the specified defining conversion.

Methods inherited from class DefaultSingleOperation

create, equals, formatWKT, getMethod, getParameterValues

Methods inherited from class AbstractCoordinateOperation

computeHashCode, getAccuracy, getAccuracy, getCoordinateOperationAccuracy, getDomainOfValidity, getMathTransform, getOperationVersion, getScope, getSourceCRS, getTargetCRS, getType

Methods inherited from class AbstractIdentifiedObject

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

Methods inherited from class FormattableObject

getDefaultIndentation, print, setDefaultIndentation, toString, toWKT, toWKT, toWKT

Methods inherited from class Object

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

Methods inherited from interface Conversion

getOperationVersion, getSourceCRS, getTargetCRS

Methods inherited from interface SingleOperation

getMethod, getParameterValues

Methods inherited from interface CoordinateOperation

getCoordinateOperationAccuracy, getDomainOfValidity, getMathTransform, getScope

Methods inherited from interface IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Constructor Detail

DefaultConversion

public DefaultConversion(Conversion definition,
                         CoordinateReferenceSystem sourceCRS,
                         CoordinateReferenceSystem targetCRS,
                         MathTransform transform)

Constructs a new conversion with the same values than the specified one, together with the specified source and target CRS. While the source conversion can be an arbitrary one, it is typically a defining conversion.

Parameters:

definition - The defining conversion.

sourceCRS - The source CRS.

targetCRS - The target CRS.

transform - Transform from positions in the source CRS to positions in the target CRS.

DefaultConversion

public DefaultConversion(Map<String,?> properties,
                         CoordinateReferenceSystem sourceCRS,
                         CoordinateReferenceSystem targetCRS,
                         MathTransform transform,
                         OperationMethod method)

Constructs a conversion from a set of properties. The properties given in argument follow the same rules than for the base-class constructor.

Parameters:

properties - Set of properties. Should contains at least "name".

sourceCRS - The source CRS.

targetCRS - The target CRS.

transform - Transform from positions in the source CRS to positions in the target CRS.

method - The operation method.

Method Detail

create

public static Conversion create(Conversion definition,
                                CoordinateReferenceSystem sourceCRS,
                                CoordinateReferenceSystem targetCRS,
                                MathTransform transform,
                                Class<? extends Conversion> typeHint)

Returns a conversion from the specified defining conversion. The new conversion will be a more specific type like a planar, cylindrical or conic projection. This type is inferred from the conversion argument when possible. However the inferred type is not always the most accurate one, so an optional typeHint argument may be specified in order to get a more specific subclass. This later argument is just a hint: it may be null and will be ignored if it conflict with the automatically inferred type.

Parameters:

definition - The defining conversion.

sourceCRS - The source CRS.

targetCRS - The target CRS.

transform - Transform from positions in the source CRS to positions in the target CRS.

typeHint - One of PlanarProjection.class, CylindricalProjection.class or ConicProjection.class, or null.

Returns:

The conversion of the given type if possible.

Since:

2.4

See Also:

DefaultSingleOperation.create(java.util.Map, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.operation.OperationMethod, java.lang.Class)