org.opengis.referencing.operation

Interface CoordinateOperation

All Superinterfaces:

IdentifiedObject

All Known Subinterfaces:

ConcatenatedOperation, ConicProjection, Conversion, CylindricalProjection, Operation, PassThroughOperation, PlanarProjection, Projection, SingleOperation, Transformation

@UML(identifier="CC_CoordinateOperation",
     specification=ISO_19111)
public interface CoordinateOperation
extends IdentifiedObject

A mathematical operation on coordinates that transforms or converts coordinates to another coordinate reference system. Many but not all coordinate operations (from coordinate reference system A to coordinate reference system B) also uniquely define the inverse operation (from coordinate reference system B to coordinate reference system A). In some cases, the operation method algorithm for the inverse operation is the same as for the forward algorithm, but the signs of some operation parameter values must be reversed. In other cases, different algorithms are required for the forward and inverse operations, but the same operation parameter values are used. If (some) entirely different parameter values are needed, a different coordinate operation shall be defined.

Since:

GeoAPI 1.0

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	OPERATION_VERSION_KEY Key for the "operationVersion" property.
static java.lang.String	POSITIONAL_ACCURACY_KEY Key for the "positionalAccuracy" property.
static java.lang.String	SCOPE_KEY Key for the "scope" property.
static java.lang.String	VALID_AREA_KEY Key for the "validArea" property.

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Method Summary

Modifier and Type	Method and Description
MathTransform	getMathTransform() Gets the math transform.
java.lang.String	getOperationVersion() Version of the coordinate transformation (i.e., instantiation due to the stochastic nature of the parameters).
java.util.Collection<PositionalAccuracy>	getPositionalAccuracy() Estimate(s) of the impact of this operation on point accuracy.
InternationalString	getScope() Description of domain of usage, or limitations of usage, for which this operation is valid.
CoordinateReferenceSystem	getSourceCRS() Returns the source CRS.
CoordinateReferenceSystem	getTargetCRS() Returns the target CRS.
Extent	getValidArea() Area in which this operation is valid.

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Field Detail

OPERATION_VERSION_KEY

static final java.lang.String OPERATION_VERSION_KEY

Key for the "operationVersion" property. This is used for setting the value to be returned by getOperationVersion().

See Also:

getOperationVersion(), Constant Field Values

POSITIONAL_ACCURACY_KEY

static final java.lang.String POSITIONAL_ACCURACY_KEY

Key for the "positionalAccuracy" property. This is used for setting the value to be returned by getPositionalAccuracy().

See Also:

getPositionalAccuracy(), Constant Field Values

VALID_AREA_KEY

static final java.lang.String VALID_AREA_KEY

Key for the "validArea" property. This is used for setting the value to be returned by getValidArea().

See Also:

getValidArea(), Constant Field Values

SCOPE_KEY

static final java.lang.String SCOPE_KEY

Key for the "scope" property. This is used for setting the value to be returned by getScope().

See Also:

getScope(), Constant Field Values

Method Detail

getSourceCRS

@UML(identifier="sourceCRS",
     obligation=MANDATORY,
     specification=ISO_19111)
CoordinateReferenceSystem getSourceCRS()

Returns the source CRS. The source CRS is mandatory for transformations only. Conversions may have a source CRS that is not specified here, but through GeneralDerivedCRS.getBaseCRS() instead.

Returns:

The source CRS, or null if not available.

getTargetCRS

@UML(identifier="targetCRS",
     obligation=MANDATORY,
     specification=ISO_19111)
CoordinateReferenceSystem getTargetCRS()

Returns the target CRS. The target CRS is mandatory for transformations only. Conversions may have a target CRS that is not specified here, but through GeneralDerivedCRS instead.

Returns:

The target CRS, or null if not available.

getOperationVersion

@UML(identifier="operationVersion",
     obligation=CONDITIONAL,
     specification=ISO_19111)
java.lang.String getOperationVersion()

Version of the coordinate transformation (i.e., instantiation due to the stochastic nature of the parameters). Mandatory when describing a transformation, and should not be supplied for a conversion.

Returns:

The coordinate operation version, or null in none.

getPositionalAccuracy

@UML(identifier="positionalAccuracy",
     obligation=OPTIONAL,
     specification=ISO_19111)
java.util.Collection<PositionalAccuracy> getPositionalAccuracy()

Estimate(s) of the impact of this operation on point accuracy. Gives position error estimates for target coordinates of this coordinate operation, assuming no errors in source coordinates.

Returns:

The position error estimates, or an empty collection if not available.

getValidArea

@UML(identifier="validArea",
     obligation=OPTIONAL,
     specification=ISO_19111)
Extent getValidArea()

Area in which this operation is valid.

Returns:

Coordinate operation valid area, or null if not available.

getScope

@UML(identifier="scope",
     obligation=OPTIONAL,
     specification=ISO_19111)
InternationalString getScope()

Description of domain of usage, or limitations of usage, for which this operation is valid.

getMathTransform

@UML(identifier="CT_CoordinateTransformation.getMathTransform",
     specification=OGC_01009)
MathTransform getMathTransform()

Gets the math transform. The math transform will transform positions in the source coordinate reference system into positions in the target coordinate reference system.