Module org.opengis.geoapi

Package org.opengis.referencing.operation

Interface ConcatenatedOperation

All Superinterfaces:

CoordinateOperation, IdentifiedObject

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

An ordered sequence of two or more single coordinate operations. The sequence of operations is constrained by the requirement that the source coordinate reference system of step (n+1) must be the same as the target coordinate reference system of step (n). The source coordinate reference system of the first step and the target coordinate reference system of the last step are the source and target coordinate reference system associated with the concatenated operation. Instead of a forward operation, an inverse operation may be used for one or more of the operation steps mentioned above, if the inverse operation is uniquely defined by the forward operation.

The concatenated coordinate operation class is primarily intended to provide a mechanism that forces application software to use a preferred path to go from source to target coordinate reference system, if a direct transformation between the two is not available.

Since:

1.0

See Also:

• CoordinateOperationFactory.createConcatenatedOperation(Map, CoordinateOperation[])

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 Optional<CoordinateReferenceSystem>	getInterpolationCRS()	Returns the CRS to be used for interpolations in a grid.
List<SingleOperation>	getOperations()	Returns the sequence of operations that are steps in this concatenated operation.
default CoordinateReferenceSystem	getSourceCRS()	Returns the CRS from which coordinates are changed.
default Optional<Temporal>	getSourceEpoch()	Returns the date at which source coordinate tuples are valid.
default CoordinateReferenceSystem	getTargetCRS()	Returns the CRS to which coordinates are changed.
default Optional<Temporal>	getTargetEpoch()	Returns the date at which target coordinate tuples are valid.

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

getCoordinateOperationAccuracy, getDomainOfValidity, getMathTransform, getOperationVersion, getScope, transform

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getDomains, getIdentifiers, getName, getRemarks, toWKT

Method Details

getOperations

@UML(identifier="coordOperation",
     obligation=MANDATORY,
     specification=ISO_19111)
List<SingleOperation> getOperations()

Returns the sequence of operations that are steps in this concatenated operation. The sequence can contain SingleOperations or PassThroughOperations, but should not contain other ConcatenatedOperations. The sequence shall contain at least two elements.

Upcoming API change
This method is conformant to ISO 19111:2003. But the ISO 19111:2007 revision changed the element type from SingleOperation to CoordinateOperation. This change may be applied in GeoAPI 4.0. This is necessary for supporting usage of PassThroughOperation with ConcatenatedOperation.

Returns:

the sequence of operations.

getSourceCRS

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

Returns the CRS from which coordinates are changed. By default, this is the source CRS of the first operation.

Specified by:

getSourceCRS in interface CoordinateOperation

Returns:

the CRS from which coordinates are changed, or null for a defining conversion.

See Also:

• CoordinateOperation.getSourceEpoch()

getTargetCRS

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

Returns the CRS to which coordinates are changed. By default, this is the target CRS of the last operation.

Specified by:

getTargetCRS in interface CoordinateOperation

Returns:

the CRS to which coordinates are changed, or null for a defining conversion.

See Also:

• CoordinateOperation.getTargetEpoch()

getInterpolationCRS

@UML(identifier="interpolationCRS",
     obligation=OPTIONAL,
     specification=ISO_19111)
default Optional<CoordinateReferenceSystem> getInterpolationCRS()

Returns the CRS to be used for interpolations in a grid. By default, this is the interpolation CRS of the first operation step in which such CRS is defined

Specified by:

getInterpolationCRS in interface CoordinateOperation

Returns:

the CRS to be used for interpolations in a grid.

Since:

3.1

getSourceEpoch

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

Returns the date at which source coordinate tuples are valid. By default, this is the source epoch of the first operation step in which such epoch is defined.

Specified by:

getSourceEpoch in interface CoordinateOperation

Returns:

epoch at which source coordinate tuples are valid.

Since:

3.1

See Also:

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

getTargetEpoch

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

Returns the date at which target coordinate tuples are valid. By default, this is the target epoch of the last operation step in which such epoch is defined.

Specified by:

getTargetEpoch in interface CoordinateOperation

Returns:

epoch at which target coordinate tuples are valid.

Since:

3.1

See Also:

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