org.opengis.referencing.crs
Interface CRSFactory

All Superinterfaces:

Factory

public interface CRSFactory

extends Factory

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.

Version:

Implementation specification 1.0

Author:

OpenGIS® consortium

See Also:

CSFactory, DatumFactory

UML identifier (abstract type): CS_CoordinateSystemFactory

Method Summary

CompoundCRS	createCompoundCRS(Map properties, CoordinateReferenceSystem[] elements) Creates a compound coordinate reference system from an ordered list of CoordinateReferenceSystem objects.
DerivedCRS	createDerivedCRS(Map properties, CoordinateReferenceSystem base, MathTransform baseToDerived, CoordinateSystem derivedCS) Creates a derived coordinate reference system.
EngineeringCRS	createEngineeringCRS(Map properties, EngineeringDatum datum, CoordinateSystem cs) Creates a engineering coordinate reference system.
CoordinateReferenceSystem	createFromWKT(String wkt) Creates a coordinate reference system object from a string.
CoordinateReferenceSystem	createFromXML(String xml) Creates a coordinate reference system object from a XML string.
GeocentricCRS	createGeocentricCRS(Map properties, GeodeticDatum datum, CartesianCS cs) Creates a geocentric coordinate reference system from a cartesian coordinate system.
GeocentricCRS	createGeocentricCRS(Map properties, GeodeticDatum datum, SphericalCS cs) Creates a geocentric coordinate reference system from a spherical coordinate system.
GeographicCRS	createGeographicCRS(Map properties, GeodeticDatum datum, EllipsoidalCS cs) Creates a geographic coordinate reference system.
ImageCRS	createImageCRS(Map properties, ImageDatum datum, CoordinateSystem cs) Creates an image coordinate reference system.
ProjectedCRS	createProjectedCRS(Map properties, GeographicCRS geoCRS, MathTransform toProjected, CartesianCS cs) Creates a projected coordinate reference system from a transform.
ProjectedCRS	createProjectedCRS(Map properties, GeographicCRS geoCRS, String projectionName, GeneralParameterValue[] parameterValues, CartesianCS cs) Creates a projected coordinate reference system from a projection name.
TemporalCRS	createTemporalCRS(Map properties, TemporalDatum datum, TemporalCS cs) Creates a temporal coordinate reference system.
VerticalCRS	createVerticalCRS(Map properties, VerticalDatum datum, VerticalCS cs) Creates a vertical coordinate reference system.

Methods inherited from interface Factory

getVendor

Method Detail

createCompoundCRS

CompoundCRS createCompoundCRS(Map properties,
                              CoordinateReferenceSystem[] elements)
                              throws FactoryException

Creates a compound coordinate reference system from an ordered list of CoordinateReferenceSystem objects.

Parameters:

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

elements - ordered array of CoordinateReferenceSystem objects.

Throws:

FactoryException - if the object creation failed.

UML identifier (operation): createCompoundCoordinateSystem

createEngineeringCRS

EngineeringCRS createEngineeringCRS(Map properties,
                                    EngineeringDatum datum,
                                    CoordinateSystem cs)
                                    throws FactoryException

Creates a engineering coordinate reference system.

Parameters:

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.

Throws:

FactoryException - if the object creation failed.

UML identifier (operation): createLocalCoordinateSystem

createGeocentricCRS

GeocentricCRS createGeocentricCRS(Map properties,
                                  GeodeticDatum datum,
                                  CartesianCS cs)
                                  throws FactoryException

Creates a geocentric coordinate reference system from a cartesian coordinate system.

Parameters:

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.

Throws:

FactoryException - if the object creation failed.

createGeocentricCRS

GeocentricCRS createGeocentricCRS(Map properties,
                                  GeodeticDatum datum,
                                  SphericalCS cs)
                                  throws FactoryException

Creates a geocentric coordinate reference system from a spherical coordinate system.

Parameters:

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.

Throws:

FactoryException - if the object creation failed.

createGeographicCRS

GeographicCRS createGeographicCRS(Map properties,
                                  GeodeticDatum datum,
                                  EllipsoidalCS cs)
                                  throws FactoryException

Creates a geographic coordinate reference system. It could be Latitude/Longitude or Longitude/Latitude.

Parameters:

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.

Throws:

FactoryException - if the object creation failed.

UML identifier (operation): createGeographicCoordinateSystem

createImageCRS

ImageCRS createImageCRS(Map properties,
                        ImageDatum datum,
                        CoordinateSystem cs)
                        throws FactoryException

Creates an image coordinate reference system.

Parameters:

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.

Throws:

FactoryException - if the object creation failed.

createDerivedCRS

DerivedCRS createDerivedCRS(Map properties,
                            CoordinateReferenceSystem base,
                            MathTransform baseToDerived,
                            CoordinateSystem derivedCS)
                            throws FactoryException

Creates a derived coordinate reference system. If the transformation is an affine map performing a rotation, then any mixed axes must have identical units. For example, a (lat_deg, lon_deg, height_feet) system can be rotated in the (lat, lon) plane, since both affected axes are in degrees. But you should not rotate this coordinate system in any other plane.

Parameters:

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").

base - Coordinate reference system to base the derived CRS on.

baseToDerived - The transform from the base CRS to returned CRS.

derivedCS - The coordinate system for the derived CRS. The number of axes must match the target dimension of the transform baseToDerived.

Throws:

FactoryException - if the object creation failed.

UML identifier (operation): createFittedCoordinateSystem

createProjectedCRS

ProjectedCRS createProjectedCRS(Map properties,
                                GeographicCRS geoCRS,
                                MathTransform toProjected,
                                CartesianCS cs)
                                throws FactoryException

Creates a projected coordinate reference system from a transform.

Parameters:

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").

geoCRS - Geographic coordinate reference system to base projection on.

toProjected - The transform from the geographic to the projected CRS.

cs - The coordinate system for the projected CRS.

Throws:

FactoryException - if the object creation failed.

createProjectedCRS

ProjectedCRS createProjectedCRS(Map properties,
                                GeographicCRS geoCRS,
                                String projectionName,
                                GeneralParameterValue[] parameterValues,
                                CartesianCS cs)
                                throws FactoryException

Creates a projected coordinate reference system from a projection name.

Parameters:

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").

geoCRS - Geographic coordinate reference system to base projection on.

projectionName - The classification name for the projection to be created (e.g. "Transverse_Mercator", "Mercator_1SP", "Oblique_Stereographic", etc.).

parameterValues - The parameter value to give to the projection. Should includes "central_meridian", "latitude_of_origin", "scale_factor", "false_easting", "false_northing" and any other parameters specific to the projection.

cs - The coordinate system for the projected CRS.

Throws:

FactoryException - if the object creation failed.

createTemporalCRS

TemporalCRS createTemporalCRS(Map properties,
                              TemporalDatum datum,
                              TemporalCS cs)
                              throws FactoryException

Creates a temporal coordinate reference system.

Parameters:

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.

Throws:

FactoryException - if the object creation failed.

createVerticalCRS

VerticalCRS createVerticalCRS(Map properties,
                              VerticalDatum datum,
                              VerticalCS cs)
                              throws FactoryException

Creates a vertical coordinate reference system.

Parameters:

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.

Throws:

FactoryException - if the object creation failed.

UML identifier (operation): createVerticalCoordinateSystem

createFromXML

CoordinateReferenceSystem createFromXML(String xml)
                                        throws FactoryException

Creates a coordinate reference system object from a XML string.

Parameters:

xml - Coordinate reference system encoded in XML format.

Throws:

FactoryException - if the object creation failed.

UML identifier (operation): createFromXML

createFromWKT

CoordinateReferenceSystem createFromWKT(String wkt)
                                        throws FactoryException

Creates a coordinate reference system object from a string. The definition for WKT is shown using Extended Backus Naur Form (EBNF).

Parameters:

wkt - Coordinate system encoded in Well-Known Text format.

Throws:

FactoryException - if the object creation failed.

UML identifier (operation): createFromWKT