org.geotools.referencing.factory
Class ReferencingObjectFactory

java.lang.Object
  extended by org.geotools.factory.AbstractFactory
      extended by org.geotools.referencing.factory.ReferencingFactory
          extended by org.geotools.referencing.factory.ReferencingObjectFactory
All Implemented Interfaces:
javax.imageio.spi.RegisterableService, BufferedFactory, Factory, org.opengis.referencing.crs.CRSFactory, org.opengis.referencing.cs.CSFactory, org.opengis.referencing.datum.DatumFactory, org.opengis.referencing.ObjectFactory

public class ReferencingObjectFactory
extends ReferencingFactory
implements org.opengis.referencing.cs.CSFactory, org.opengis.referencing.datum.DatumFactory, org.opengis.referencing.crs.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
Version:
$Id: ReferencingObjectFactory.java 31007 2008-07-11 17:33:53Z desruisseaux $
Author:
Martin Desruisseaux (IRD)

Field Summary
 
Fields inherited from class org.geotools.referencing.factory.ReferencingFactory
LOGGER
 
Fields inherited from class org.geotools.factory.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
 org.opengis.referencing.cs.AffineCS createAffineCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1)
          Creates a two dimensional coordinate system from the given pair of axis.
 org.opengis.referencing.cs.AffineCS createAffineCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1, org.opengis.referencing.cs.CoordinateSystemAxis axis2)
          Creates a three dimensional coordinate system from the given set of axis.
 org.opengis.referencing.cs.CartesianCS createCartesianCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1)
          Creates a two dimensional cartesian coordinate system from the given pair of axis.
 org.opengis.referencing.cs.CartesianCS createCartesianCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1, org.opengis.referencing.cs.CoordinateSystemAxis axis2)
          Creates a three dimensional cartesian coordinate system from the given set of axis.
 org.opengis.referencing.crs.CompoundCRS createCompoundCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.crs.CoordinateReferenceSystem[] elements)
          Creates a compound coordinate reference system from an ordered list of CoordinateReferenceSystem objects.
 org.opengis.referencing.cs.CoordinateSystemAxis createCoordinateSystemAxis(java.util.Map<java.lang.String,?> properties, java.lang.String abbreviation, org.opengis.referencing.cs.AxisDirection direction, javax.measure.unit.Unit<?> unit)
          Creates a coordinate system axis from an abbreviation and a unit.
 org.opengis.referencing.cs.CylindricalCS createCylindricalCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1, org.opengis.referencing.cs.CoordinateSystemAxis axis2)
          Creates a cylindrical coordinate system from the given set of axis.
 org.opengis.referencing.crs.DerivedCRS createDerivedCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.crs.CoordinateReferenceSystem baseCRS, org.opengis.referencing.operation.Conversion conversionFromBase, org.opengis.referencing.cs.CoordinateSystem derivedCS)
          Creates a derived coordinate reference system from a conversion.
 org.opengis.referencing.crs.DerivedCRS createDerivedCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.operation.OperationMethod method, org.opengis.referencing.crs.CoordinateReferenceSystem base, org.opengis.referencing.operation.MathTransform baseToDerived, org.opengis.referencing.cs.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.
 org.opengis.referencing.datum.Ellipsoid createEllipsoid(java.util.Map<java.lang.String,?> properties, double semiMajorAxis, double semiMinorAxis, javax.measure.unit.Unit<javax.measure.quantity.Length> unit)
          Creates an ellipsoid from radius values.
 org.opengis.referencing.cs.EllipsoidalCS createEllipsoidalCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1)
          Creates an ellipsoidal coordinate system without ellipsoidal height.
 org.opengis.referencing.cs.EllipsoidalCS createEllipsoidalCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1, org.opengis.referencing.cs.CoordinateSystemAxis axis2)
          Creates an ellipsoidal coordinate system with ellipsoidal height.
 org.opengis.referencing.crs.EngineeringCRS createEngineeringCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.EngineeringDatum datum, org.opengis.referencing.cs.CoordinateSystem cs)
          Creates a engineering coordinate reference system.
 org.opengis.referencing.datum.EngineeringDatum createEngineeringDatum(java.util.Map<java.lang.String,?> properties)
          Creates an engineering datum.
 org.opengis.referencing.datum.Ellipsoid createFlattenedSphere(java.util.Map<java.lang.String,?> properties, double semiMajorAxis, double inverseFlattening, javax.measure.unit.Unit<javax.measure.quantity.Length> unit)
          Creates an ellipsoid from an major radius, and inverse flattening.
 org.opengis.referencing.crs.CoordinateReferenceSystem createFromWKT(java.lang.String wkt)
          Creates a coordinate reference system object from a string.
 org.opengis.referencing.crs.CoordinateReferenceSystem createFromXML(java.lang.String xml)
          Creates a coordinate reference system object from a XML string.
 org.opengis.referencing.crs.GeocentricCRS createGeocentricCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.GeodeticDatum datum, org.opengis.referencing.cs.CartesianCS cs)
          Creates a geocentric coordinate reference system from a cartesian coordinate system.
 org.opengis.referencing.crs.GeocentricCRS createGeocentricCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.GeodeticDatum datum, org.opengis.referencing.cs.SphericalCS cs)
          Creates a geocentric coordinate reference system from a spherical coordinate system.
 org.opengis.referencing.datum.GeodeticDatum createGeodeticDatum(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.Ellipsoid ellipsoid, org.opengis.referencing.datum.PrimeMeridian primeMeridian)
          Creates geodetic datum from ellipsoid and (optionaly) Bursa-Wolf parameters.
 org.opengis.referencing.crs.GeographicCRS createGeographicCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.GeodeticDatum datum, org.opengis.referencing.cs.EllipsoidalCS cs)
          Creates a geographic coordinate reference system.
 org.opengis.referencing.crs.ImageCRS createImageCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.ImageDatum datum, org.opengis.referencing.cs.AffineCS cs)
          Creates an image coordinate reference system.
 org.opengis.referencing.datum.ImageDatum createImageDatum(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.PixelInCell pixelInCell)
          Creates an image datum.
 org.opengis.referencing.cs.LinearCS createLinearCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis)
          Creates a linear coordinate system.
 org.opengis.referencing.cs.PolarCS createPolarCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1)
          Creates a polar coordinate system from the given pair of axis.
 org.opengis.referencing.datum.PrimeMeridian createPrimeMeridian(java.util.Map<java.lang.String,?> properties, double longitude, javax.measure.unit.Unit<javax.measure.quantity.Angle> angularUnit)
          Creates a prime meridian, relative to Greenwich.
 org.opengis.referencing.crs.ProjectedCRS createProjectedCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.crs.GeographicCRS baseCRS, org.opengis.referencing.operation.Conversion conversionFromBase, org.opengis.referencing.cs.CartesianCS derivedCS)
          Creates a projected coordinate reference system from a conversion.
 org.opengis.referencing.crs.ProjectedCRS createProjectedCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.operation.OperationMethod method, org.opengis.referencing.crs.GeographicCRS base, org.opengis.referencing.operation.MathTransform baseToDerived, org.opengis.referencing.cs.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.
 org.opengis.referencing.cs.SphericalCS createSphericalCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1, org.opengis.referencing.cs.CoordinateSystemAxis axis2)
          Creates a spherical coordinate system from the given set of axis.
 org.opengis.referencing.crs.TemporalCRS createTemporalCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.TemporalDatum datum, org.opengis.referencing.cs.TimeCS cs)
          Creates a temporal coordinate reference system.
 org.opengis.referencing.datum.TemporalDatum createTemporalDatum(java.util.Map<java.lang.String,?> properties, java.util.Date origin)
          Creates a temporal datum from an enumerated type value.
 org.opengis.referencing.cs.TimeCS createTimeCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis)
          Creates a temporal coordinate system.
 org.opengis.referencing.cs.UserDefinedCS createUserDefinedCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1)
          Creates a two dimensional user defined coordinate system from the given pair of axis.
 org.opengis.referencing.cs.UserDefinedCS createUserDefinedCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis0, org.opengis.referencing.cs.CoordinateSystemAxis axis1, org.opengis.referencing.cs.CoordinateSystemAxis axis2)
          Creates a three dimensional user defined coordinate system from the given set of axis.
 org.opengis.referencing.crs.VerticalCRS createVerticalCRS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.VerticalDatum datum, org.opengis.referencing.cs.VerticalCS cs)
          Creates a vertical coordinate reference system.
 org.opengis.referencing.cs.VerticalCS createVerticalCS(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.cs.CoordinateSystemAxis axis)
          Creates a vertical coordinate system.
 org.opengis.referencing.datum.VerticalDatum createVerticalDatum(java.util.Map<java.lang.String,?> properties, org.opengis.referencing.datum.VerticalDatumType type)
          Creates a vertical datum from an enumerated type value.
 
Methods inherited from class org.geotools.referencing.factory.ReferencingFactory
ensureNonNull, getVendor
 
Methods inherited from class org.geotools.factory.AbstractFactory
addImplementationHints, equals, getImplementationHints, getPriority, hashCode, onDeregistration, onRegistration, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.opengis.referencing.Factory
getVendor
 
Methods inherited from interface org.geotools.factory.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 org.opengis.referencing.datum.Ellipsoid createEllipsoid(java.util.Map<java.lang.String,?> properties,
                                                               double semiMajorAxis,
                                                               double semiMinorAxis,
                                                               javax.measure.unit.Unit<javax.measure.quantity.Length> unit)
                                                        throws org.opengis.referencing.FactoryException
Creates an ellipsoid from radius values.

Specified by:
createEllipsoid in interface org.opengis.referencing.datum.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createFlattenedSphere

public org.opengis.referencing.datum.Ellipsoid createFlattenedSphere(java.util.Map<java.lang.String,?> properties,
                                                                     double semiMajorAxis,
                                                                     double inverseFlattening,
                                                                     javax.measure.unit.Unit<javax.measure.quantity.Length> unit)
                                                              throws org.opengis.referencing.FactoryException
Creates an ellipsoid from an major radius, and inverse flattening.

Specified by:
createFlattenedSphere in interface org.opengis.referencing.datum.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createPrimeMeridian

public org.opengis.referencing.datum.PrimeMeridian createPrimeMeridian(java.util.Map<java.lang.String,?> properties,
                                                                       double longitude,
                                                                       javax.measure.unit.Unit<javax.measure.quantity.Angle> angularUnit)
                                                                throws org.opengis.referencing.FactoryException
Creates a prime meridian, relative to Greenwich.

Specified by:
createPrimeMeridian in interface org.opengis.referencing.datum.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createGeodeticDatum

public org.opengis.referencing.datum.GeodeticDatum createGeodeticDatum(java.util.Map<java.lang.String,?> properties,
                                                                       org.opengis.referencing.datum.Ellipsoid ellipsoid,
                                                                       org.opengis.referencing.datum.PrimeMeridian primeMeridian)
                                                                throws org.opengis.referencing.FactoryException
Creates geodetic datum from ellipsoid and (optionaly) Bursa-Wolf parameters.

Specified by:
createGeodeticDatum in interface org.opengis.referencing.datum.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createVerticalDatum

public org.opengis.referencing.datum.VerticalDatum createVerticalDatum(java.util.Map<java.lang.String,?> properties,
                                                                       org.opengis.referencing.datum.VerticalDatumType type)
                                                                throws org.opengis.referencing.FactoryException
Creates a vertical datum from an enumerated type value.

Specified by:
createVerticalDatum in interface org.opengis.referencing.datum.DatumFactory
Parameters:
properties - Name and other properties to give to the new object.
type - The type of this vertical datum (often geoidal).
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createTemporalDatum

public org.opengis.referencing.datum.TemporalDatum createTemporalDatum(java.util.Map<java.lang.String,?> properties,
                                                                       java.util.Date origin)
                                                                throws org.opengis.referencing.FactoryException
Creates a temporal datum from an enumerated type value.

Specified by:
createTemporalDatum in interface org.opengis.referencing.datum.DatumFactory
Parameters:
properties - Name and other properties to give to the new object.
origin - The date and time origin of this temporal datum.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createEngineeringDatum

public org.opengis.referencing.datum.EngineeringDatum createEngineeringDatum(java.util.Map<java.lang.String,?> properties)
                                                                      throws org.opengis.referencing.FactoryException
Creates an engineering datum.

Specified by:
createEngineeringDatum in interface org.opengis.referencing.datum.DatumFactory
Parameters:
properties - Name and other properties to give to the new object.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createImageDatum

public org.opengis.referencing.datum.ImageDatum createImageDatum(java.util.Map<java.lang.String,?> properties,
                                                                 org.opengis.referencing.datum.PixelInCell pixelInCell)
                                                          throws org.opengis.referencing.FactoryException
Creates an image datum.

Specified by:
createImageDatum in interface org.opengis.referencing.datum.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createCoordinateSystemAxis

public org.opengis.referencing.cs.CoordinateSystemAxis createCoordinateSystemAxis(java.util.Map<java.lang.String,?> properties,
                                                                                  java.lang.String abbreviation,
                                                                                  org.opengis.referencing.cs.AxisDirection direction,
                                                                                  javax.measure.unit.Unit<?> unit)
                                                                           throws org.opengis.referencing.FactoryException
Creates a coordinate system axis from an abbreviation and a unit.

Specified by:
createCoordinateSystemAxis in interface org.opengis.referencing.cs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createCartesianCS

public org.opengis.referencing.cs.CartesianCS createCartesianCS(java.util.Map<java.lang.String,?> properties,
                                                                org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                                org.opengis.referencing.cs.CoordinateSystemAxis axis1)
                                                         throws org.opengis.referencing.FactoryException
Creates a two dimensional cartesian coordinate system from the given pair of axis.

Specified by:
createCartesianCS in interface org.opengis.referencing.cs.CSFactory
Parameters:
properties - Name and other properties to give to the new object.
axis0 - The first axis.
axis1 - The second axis.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createCartesianCS

public org.opengis.referencing.cs.CartesianCS createCartesianCS(java.util.Map<java.lang.String,?> properties,
                                                                org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                                org.opengis.referencing.cs.CoordinateSystemAxis axis1,
                                                                org.opengis.referencing.cs.CoordinateSystemAxis axis2)
                                                         throws org.opengis.referencing.FactoryException
Creates a three dimensional cartesian coordinate system from the given set of axis.

Specified by:
createCartesianCS in interface org.opengis.referencing.cs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createAffineCS

public org.opengis.referencing.cs.AffineCS createAffineCS(java.util.Map<java.lang.String,?> properties,
                                                          org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                          org.opengis.referencing.cs.CoordinateSystemAxis axis1)
                                                   throws org.opengis.referencing.FactoryException
Creates a two dimensional coordinate system from the given pair of axis.

Specified by:
createAffineCS in interface org.opengis.referencing.cs.CSFactory
Parameters:
properties - Name and other properties to give to the new object.
axis0 - The first axis.
axis1 - The second axis.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createAffineCS

public org.opengis.referencing.cs.AffineCS createAffineCS(java.util.Map<java.lang.String,?> properties,
                                                          org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                          org.opengis.referencing.cs.CoordinateSystemAxis axis1,
                                                          org.opengis.referencing.cs.CoordinateSystemAxis axis2)
                                                   throws org.opengis.referencing.FactoryException
Creates a three dimensional coordinate system from the given set of axis.

Specified by:
createAffineCS in interface org.opengis.referencing.cs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createPolarCS

public org.opengis.referencing.cs.PolarCS createPolarCS(java.util.Map<java.lang.String,?> properties,
                                                        org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                        org.opengis.referencing.cs.CoordinateSystemAxis axis1)
                                                 throws org.opengis.referencing.FactoryException
Creates a polar coordinate system from the given pair of axis.

Specified by:
createPolarCS in interface org.opengis.referencing.cs.CSFactory
Parameters:
properties - Name and other properties to give to the new object.
axis0 - The first axis.
axis1 - The second axis.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createCylindricalCS

public org.opengis.referencing.cs.CylindricalCS createCylindricalCS(java.util.Map<java.lang.String,?> properties,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis1,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis2)
                                                             throws org.opengis.referencing.FactoryException
Creates a cylindrical coordinate system from the given set of axis.

Specified by:
createCylindricalCS in interface org.opengis.referencing.cs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createSphericalCS

public org.opengis.referencing.cs.SphericalCS createSphericalCS(java.util.Map<java.lang.String,?> properties,
                                                                org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                                org.opengis.referencing.cs.CoordinateSystemAxis axis1,
                                                                org.opengis.referencing.cs.CoordinateSystemAxis axis2)
                                                         throws org.opengis.referencing.FactoryException
Creates a spherical coordinate system from the given set of axis.

Specified by:
createSphericalCS in interface org.opengis.referencing.cs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createEllipsoidalCS

public org.opengis.referencing.cs.EllipsoidalCS createEllipsoidalCS(java.util.Map<java.lang.String,?> properties,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis1)
                                                             throws org.opengis.referencing.FactoryException
Creates an ellipsoidal coordinate system without ellipsoidal height.

Specified by:
createEllipsoidalCS in interface org.opengis.referencing.cs.CSFactory
Parameters:
properties - Name and other properties to give to the new object.
axis0 - The first axis.
axis1 - The second axis.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createEllipsoidalCS

public org.opengis.referencing.cs.EllipsoidalCS createEllipsoidalCS(java.util.Map<java.lang.String,?> properties,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis1,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis2)
                                                             throws org.opengis.referencing.FactoryException
Creates an ellipsoidal coordinate system with ellipsoidal height.

Specified by:
createEllipsoidalCS in interface org.opengis.referencing.cs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createVerticalCS

public org.opengis.referencing.cs.VerticalCS createVerticalCS(java.util.Map<java.lang.String,?> properties,
                                                              org.opengis.referencing.cs.CoordinateSystemAxis axis)
                                                       throws org.opengis.referencing.FactoryException
Creates a vertical coordinate system.

Specified by:
createVerticalCS in interface org.opengis.referencing.cs.CSFactory
Parameters:
properties - Name and other properties to give to the new object.
axis - The axis.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createTimeCS

public org.opengis.referencing.cs.TimeCS createTimeCS(java.util.Map<java.lang.String,?> properties,
                                                      org.opengis.referencing.cs.CoordinateSystemAxis axis)
                                               throws org.opengis.referencing.FactoryException
Creates a temporal coordinate system.

Specified by:
createTimeCS in interface org.opengis.referencing.cs.CSFactory
Parameters:
properties - Name and other properties to give to the new object.
axis - The axis.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createLinearCS

public org.opengis.referencing.cs.LinearCS createLinearCS(java.util.Map<java.lang.String,?> properties,
                                                          org.opengis.referencing.cs.CoordinateSystemAxis axis)
                                                   throws org.opengis.referencing.FactoryException
Creates a linear coordinate system.

Specified by:
createLinearCS in interface org.opengis.referencing.cs.CSFactory
Parameters:
properties - Name and other properties to give to the new object.
axis - The axis.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createUserDefinedCS

public org.opengis.referencing.cs.UserDefinedCS createUserDefinedCS(java.util.Map<java.lang.String,?> properties,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis1)
                                                             throws org.opengis.referencing.FactoryException
Creates a two dimensional user defined coordinate system from the given pair of axis.

Specified by:
createUserDefinedCS in interface org.opengis.referencing.cs.CSFactory
Parameters:
properties - Name and other properties to give to the new object.
axis0 - The first axis.
axis1 - The second axis.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createUserDefinedCS

public org.opengis.referencing.cs.UserDefinedCS createUserDefinedCS(java.util.Map<java.lang.String,?> properties,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis0,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis1,
                                                                    org.opengis.referencing.cs.CoordinateSystemAxis axis2)
                                                             throws org.opengis.referencing.FactoryException
Creates a three dimensional user defined coordinate system from the given set of axis.

Specified by:
createUserDefinedCS in interface org.opengis.referencing.cs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createCompoundCRS

public org.opengis.referencing.crs.CompoundCRS createCompoundCRS(java.util.Map<java.lang.String,?> properties,
                                                                 org.opengis.referencing.crs.CoordinateReferenceSystem[] elements)
                                                          throws org.opengis.referencing.FactoryException
Creates a compound coordinate reference system from an ordered list of CoordinateReferenceSystem objects.

Specified by:
createCompoundCRS in interface org.opengis.referencing.crs.CRSFactory
Parameters:
properties - Name and other properties to give to the new object.
elements - ordered array of CoordinateReferenceSystem objects.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createEngineeringCRS

public org.opengis.referencing.crs.EngineeringCRS createEngineeringCRS(java.util.Map<java.lang.String,?> properties,
                                                                       org.opengis.referencing.datum.EngineeringDatum datum,
                                                                       org.opengis.referencing.cs.CoordinateSystem cs)
                                                                throws org.opengis.referencing.FactoryException
Creates a engineering coordinate reference system.

Specified by:
createEngineeringCRS in interface org.opengis.referencing.crs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createImageCRS

public org.opengis.referencing.crs.ImageCRS createImageCRS(java.util.Map<java.lang.String,?> properties,
                                                           org.opengis.referencing.datum.ImageDatum datum,
                                                           org.opengis.referencing.cs.AffineCS cs)
                                                    throws org.opengis.referencing.FactoryException
Creates an image coordinate reference system.

Specified by:
createImageCRS in interface org.opengis.referencing.crs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createTemporalCRS

public org.opengis.referencing.crs.TemporalCRS createTemporalCRS(java.util.Map<java.lang.String,?> properties,
                                                                 org.opengis.referencing.datum.TemporalDatum datum,
                                                                 org.opengis.referencing.cs.TimeCS cs)
                                                          throws org.opengis.referencing.FactoryException
Creates a temporal coordinate reference system.

Specified by:
createTemporalCRS in interface org.opengis.referencing.crs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createVerticalCRS

public org.opengis.referencing.crs.VerticalCRS createVerticalCRS(java.util.Map<java.lang.String,?> properties,
                                                                 org.opengis.referencing.datum.VerticalDatum datum,
                                                                 org.opengis.referencing.cs.VerticalCS cs)
                                                          throws org.opengis.referencing.FactoryException
Creates a vertical coordinate reference system.

Specified by:
createVerticalCRS in interface org.opengis.referencing.crs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createGeocentricCRS

public org.opengis.referencing.crs.GeocentricCRS createGeocentricCRS(java.util.Map<java.lang.String,?> properties,
                                                                     org.opengis.referencing.datum.GeodeticDatum datum,
                                                                     org.opengis.referencing.cs.CartesianCS cs)
                                                              throws org.opengis.referencing.FactoryException
Creates a geocentric coordinate reference system from a cartesian coordinate system.

Specified by:
createGeocentricCRS in interface org.opengis.referencing.crs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createGeocentricCRS

public org.opengis.referencing.crs.GeocentricCRS createGeocentricCRS(java.util.Map<java.lang.String,?> properties,
                                                                     org.opengis.referencing.datum.GeodeticDatum datum,
                                                                     org.opengis.referencing.cs.SphericalCS cs)
                                                              throws org.opengis.referencing.FactoryException
Creates a geocentric coordinate reference system from a spherical coordinate system.

Specified by:
createGeocentricCRS in interface org.opengis.referencing.crs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createGeographicCRS

public org.opengis.referencing.crs.GeographicCRS createGeographicCRS(java.util.Map<java.lang.String,?> properties,
                                                                     org.opengis.referencing.datum.GeodeticDatum datum,
                                                                     org.opengis.referencing.cs.EllipsoidalCS cs)
                                                              throws org.opengis.referencing.FactoryException
Creates a geographic coordinate reference system. It could be Latitude/Longitude or Longitude/Latitude.

Specified by:
createGeographicCRS in interface org.opengis.referencing.crs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createDerivedCRS

public org.opengis.referencing.crs.DerivedCRS createDerivedCRS(java.util.Map<java.lang.String,?> properties,
                                                               org.opengis.referencing.operation.OperationMethod method,
                                                               org.opengis.referencing.crs.CoordinateReferenceSystem base,
                                                               org.opengis.referencing.operation.MathTransform baseToDerived,
                                                               org.opengis.referencing.cs.CoordinateSystem derivedCS)
                                                        throws org.opengis.referencing.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:
org.opengis.referencing.FactoryException - if the object creation failed.

createDerivedCRS

public org.opengis.referencing.crs.DerivedCRS createDerivedCRS(java.util.Map<java.lang.String,?> properties,
                                                               org.opengis.referencing.crs.CoordinateReferenceSystem baseCRS,
                                                               org.opengis.referencing.operation.Conversion conversionFromBase,
                                                               org.opengis.referencing.cs.CoordinateSystem derivedCS)
                                                        throws org.opengis.referencing.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 org.opengis.referencing.crs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.
Since:
2.5

createProjectedCRS

public org.opengis.referencing.crs.ProjectedCRS createProjectedCRS(java.util.Map<java.lang.String,?> properties,
                                                                   org.opengis.referencing.operation.OperationMethod method,
                                                                   org.opengis.referencing.crs.GeographicCRS base,
                                                                   org.opengis.referencing.operation.MathTransform baseToDerived,
                                                                   org.opengis.referencing.cs.CartesianCS derivedCS)
                                                            throws org.opengis.referencing.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:
org.opengis.referencing.FactoryException - if the object creation failed.

createProjectedCRS

public org.opengis.referencing.crs.ProjectedCRS createProjectedCRS(java.util.Map<java.lang.String,?> properties,
                                                                   org.opengis.referencing.crs.GeographicCRS baseCRS,
                                                                   org.opengis.referencing.operation.Conversion conversionFromBase,
                                                                   org.opengis.referencing.cs.CartesianCS derivedCS)
                                                            throws org.opengis.referencing.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 org.opengis.referencing.crs.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.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.
Since:
2.5

createFromXML

public org.opengis.referencing.crs.CoordinateReferenceSystem createFromXML(java.lang.String xml)
                                                                    throws org.opengis.referencing.FactoryException
Creates a coordinate reference system object from a XML string.

Specified by:
createFromXML in interface org.opengis.referencing.crs.CRSFactory
Parameters:
xml - Coordinate reference system encoded in XML format.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.

createFromWKT

public org.opengis.referencing.crs.CoordinateReferenceSystem createFromWKT(java.lang.String wkt)
                                                                    throws org.opengis.referencing.FactoryException
Creates a coordinate reference system object from a string.

Specified by:
createFromWKT in interface org.opengis.referencing.crs.CRSFactory
Parameters:
wkt - Coordinate system encoded in Well-Known Text format.
Throws:
org.opengis.referencing.FactoryException - if the object creation failed.


Copyright © 1996-2010 Geotools. All Rights Reserved.