org.opengis.referencing.operation

Interface CoordinateOperationFactory

All Superinterfaces:

Factory, ObjectFactory

@UML(identifier="CT_CoordinateTransformationFactory",
     specification=OGC_01009)
public interface CoordinateOperationFactory
extends ObjectFactory

Creates coordinate operations. This factory is capable to find coordinate transformations or conversions between two coordinate reference systems.

Since:

GeoAPI 1.0

Method Summary

Modifier and Type	Method and Description
CoordinateOperation	createConcatenatedOperation(java.util.Map<java.lang.String,? extends java.lang.Object> properties, CoordinateOperation[] operations) Creates a concatenated operation from a sequence of operations.
CoordinateOperation	createOperation(CoordinateReferenceSystem sourceCRS, CoordinateReferenceSystem targetCRS) Returns an operation for conversion or transformation between two coordinate reference systems.
CoordinateOperation	createOperation(CoordinateReferenceSystem sourceCRS, CoordinateReferenceSystem targetCRS, OperationMethod method) Returns an operation using a particular method for conversion or transformation between two coordinate reference systems.

Methods inherited from interface org.opengis.referencing.Factory

getVendor

Method Detail

createOperation

@UML(identifier="createFromCoordinateSystems",
     specification=OGC_01009)
CoordinateOperation createOperation(CoordinateReferenceSystem sourceCRS,
                                                                                                                 CoordinateReferenceSystem targetCRS)
                                                                                                          throws OperationNotFoundException,
                                                                                                                 FactoryException

Returns an operation for conversion or transformation between two coordinate reference systems. If an operation exists, it is returned. If more than one operation exists, the default is returned. If no operation exists, then the exception is thrown.

Parameters:

sourceCRS - Input coordinate reference system.

targetCRS - Output coordinate reference system.

Returns:

A coordinate operation from sourceCRS to targetCRS.

Throws:

OperationNotFoundException - if no operation path was found from sourceCRS to targetCRS.

FactoryException - if the operation creation failed for some other reason.

createOperation

@Extension
CoordinateOperation createOperation(CoordinateReferenceSystem sourceCRS,
                                               CoordinateReferenceSystem targetCRS,
                                               OperationMethod method)
                                        throws OperationNotFoundException,
                                               FactoryException

Returns an operation using a particular method for conversion or transformation between two coordinate reference systems. If the operation exists on the implementation, then it is returned. If the operation does not exist on the implementation, then the implementation has the option of inferring the operation from the argument objects. If for whatever reason the specified operation will not be returned, then the exception is thrown.

Parameters:

sourceCRS - Input coordinate reference system.

targetCRS - Output coordinate reference system.

method - the algorithmic method for conversion or transformation

Returns:

A coordinate operation from sourceCRS to targetCRS.

Throws:

OperationNotFoundException - if no operation path was found from sourceCRS to targetCRS.

FactoryException - if the operation creation failed for some other reason.

createConcatenatedOperation

@Extension
CoordinateOperation createConcatenatedOperation(java.util.Map<java.lang.String,? extends java.lang.Object> properties,
                                                           CoordinateOperation[] operations)
                                                    throws FactoryException

Creates a concatenated operation from a sequence of operations.

Parameters:

properties - Name and other properties to give to the new object. Available properties are listed there.

operations - The sequence of operations.

Returns:

The concatenated operation.

Throws:

FactoryException - if the object creation failed.