org.geotools.referencing.factory
Class ReferencingObjectFactory

Object
  extended by AbstractFactory
      extended by ReferencingFactory
          extended by ReferencingObjectFactory
All Implemented Interfaces:
RegisterableService, BufferedFactory, Factory, 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
ReferencingObjectFactory()
          Constructs a default factory.
ReferencingObjectFactory(Hints hints)
          Constructs a factory with the specified hints.
 
Method Summary
 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, 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.
 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, 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.
 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, 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.

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, 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, 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.

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, 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.


Copyright © 1996-2014 Geotools. All Rights Reserved.