Module org.opengis.geoapi

Package org.opengis.referencing.operation

Interface Transformation

All Superinterfaces:

CoordinateOperation, IdentifiedObject, SingleOperation

@UML(identifier="Transformation",
     specification=ISO_19111)
public interface Transformation
extends SingleOperation

Operation in which parameters are empirically derived from a series of points in both CRSs. This computational process is usually "over-determined", allowing derivation of error (or accuracy) estimates for the transformation. Also, the stochastic nature of the parameters may result in multiple (different) versions of the same coordinate transformation. Because of this, several transformations may exist for a given pair of coordinate reference systems, differing in their transformation method, parameter values and accuracy characteristics.

Since:

1.0

See Also:

• Conversion

Field Summary

Fields inherited from interface org.opengis.referencing.operation.CoordinateOperation

COORDINATE_OPERATION_ACCURACY_KEY, DOMAIN_OF_VALIDITY_KEY, OPERATION_VERSION_KEY, SCOPE_KEY

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, DOMAINS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Method Summary

Modifier and Type	Method	Description
String	getOperationVersion()	Returns the version of this coordinate transformation.
CoordinateReferenceSystem	getSourceCRS()	Returns the CRS from which coordinates are changed.
default Optional<Temporal>	getSourceEpoch()	This attribute is inherited from CoordinateOperation but is not applicable in a transformation.
CoordinateReferenceSystem	getTargetCRS()	Returns the CRS to which coordinates are changed.
default Optional<Temporal>	getTargetEpoch()	This attribute is inherited from CoordinateOperation but is not applicable in a transformation.

Methods inherited from interface org.opengis.referencing.operation.CoordinateOperation

getCoordinateOperationAccuracy, getDomainOfValidity, getInterpolationCRS, getMathTransform, getScope, transform

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getDomains, getIdentifiers, getName, getRemarks, toWKT

Methods inherited from interface org.opengis.referencing.operation.SingleOperation

getMethod, getParameterValues

Method Details

getSourceCRS

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

Returns the CRS from which coordinates are changed. This attribute is mandatory in all transformations.

Specified by:

getSourceCRS in interface CoordinateOperation

Returns:

the CRS from which coordinates are changed. Shall not be null.

See Also:

• CoordinateOperation.getSourceEpoch()

getTargetCRS

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

Returns the CRS to which coordinates are changed. This attribute is mandatory in all transformations.

Specified by:

getTargetCRS in interface CoordinateOperation

Returns:

the CRS to which coordinates are changed. Shall not be null.

See Also:

• CoordinateOperation.getTargetEpoch()

getSourceEpoch

@UML(identifier="sourceCoordinateEpoch",
     obligation=FORBIDDEN,
     specification=ISO_19111)
default Optional<Temporal> getSourceEpoch()

This attribute is inherited from CoordinateOperation but is not applicable in a transformation.

Specified by:

getSourceEpoch in interface CoordinateOperation

Returns:

always empty.

Since:

3.1

See Also:

• CoordinateOperation.getSourceCRS()
• DynamicReferenceFrame.getFrameReferenceEpoch()

getTargetEpoch

@UML(identifier="targetCoordinateEpoch",
     obligation=FORBIDDEN,
     specification=ISO_19111)
default Optional<Temporal> getTargetEpoch()

This attribute is inherited from CoordinateOperation but is not applicable in a transformation.

Specified by:

getTargetEpoch in interface CoordinateOperation

Returns:

always empty.

Since:

3.1

See Also:

• CoordinateOperation.getTargetCRS()
• DynamicReferenceFrame.getFrameReferenceEpoch()

getOperationVersion

@UML(identifier="operationVersion",
     obligation=MANDATORY,
     specification=ISO_19111)
String getOperationVersion()

Returns the version of this coordinate transformation. The version is an identification of the instantiation due to the stochastic nature of the parameters. This attribute is mandatory in all transformations.

Specified by:

getOperationVersion in interface CoordinateOperation

Returns:

version of the coordinate transformation. Shall not be null.