Module org.opengis.geoapi

Package org.opengis.referencing.operation

Interface Conversion

All Superinterfaces:

CoordinateOperation, IdentifiedObject, SingleOperation

All Known Subinterfaces:

ConicProjection, CylindricalProjection, PlanarProjection, Projection

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

Operation in which the parameter values are defined rather than empirically derived. Coordinate conversions are coordinate operations that make use of exact, defined (rather than measured or computed), and therefore error-free parameter values. Corresponding pairs of coordinate tuples in each of the two coordinate reference systems connected through a coordinate conversion have a fixed arithmetic relationship. Additionally one of the two tuples cannot exist without specification of the coordinate conversion and the source coordinate reference system. Coordinate conversions are therefore intimately related to the concept of Derived CRS.

Examples

The best-known examples of coordinate conversions are map projections. A map projection is a conversion from an ellipsoidal coordinate system to a Cartesian coordinate system in CRSs associated to the same datum. Another example is the change of units such as from radians to degrees or feet to meters.

Since:

1.0

See Also:

• Transformation
• CoordinateOperationFactory.createDefiningConversion(Map, OperationMethod, ParameterValueGroup)

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
default String	getOperationVersion()	This attribute is inherited from CoordinateOperation but is not applicable in a conversion.
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 conversion.
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 conversion.

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=OPTIONAL,
     specification=ISO_19111)
CoordinateReferenceSystem getSourceCRS()

Returns the CRS from which coordinates are changed. If this conversion is part of a derived CRS, then the source CRS should be the same as the DerivedCRS.getBaseCRS() value.

Obligation

ISO 19111 declares this property as optional because its value can be inferred from the DerivedCRS.getBaseCRS() property. However, GeoAPI recommends to provide a non-null value anyway, except for defining conversions.

Specified by:

getSourceCRS in interface CoordinateOperation

Returns:

the CRS from which coordinates are changed, or null if not available.

See Also:

• CoordinateOperation.getSourceEpoch()

getTargetCRS

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

Returns the CRS to which coordinates are changed. If this conversion is part of a derived CRS, then the target CRS should be the same as the DerivedCRS instance.

Obligation

ISO 19111 declares this property as optional because its value can be inferred from the DerivedCRS. However, GeoAPI recommends to provide a non-null value anyway, except for defining conversions.

Specified by:

getTargetCRS in interface CoordinateOperation

Returns:

the CRS to which coordinates are changed, or null if not available.

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 conversion.

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 conversion.

Specified by:

getTargetEpoch in interface CoordinateOperation

Returns:

always empty.

Since:

3.1

See Also:

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

getOperationVersion

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

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

Specified by:

getOperationVersion in interface CoordinateOperation

Returns:

should be empty.