org.geotools.referencing.operation

Class DefaultConversion

Object

Formattable

AbstractIdentifiedObject

AbstractCoordinateOperation

DefaultSingleOperation

DefaultOperation

DefaultConversion

All Implemented Interfaces:

Serializable, IdentifiedObject, Conversion, CoordinateOperation, Operation, SingleOperation

Direct Known Subclasses:

DefaultProjection, DefiningConversion

public class DefaultConversion
extends DefaultOperation
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.1

Author:

Martin Desruisseaux (IRD)

See Also:

DefaultTransformation, Serialized Form

Field Summary

Fields inherited from class DefaultOperation

method

Fields inherited from class AbstractCoordinateOperation

domainOfValidity, EMPTY_ACCURACY_ARRAY, sourceCRS, targetCRS, transform

Fields inherited from class AbstractIdentifiedObject

EMPTY_ALIAS_ARRAY, EMPTY_IDENTIFIER_ARRAY, IDENTIFIER_COMPARATOR, NAME_COMPARATOR, REMARKS_COMPARATOR

Fields inherited from class Formattable

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

Constructors

Constructor and Description
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

Modifier and Type	Method and Description
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 DefaultOperation

create, equals, formatWKT, getMethod, getParameterValues, hashCode

Methods inherited from class AbstractCoordinateOperation

getAccuracy, getAccuracy, getCoordinateOperationAccuracy, getDomainOfValidity, getMathTransform, getOperationVersion, getPositionalAccuracy, getScope, getSourceCRS, getTargetCRS, getType, getValidArea

Methods inherited from class AbstractIdentifiedObject

asSet, ensureAngularUnit, ensureLinearUnit, ensureNonNull, ensureNonNull, ensureTimeUnit, equals, equals, equals, equals, getAlias, getIdentifier, getIdentifier, getIdentifiers, getName, getName, getName, getProperties, getProperties, getRemarks, nameMatches, nameMatches, nameMatches

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 Conversion

getOperationVersion, getSourceCRS, getTargetCRS

Methods inherited from interface Operation

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 AbstractCoordinateOperation 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:

DefaultOperation.create(java.util.Map<java.lang.String, ?>, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.operation.OperationMethod, java.lang.Class<? extends org.opengis.referencing.operation.CoordinateOperation>)