|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
@UML(identifier="CS_CoordinateSystemFactory", specification=OGC_01009) public interface CRSFactory
Builds up complex coordinate reference systems
from simpler objects or values. CRSFactory
allows applications to make
coordinate reference systems that cannot be
created by a CRSAuthorityFactory
. This factory is very flexible, whereas the
authority factory is easier to use.
So CRSAuthorityFactory
can be used to make "standard" coordinate reference systems,
and CRSFactory
can be used to make "special" coordinate reference systems.
For example, the EPSG authority has codes for USA state plane coordinate systems
using the NAD83 datum, but these coordinate systems always use meters. EPSG does
not have codes for NAD83 state plane coordinate systems that use feet units. This
factory lets an application create such a hybrid coordinate system.
CSFactory
,
DatumFactory
Methods inherited from interface Factory |
---|
getVendor |
Method Detail |
---|
@UML(identifier="createCompoundCoordinateSystem", specification=OGC_01009) CompoundCRS createCompoundCRS(Map<String,?> properties, CoordinateReferenceSystem[] elements) throws FactoryException
CoordinateReferenceSystem
objects.
properties
- Name and other properties to give to the new object.
Available properties are listed there.elements
- ordered array of CoordinateReferenceSystem
objects.
FactoryException
- if the object creation failed.@UML(identifier="createLocalCoordinateSystem", specification=OGC_01009) EngineeringCRS createEngineeringCRS(Map<String,?> properties, EngineeringDatum datum, CoordinateSystem cs) throws FactoryException
properties
- Name and other properties to give to the new object.
Available properties are listed there.datum
- Engineering datum to use in created CRS.cs
- The coordinate system for the created CRS.
FactoryException
- if the object creation failed.ImageCRS createImageCRS(Map<String,?> properties, ImageDatum datum, AffineCS cs) throws FactoryException
properties
- Name and other properties to give to the new object.
Available properties are listed there.datum
- Image datum to use in created CRS.cs
- The Cartesian or Oblique Cartesian coordinate system for the created CRS.
FactoryException
- if the object creation failed.TemporalCRS createTemporalCRS(Map<String,?> properties, TemporalDatum datum, TimeCS cs) throws FactoryException
properties
- Name and other properties to give to the new object.
Available properties are listed there.datum
- Temporal datum to use in created CRS.cs
- The Temporal coordinate system for the created CRS.
FactoryException
- if the object creation failed.@UML(identifier="createVerticalCoordinateSystem", specification=OGC_01009) VerticalCRS createVerticalCRS(Map<String,?> properties, VerticalDatum datum, VerticalCS cs) throws FactoryException
properties
- Name and other properties to give to the new object.
Available properties are listed there.datum
- Vertical datum to use in created CRS.cs
- The Vertical coordinate system for the created CRS.
FactoryException
- if the object creation failed.GeocentricCRS createGeocentricCRS(Map<String,?> properties, GeodeticDatum datum, CartesianCS cs) throws FactoryException
properties
- Name and other properties to give to the new object.
Available properties are listed there.datum
- Geodetic datum to use in created CRS.cs
- The cartesian coordinate system for the created CRS.
FactoryException
- if the object creation failed.GeocentricCRS createGeocentricCRS(Map<String,?> properties, GeodeticDatum datum, SphericalCS cs) throws FactoryException
properties
- Name and other properties to give to the new object.
Available properties are listed there.datum
- Geodetic datum to use in created CRS.cs
- The spherical coordinate system for the created CRS.
FactoryException
- if the object creation failed.@UML(identifier="createGeographicCoordinateSystem", specification=OGC_01009) GeographicCRS createGeographicCRS(Map<String,?> properties, GeodeticDatum datum, EllipsoidalCS cs) throws FactoryException
properties
- Name and other properties to give to the new object.
Available properties are listed there.datum
- Geodetic datum to use in created CRS.cs
- The ellipsoidal coordinate system for the created CRS.
FactoryException
- if the object creation failed.@UML(identifier="createFittedCoordinateSystem", specification=OGC_01009) DerivedCRS createDerivedCRS(Map<String,?> properties, OperationMethod method, CoordinateReferenceSystem base, MathTransform baseToDerived, CoordinateSystem derivedCS) throws FactoryException
CoordinateOperationFactory.createDefiningConversion(java.util.Map, org.opengis.referencing.operation.OperationMethod, org.opengis.parameter.ParameterValueGroup)
followed by
createDerivedCRS(java.util.Map, org.opengis.referencing.operation.OperationMethod, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.cs.CoordinateSystem)
instead.
It is the user's responsability to ensure that the baseToDerived
transform performs
all required steps, including unit conversions and
change of axis order, if needed.
properties
- Name and other properties to give to the new object.
Available properties are listed there.
Properties for the Conversion
object to be created can be specified
with the "conversion."
prefix added in front of property names
(example: "conversion.name"
).method
- A description of the method for the conversion.base
- Coordinate reference system to base the derived CRS on. The number of axes
must matches the source dimensions
of the transform baseToDerived
.baseToDerived
- The transform from the base CRS to the newly created CRS.derivedCS
- The coordinate system for the derived CRS. The number of axes must matches
the target dimensions of the transform
baseToDerived
.
FactoryException
- if the object creation failed.@UML(identifier="createFittedCoordinateSystem", specification=OGC_01009) DerivedCRS createDerivedCRS(Map<String,?> properties, CoordinateReferenceSystem baseCRS, Conversion conversionFromBase, CoordinateSystem derivedCS) throws FactoryException
The conversionFromBase
should contains only the parameter values required for the conversion. It should not includes
the "base to derived" transform that
performs the unit conversions and change of
axis order; the later should be inferred by this
constructor.
properties
- Name and other properties to give to the new object.
Available properties are listed there.baseCRS
- Coordinate reference system to base the projection on. The number of axes
must matches the source dimensions of
the conversion from base.conversionFromBase
- The
defining conversion.derivedCS
- The coordinate system for the derived CRS. The number of axes must matches
the target dimensions of the conversion
from base.
FactoryException
- if the object creation failed.CoordinateOperationFactory.createDefiningConversion(java.util.Map, org.opengis.referencing.operation.OperationMethod, org.opengis.parameter.ParameterValueGroup)
,
MathTransformFactory.createBaseToDerived(org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.parameter.ParameterValueGroup, org.opengis.referencing.cs.CoordinateSystem)
@UML(identifier="createProjectedCoordinateSystem", specification=OGC_01009) ProjectedCRS createProjectedCRS(Map<String,?> properties, OperationMethod method, GeographicCRS base, MathTransform baseToDerived, CartesianCS derivedCS) throws FactoryException
CoordinateOperationFactory.createDefiningConversion(java.util.Map, org.opengis.referencing.operation.OperationMethod, org.opengis.parameter.ParameterValueGroup)
followed by
createProjectedCRS(java.util.Map, org.opengis.referencing.operation.OperationMethod, org.opengis.referencing.crs.GeographicCRS, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.cs.CartesianCS)
instead.
It is the user's responsability to ensure that the baseToDerived
transform performs
all required steps, including unit conversions and
change of axis order, if needed.
properties
- Name and other properties to give to the new object.
Available properties are listed there.
Properties for the Projection
object to be created can be specified
with the "conversion."
prefix added in front of property names
(example: "conversion.name"
).method
- A description of the method for the projection.base
- Geographic coordinate reference system to base the projection on. The number of axes
must matches the source dimensions
of the transform baseToDerived
.baseToDerived
- The transform from the geographic to the projected CRS.derivedCS
- The coordinate system for the projected CRS. The number of axes must matches
the target dimensions of the transform
baseToDerived
.
FactoryException
- if the object creation failed.@UML(identifier="createProjectedCoordinateSystem", specification=OGC_01009) ProjectedCRS createProjectedCRS(Map<String,?> properties, GeographicCRS baseCRS, Conversion conversionFromBase, CartesianCS derivedCS) throws FactoryException
conversionFromBase
should contains only the parameter values required for the map projection. It should not includes
the "base to derived" transform that
performs the unit conversions and change of
axis order; the later should be inferred by this
constructor.
properties
- Name and other properties to give to the new object.
Available properties are listed there.baseCRS
- Geographic coordinate reference system to base the projection on. The number
of axes must matches the source dimensions
of the conversion from base.conversionFromBase
- The
defining conversion.derivedCS
- The coordinate system for the projected CRS. The number of axes must matches
the target dimensions of the conversion
from base.
FactoryException
- if the object creation failed.CoordinateOperationFactory.createDefiningConversion(java.util.Map, org.opengis.referencing.operation.OperationMethod, org.opengis.parameter.ParameterValueGroup)
,
MathTransformFactory.createBaseToDerived(org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.parameter.ParameterValueGroup, org.opengis.referencing.cs.CoordinateSystem)
@UML(identifier="createFromXML", specification=OGC_01009) CoordinateReferenceSystem createFromXML(String xml) throws FactoryException
xml
- Coordinate reference system encoded in XML format.
FactoryException
- if the object creation failed.@UML(identifier="createFromWKT", specification=OGC_01009) CoordinateReferenceSystem createFromWKT(String wkt) throws FactoryException
wkt
- Coordinate system encoded in Well-Known Text format.
FactoryException
- if the object creation failed.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |