org.opengis.referencing.operation
Interface CoordinateOperationFactory
- All Superinterfaces:
- Factory
- public interface CoordinateOperationFactory
- extends Factory
Creates coordinate transformations or
conversions between two coordinate reference systems.
- Version:
- Implementation specification 1.0
- Author:
- OpenGIS® consortium
- UML identifier (abstract type):
CT_CoordinateTransformationFactory
createOperation
CoordinateOperation createOperation(CoordinateReferenceSystem sourceCRS,
CoordinateReferenceSystem targetCRS)
throws 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.
- Throws:
FactoryException - if no transformation path was found from sourceCRS
to targetCRS.
- UML identifier (operation):
createFromCoordinateSystems in 1.0 specification
- REVISIT OPEN ISSUE (a GeoAPI comment)
- Should we create a more accurate subclass of
FactoryException?
|
createOperation
CoordinateOperation createOperation(CoordinateReferenceSystem sourceCRS,
CoordinateReferenceSystem targetCRS,
OperationMethod method)
throws 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:
method - the algorithmic method for conversion or transformationsourceCRS - Input coordinate reference system.targetCRS - Output coordinate reference system.
- Throws:
FactoryException - if no transformation path was found from sourceCRS
to targetCRS.
- REVISIT OPEN ISSUE (a GeoAPI comment)
- More than one operation step may be involved in the path from
sourceCRS
to targetCRS, but this method has only one method argument.
The user could have more fine grain control with MathTransformFactory (ported
from OGC 2001-09).
|