org.opengis.referencing.operation
Interface CoordinateOperation

All Superinterfaces:

Info

All Known Subinterfaces:

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

public interface CoordinateOperation

extends Info

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.

Version:

Abstract specification 2.0

Author:

ISO 19111, OpenGIS® consortium

UML identifier (abstract type): CC_CoordinateOperation

Method Summary

MathTransform	getMathTransform() Gets the math transform.
String	getOperationVersion() Version of the coordinate transformation (i.e., instantiation due to the stochastic nature of the parameters).
PositionalAccuracy[]	getPositionalAccuracy() Estimate(s) of the impact of this operation on point accuracy.
String	getScope(Locale locale) 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 Info

getIdentifiers, getName, getRemarks

Method Detail

getSourceCRS

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.

UML identifier (association): sourceCRS

getTargetCRS

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 source CRS.

UML identifier (association): targetCRS

getOperationVersion

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.

UML identifier (conditional attribute): operationVersion

getPositionalAccuracy

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 array if not available.

UML identifier (optional attribute): positionalAccuracy

getValidArea

Extent getValidArea()

Area in which this operation is valid.

Returns:

Coordinate operation valid area, or null if not available.

UML identifier (optional attribute): validArea

getScope

String getScope(Locale locale)

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

Parameters:

locale - The desired locale for the coordinate operation scope to be returned, of null for scope in some default locale (may or may not be the system default).

Returns:

The coordinate operation scope in the given locale, or null if none. If no scope is available in the given locale, then some default locale is used.

UML identifier (optional attribute): scope

getMathTransform

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.

UML identifier (mandatory attribute): mathTransform in 1.0 specification.