org.geotools.referencing.factory

Class ReferencingObjectFactory

Object

AbstractFactory

ReferencingFactory

ReferencingObjectFactory

All Implemented Interfaces:

BufferedFactory, Factory, RegistrableFactory, CRSFactory, CSFactory, DatumFactory, ObjectFactory

public class ReferencingObjectFactory
extends ReferencingFactory
implements CSFactory, DatumFactory, CRSFactory, BufferedFactory

Builds Geotools implementations of CRS, CS and datum objects. Most factory methods expect properties given through a Map argument. The content of this map is described in the ObjectFactory interface.

Since:

2.4

Author:

Martin Desruisseaux (IRD)

Field Summary

Fields inherited from class ReferencingFactory

LOGGER

Fields inherited from class AbstractFactory

hints, MAXIMUM_PRIORITY, MINIMUM_PRIORITY, NORMAL_PRIORITY, priority

Constructor Summary

Constructors

Constructor and Description
ReferencingObjectFactory() Constructs a default factory.
ReferencingObjectFactory(Hints hints) Constructs a factory with the specified hints.

Method Summary

Modifier and Type	Method and Description
AffineCS	createAffineCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) Creates a two dimensional coordinate system from the given pair of axis.
AffineCS	createAffineCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) Creates a three dimensional coordinate system from the given set of axis.
CartesianCS	createCartesianCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) Creates a two dimensional cartesian coordinate system from the given pair of axis.
CartesianCS	createCartesianCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) Creates a three dimensional cartesian coordinate system from the given set of axis.
CompoundCRS	createCompoundCRS(Map<String,?> properties, CoordinateReferenceSystem[] elements) Creates a compound coordinate reference system from an ordered list of CoordinateReferenceSystem objects.
CoordinateSystemAxis	createCoordinateSystemAxis(Map<String,?> properties, String abbreviation, AxisDirection direction, Unit<?> unit) Creates a coordinate system axis from an abbreviation and a unit.
CylindricalCS	createCylindricalCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) Creates a cylindrical coordinate system from the given set of axis.
DerivedCRS	createDerivedCRS(Map<String,?> properties, CoordinateReferenceSystem baseCRS, Conversion conversionFromBase, CoordinateSystem derivedCS) Creates a derived coordinate reference system from a conversion.
DerivedCRS	createDerivedCRS(Map<String,?> properties, OperationMethod method, CoordinateReferenceSystem base, MathTransform baseToDerived, CoordinateSystem derivedCS) Deprecated. Use CoordinateOperationFactory.createDefiningConversion(java.util.Map<java.lang.String, ?>, org.opengis.referencing.operation.OperationMethod, org.opengis.parameter.ParameterValueGroup) followed by createDerivedCRS(java.util.Map<java.lang.String, ?>, org.opengis.referencing.operation.OperationMethod, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.cs.CoordinateSystem) instead.
Ellipsoid	createEllipsoid(Map<String,?> properties, double semiMajorAxis, double semiMinorAxis, Unit<Length> unit) Creates an ellipsoid from radius values.
EllipsoidalCS	createEllipsoidalCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) Creates an ellipsoidal coordinate system without ellipsoidal height.
EllipsoidalCS	createEllipsoidalCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) Creates an ellipsoidal coordinate system with ellipsoidal height.
EngineeringCRS	createEngineeringCRS(Map<String,?> properties, EngineeringDatum datum, CoordinateSystem cs) Creates a engineering coordinate reference system.
EngineeringDatum	createEngineeringDatum(Map<String,?> properties) Creates an engineering datum.
Ellipsoid	createFlattenedSphere(Map<String,?> properties, double semiMajorAxis, double inverseFlattening, Unit<Length> unit) Creates an ellipsoid from an major radius, and inverse flattening.
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<String,?> properties, GeodeticDatum datum, CartesianCS cs) Creates a geocentric coordinate reference system from a cartesian coordinate system.
GeocentricCRS	createGeocentricCRS(Map<String,?> properties, GeodeticDatum datum, SphericalCS cs) Creates a geocentric coordinate reference system from a spherical coordinate system.
GeodeticDatum	createGeodeticDatum(Map<String,?> properties, Ellipsoid ellipsoid, PrimeMeridian primeMeridian) Creates geodetic datum from ellipsoid and (optionaly) Bursa-Wolf parameters.
GeographicCRS	createGeographicCRS(Map<String,?> properties, GeodeticDatum datum, EllipsoidalCS cs) Creates a geographic coordinate reference system.
ImageCRS	createImageCRS(Map<String,?> properties, ImageDatum datum, AffineCS cs) Creates an image coordinate reference system.
ImageDatum	createImageDatum(Map<String,?> properties, PixelInCell pixelInCell) Creates an image datum.
LinearCS	createLinearCS(Map<String,?> properties, CoordinateSystemAxis axis) Creates a linear coordinate system.
PolarCS	createPolarCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) Creates a polar coordinate system from the given pair of axis.
PrimeMeridian	createPrimeMeridian(Map<String,?> properties, double longitude, Unit<Angle> angularUnit) Creates a prime meridian, relative to Greenwich.
ProjectedCRS	createProjectedCRS(Map<String,?> properties, GeographicCRS baseCRS, Conversion conversionFromBase, CartesianCS derivedCS) Creates a projected coordinate reference system from a conversion.
ProjectedCRS	createProjectedCRS(Map<String,?> properties, OperationMethod method, GeographicCRS base, MathTransform baseToDerived, CartesianCS derivedCS) Deprecated. Use CoordinateOperationFactory.createDefiningConversion(java.util.Map<java.lang.String, ?>, org.opengis.referencing.operation.OperationMethod, org.opengis.parameter.ParameterValueGroup) followed by createProjectedCRS(java.util.Map<java.lang.String, ?>, org.opengis.referencing.operation.OperationMethod, org.opengis.referencing.crs.GeographicCRS, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.cs.CartesianCS) instead.
SphericalCS	createSphericalCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) Creates a spherical coordinate system from the given set of axis.
TemporalCRS	createTemporalCRS(Map<String,?> properties, TemporalDatum datum, TimeCS cs) Creates a temporal coordinate reference system.
TemporalDatum	createTemporalDatum(Map<String,?> properties, Date origin) Creates a temporal datum from an enumerated type value.
TimeCS	createTimeCS(Map<String,?> properties, CoordinateSystemAxis axis) Creates a temporal coordinate system.
UserDefinedCS	createUserDefinedCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) Creates a two dimensional user defined coordinate system from the given pair of axis.
UserDefinedCS	createUserDefinedCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) Creates a three dimensional user defined coordinate system from the given set of axis.
VerticalCRS	createVerticalCRS(Map<String,?> properties, VerticalDatum datum, VerticalCS cs) Creates a vertical coordinate reference system.
VerticalCS	createVerticalCS(Map<String,?> properties, CoordinateSystemAxis axis) Creates a vertical coordinate system.
VerticalDatum	createVerticalDatum(Map<String,?> properties, VerticalDatumType type) Creates a vertical datum from an enumerated type value.

Methods inherited from class ReferencingFactory

ensureNonNull, getVendor

Methods inherited from class AbstractFactory

addImplementationHints, equals, getImplementationHints, getPriority, hashCode, onDeregistration, onRegistration, toString

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface Factory

getVendor

Methods inherited from interface Factory

getImplementationHints

Constructor Detail

ReferencingObjectFactory

public ReferencingObjectFactory()

Constructs a default factory. This method is public in order to allows instantiations from a service registry. Users should not instantiate this factory directly, but use one of the following lines instead:

 DatumFactory factory = FactoryFinder.getDatumFactorynull);
 CSFactory    factory = FactoryFinder.getCSFactory(null);
 CRSFactory   factory = FactoryFinder.getCRSFactory(null);
 

ReferencingObjectFactory

public ReferencingObjectFactory(Hints hints)

Constructs a factory with the specified hints. Users should not instantiate this factory directly, but use one of the following lines instead:

 DatumFactory factory = FactoryFinder.getDatumFactory(hints);
 CSFactory    factory = FactoryFinder.getCSFactory(hints);
 CRSFactory   factory = FactoryFinder.getCRSFactory(hints);
 

Parameters:

hints - An optional set of hints, or null if none.

Since:

2.5

Method Detail

createEllipsoid

public Ellipsoid createEllipsoid(Map<String,?> properties,
                                 double semiMajorAxis,
                                 double semiMinorAxis,
                                 Unit<Length> unit)
                          throws FactoryException

Creates an ellipsoid from radius values.

Specified by:

createEllipsoid in interface DatumFactory

Parameters:

properties - Name and other properties to give to the new object.

semiMajorAxis - Equatorial radius in supplied linear units.

semiMinorAxis - Polar radius in supplied linear units.

unit - Linear units of ellipsoid axes.

Returns:

The ellipsoid for the given properties.

Throws:

FactoryException - if the object creation failed.

createFlattenedSphere

public Ellipsoid createFlattenedSphere(Map<String,?> properties,
                                       double semiMajorAxis,
                                       double inverseFlattening,
                                       Unit<Length> unit)
                                throws FactoryException

Creates an ellipsoid from an major radius, and inverse flattening.

Specified by:

createFlattenedSphere in interface DatumFactory

Parameters:

properties - Name and other properties to give to the new object.

semiMajorAxis - Equatorial radius in supplied linear units.

inverseFlattening - Eccentricity of ellipsoid.

unit - Linear units of major axis.

Returns:

The ellipsoid for the given properties.

Throws:

FactoryException - if the object creation failed.

createPrimeMeridian

public PrimeMeridian createPrimeMeridian(Map<String,?> properties,
                                         double longitude,
                                         Unit<Angle> angularUnit)
                                  throws FactoryException

Creates a prime meridian, relative to Greenwich.

Specified by:

createPrimeMeridian in interface DatumFactory

Parameters:

properties - Name and other properties to give to the new object.

longitude - Longitude of prime meridian in supplied angular units East of Greenwich.

angularUnit - Angular units of longitude.

Returns:

The prime meridian for the given properties.

Throws:

FactoryException - if the object creation failed.

createGeodeticDatum

public GeodeticDatum createGeodeticDatum(Map<String,?> properties,
                                         Ellipsoid ellipsoid,
                                         PrimeMeridian primeMeridian)
                                  throws FactoryException

Creates geodetic datum from ellipsoid and (optionaly) Bursa-Wolf parameters.

Specified by:

createGeodeticDatum in interface DatumFactory

Parameters:

properties - Name and other properties to give to the new object.

ellipsoid - Ellipsoid to use in new geodetic datum.

primeMeridian - Prime meridian to use in new geodetic datum.

Returns:

The datum for the given properties.

Throws:

FactoryException - if the object creation failed.

createVerticalDatum

public VerticalDatum createVerticalDatum(Map<String,?> properties,
                                         VerticalDatumType type)
                                  throws FactoryException

Creates a vertical datum from an enumerated type value.

Specified by:

createVerticalDatum in interface DatumFactory

Parameters:

properties - Name and other properties to give to the new object.

type - The type of this vertical datum (often geoidal).

Returns:

The datum for the given properties.

Throws:

FactoryException - if the object creation failed.

createTemporalDatum

public TemporalDatum createTemporalDatum(Map<String,?> properties,
                                         Date origin)
                                  throws FactoryException

Creates a temporal datum from an enumerated type value.

Specified by:

createTemporalDatum in interface DatumFactory

Parameters:

properties - Name and other properties to give to the new object.

origin - The date and time origin of this temporal datum.

Returns:

The datum for the given properties.

Throws:

FactoryException - if the object creation failed.

createEngineeringDatum

public EngineeringDatum createEngineeringDatum(Map<String,?> properties)
                                        throws FactoryException

Creates an engineering datum.

Specified by:

createEngineeringDatum in interface DatumFactory

Parameters:

properties - Name and other properties to give to the new object.

Returns:

The datum for the given properties.

Throws:

FactoryException - if the object creation failed.

createImageDatum

public ImageDatum createImageDatum(Map<String,?> properties,
                                   PixelInCell pixelInCell)
                            throws FactoryException

Creates an image datum.

Specified by:

createImageDatum in interface DatumFactory

Parameters:

properties - Name and other properties to give to the new object.

pixelInCell - Specification of the way the image grid is associated with the image data attributes.

Returns:

The datum for the given properties.

Throws:

FactoryException - if the object creation failed.

createCoordinateSystemAxis

public CoordinateSystemAxis createCoordinateSystemAxis(Map<String,?> properties,
                                                       String abbreviation,
                                                       AxisDirection direction,
                                                       Unit<?> unit)
                                                throws FactoryException

Creates a coordinate system axis from an abbreviation and a unit.

Specified by:

createCoordinateSystemAxis in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

abbreviation - The coordinate axis abbreviation.

direction - The axis direction.

unit - The coordinate axis unit.

Returns:

The axis for the given properties.

Throws:

FactoryException - if the object creation failed.

createCartesianCS

public CartesianCS createCartesianCS(Map<String,?> properties,
                                     CoordinateSystemAxis axis0,
                                     CoordinateSystemAxis axis1)
                              throws FactoryException

Creates a two dimensional cartesian coordinate system from the given pair of axis.

Specified by:

createCartesianCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createCartesianCS

public CartesianCS createCartesianCS(Map<String,?> properties,
                                     CoordinateSystemAxis axis0,
                                     CoordinateSystemAxis axis1,
                                     CoordinateSystemAxis axis2)
                              throws FactoryException

Creates a three dimensional cartesian coordinate system from the given set of axis.

Specified by:

createCartesianCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

axis2 - The third axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createAffineCS

public AffineCS createAffineCS(Map<String,?> properties,
                               CoordinateSystemAxis axis0,
                               CoordinateSystemAxis axis1)
                        throws FactoryException

Creates a two dimensional coordinate system from the given pair of axis.

Specified by:

createAffineCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createAffineCS

public AffineCS createAffineCS(Map<String,?> properties,
                               CoordinateSystemAxis axis0,
                               CoordinateSystemAxis axis1,
                               CoordinateSystemAxis axis2)
                        throws FactoryException

Creates a three dimensional coordinate system from the given set of axis.

Specified by:

createAffineCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

axis2 - The third axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createPolarCS

public PolarCS createPolarCS(Map<String,?> properties,
                             CoordinateSystemAxis axis0,
                             CoordinateSystemAxis axis1)
                      throws FactoryException

Creates a polar coordinate system from the given pair of axis.

Specified by:

createPolarCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createCylindricalCS

public CylindricalCS createCylindricalCS(Map<String,?> properties,
                                         CoordinateSystemAxis axis0,
                                         CoordinateSystemAxis axis1,
                                         CoordinateSystemAxis axis2)
                                  throws FactoryException

Creates a cylindrical coordinate system from the given set of axis.

Specified by:

createCylindricalCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

axis2 - The third axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createSphericalCS

public SphericalCS createSphericalCS(Map<String,?> properties,
                                     CoordinateSystemAxis axis0,
                                     CoordinateSystemAxis axis1,
                                     CoordinateSystemAxis axis2)
                              throws FactoryException

Creates a spherical coordinate system from the given set of axis.

Specified by:

createSphericalCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

axis2 - The third axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createEllipsoidalCS

public EllipsoidalCS createEllipsoidalCS(Map<String,?> properties,
                                         CoordinateSystemAxis axis0,
                                         CoordinateSystemAxis axis1)
                                  throws FactoryException

Creates an ellipsoidal coordinate system without ellipsoidal height.

Specified by:

createEllipsoidalCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createEllipsoidalCS

public EllipsoidalCS createEllipsoidalCS(Map<String,?> properties,
                                         CoordinateSystemAxis axis0,
                                         CoordinateSystemAxis axis1,
                                         CoordinateSystemAxis axis2)
                                  throws FactoryException

Creates an ellipsoidal coordinate system with ellipsoidal height.

Specified by:

createEllipsoidalCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

axis2 - The third axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createVerticalCS

public VerticalCS createVerticalCS(Map<String,?> properties,
                                   CoordinateSystemAxis axis)
                            throws FactoryException

Creates a vertical coordinate system.

Specified by:

createVerticalCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis - The axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createTimeCS

public TimeCS createTimeCS(Map<String,?> properties,
                           CoordinateSystemAxis axis)
                    throws FactoryException

Creates a temporal coordinate system.

Specified by:

createTimeCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis - The axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createLinearCS

public LinearCS createLinearCS(Map<String,?> properties,
                               CoordinateSystemAxis axis)
                        throws FactoryException

Creates a linear coordinate system.

Specified by:

createLinearCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis - The axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createUserDefinedCS

public UserDefinedCS createUserDefinedCS(Map<String,?> properties,
                                         CoordinateSystemAxis axis0,
                                         CoordinateSystemAxis axis1)
                                  throws FactoryException

Creates a two dimensional user defined coordinate system from the given pair of axis.

Specified by:

createUserDefinedCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createUserDefinedCS

public UserDefinedCS createUserDefinedCS(Map<String,?> properties,
                                         CoordinateSystemAxis axis0,
                                         CoordinateSystemAxis axis1,
                                         CoordinateSystemAxis axis2)
                                  throws FactoryException

Creates a three dimensional user defined coordinate system from the given set of axis.

Specified by:

createUserDefinedCS in interface CSFactory

Parameters:

properties - Name and other properties to give to the new object.

axis0 - The first axis.

axis1 - The second axis.

axis2 - The third axis.

Returns:

The coordinate system for the given properties and axes.

Throws:

FactoryException - if the object creation failed.

createCompoundCRS

public CompoundCRS createCompoundCRS(Map<String,?> properties,
                                     CoordinateReferenceSystem[] elements)
                              throws FactoryException

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

Specified by:

createCompoundCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

elements - ordered array of CoordinateReferenceSystem objects.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

createEngineeringCRS

public EngineeringCRS createEngineeringCRS(Map<String,?> properties,
                                           EngineeringDatum datum,
                                           CoordinateSystem cs)
                                    throws FactoryException

Creates a engineering coordinate reference system.

Specified by:

createEngineeringCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

datum - Engineering datum to use in created CRS.

cs - The coordinate system for the created CRS.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

createImageCRS

public ImageCRS createImageCRS(Map<String,?> properties,
                               ImageDatum datum,
                               AffineCS cs)
                        throws FactoryException

Creates an image coordinate reference system.

Specified by:

createImageCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

datum - Image datum to use in created CRS.

cs - The Cartesian or Oblique Cartesian coordinate system for the created CRS.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

createTemporalCRS

public TemporalCRS createTemporalCRS(Map<String,?> properties,
                                     TemporalDatum datum,
                                     TimeCS cs)
                              throws FactoryException

Creates a temporal coordinate reference system.

Specified by:

createTemporalCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

datum - Temporal datum to use in created CRS.

cs - The Temporal coordinate system for the created CRS.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

createVerticalCRS

public VerticalCRS createVerticalCRS(Map<String,?> properties,
                                     VerticalDatum datum,
                                     VerticalCS cs)
                              throws FactoryException

Creates a vertical coordinate reference system.

Specified by:

createVerticalCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

datum - Vertical datum to use in created CRS.

cs - The Vertical coordinate system for the created CRS.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

createGeocentricCRS

public GeocentricCRS createGeocentricCRS(Map<String,?> properties,
                                         GeodeticDatum datum,
                                         CartesianCS cs)
                                  throws FactoryException

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

Specified by:

createGeocentricCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

datum - Geodetic datum to use in created CRS.

cs - The cartesian coordinate system for the created CRS.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

createGeocentricCRS

public GeocentricCRS createGeocentricCRS(Map<String,?> properties,
                                         GeodeticDatum datum,
                                         SphericalCS cs)
                                  throws FactoryException

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

Specified by:

createGeocentricCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

datum - Geodetic datum to use in created CRS.

cs - The spherical coordinate system for the created CRS.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

createGeographicCRS

public GeographicCRS createGeographicCRS(Map<String,?> properties,
                                         GeodeticDatum datum,
                                         EllipsoidalCS cs)
                                  throws FactoryException

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

Specified by:

createGeographicCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

datum - Geodetic datum to use in created CRS.

cs - The ellipsoidal coordinate system for the created CRS.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

createDerivedCRS

public DerivedCRS createDerivedCRS(Map<String,?> properties,
                                   OperationMethod method,
                                   CoordinateReferenceSystem base,
                                   MathTransform baseToDerived,
                                   CoordinateSystem derivedCS)
                            throws FactoryException

Deprecated. Use CoordinateOperationFactory.createDefiningConversion(java.util.Map<java.lang.String, ?>, org.opengis.referencing.operation.OperationMethod, org.opengis.parameter.ParameterValueGroup) followed by createDerivedCRS(java.util.Map<java.lang.String, ?>, org.opengis.referencing.operation.OperationMethod, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.cs.CoordinateSystem) instead.

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 decimal degrees. But you should not rotate this coordinate system in any other plane.

NOTE: 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. The ReferencingFactoryContainer class provides conveniences methods for this task.

Parameters:

properties - Name and other properties to give to the new object.

method - A description of the method for the conversion.

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.

Throws:

FactoryException - if the object creation failed.

createDerivedCRS

public DerivedCRS createDerivedCRS(Map<String,?> properties,
                                   CoordinateReferenceSystem baseCRS,
                                   Conversion conversionFromBase,
                                   CoordinateSystem derivedCS)
                            throws FactoryException

Creates a derived coordinate reference system from a conversion. It is the user's responsability to ensure that the conversion performs all required steps, including unit conversions and change of axis order, if needed.

Specified by:

createDerivedCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

baseCRS - Coordinate reference system to base projection on.

conversionFromBase - The defining conversion.

derivedCS - The coordinate system for the derived CRS.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

Since:

2.5

See Also:

CoordinateOperationFactory.createDefiningConversion(java.util.Map<java.lang.String, ?>, 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)

createProjectedCRS

public ProjectedCRS createProjectedCRS(Map<String,?> properties,
                                       OperationMethod method,
                                       GeographicCRS base,
                                       MathTransform baseToDerived,
                                       CartesianCS derivedCS)
                                throws FactoryException

Deprecated. Use CoordinateOperationFactory.createDefiningConversion(java.util.Map<java.lang.String, ?>, org.opengis.referencing.operation.OperationMethod, org.opengis.parameter.ParameterValueGroup) followed by createProjectedCRS(java.util.Map<java.lang.String, ?>, org.opengis.referencing.operation.OperationMethod, org.opengis.referencing.crs.GeographicCRS, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.cs.CartesianCS) instead.

Creates a projected coordinate reference system from a transform.

NOTE: 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. The ReferencingFactoryContainer class provides conveniences methods for this task.

Parameters:

properties - Name and other properties to give to the new object.

method - A description of the method for the projection.

base - Geographic coordinate reference system to base projection on.

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

derivedCS - The coordinate system for the projected CRS.

Throws:

FactoryException - if the object creation failed.

createProjectedCRS

public ProjectedCRS createProjectedCRS(Map<String,?> properties,
                                       GeographicCRS baseCRS,
                                       Conversion conversionFromBase,
                                       CartesianCS derivedCS)
                                throws FactoryException

Creates a projected coordinate reference system from a conversion. The supplied conversion should not includes the operation steps for performing unit conversions and change of axis order since those operations will be inferred by this constructor

Specified by:

createProjectedCRS in interface CRSFactory

Parameters:

properties - Name and other properties to give to the new object.

baseCRS - Geographic coordinate reference system to base projection on.

conversionFromBase - The defining conversion.

derivedCS - The coordinate system for the projected CRS.

Returns:

The coordinate reference system for the given properties.

Throws:

FactoryException - if the object creation failed.

Since:

2.5

See Also:

CoordinateOperationFactory.createDefiningConversion(java.util.Map<java.lang.String, ?>, 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)

createFromXML

public CoordinateReferenceSystem createFromXML(String xml)
                                        throws FactoryException

Creates a coordinate reference system object from a XML string.

Specified by:

createFromXML in interface CRSFactory

Parameters:

xml - Coordinate reference system encoded in XML format.

Returns:

The coordinate reference system for the given XML.

Throws:

FactoryException - if the object creation failed.

createFromWKT

public CoordinateReferenceSystem createFromWKT(String wkt)
                                        throws FactoryException

Creates a coordinate reference system object from a string.

Specified by:

createFromWKT in interface CRSFactory

Parameters:

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

Returns:

The coordinate reference system for the given WKT.

Throws:

FactoryException - if the object creation failed.