org.geotools.referencing.operation
Class DefaultConversion

Object
  extended by Formattable
      extended by AbstractIdentifiedObject
          extended by AbstractCoordinateOperation
              extended by DefaultSingleOperation
                  extended by DefaultOperation
                      extended by 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
Module:
modules/library/referencing (gt-referencing.jar)

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
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 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
 
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, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.operation.OperationMethod, java.lang.Class)


Copyright © 1996-2010 Geotools. All Rights Reserved.