| org.geotools.referencing.factory.ReferencingFactory org.geotools.referencing.factory.DatumAliases
DatumAliases | public class DatumAliases extends ReferencingFactory implements DatumFactory(Code) | | A datum factory that add
to a datum name
before to delegates the
to an other
factory. Aliases are especially important for
since their
are often the only way to differentiate them.
Two datum with different names are considered incompatible, unless some datum shift method are
specified (e.g.
). Unfortunatly, different
softwares often use different names for the same datum,
which result in
OperationNotFoundException when attempting to convert coordinates from
one
to an other one. For
example "Nouvelle Triangulation Française (Paris)" and
"NTF (Paris meridian)" are actually the same datum. This
DatumAliases class provides a way to handle that.
DatumAliases is a class that determines if a datum name is in our list of aliases and
constructs a value for the
(as
) for a name. The default implementation is backed by
the text file "
DatumAliasesTable.txt ". The first line in this text file must be the
authority names. All other lines are the aliases.
Since
DatumAliases is a datum factory, any
or any
using this
factory will takes advantage of the aliases table.
since: 2.1 version: $Id: DatumAliases.java 25050 2007-04-06 00:41:49Z jgarnett $ author: Rueben Schulz author: Martin DesruisseauxDatumAliases.freeUnused reload() See Also: WKT problems |
Constructor Summary | |
public | DatumAliases() Constructs a new datum factory with the default backing factory and alias table. | public | DatumAliases(DatumFactory factory) Constructs a new datum factory using the specified factory and the default alias table. | public | DatumAliases(DatumFactory factory, URL aliasURL) Constructs a new datum factory which delegates its work to the specified factory.
The aliases table is read from the specified URL. |
Method Summary | |
public synchronized Ellipsoid | createEllipsoid(Map properties, double semiMajorAxis, double semiMinorAxis, Unit unit) Creates an ellipsoid from radius values. | public synchronized EngineeringDatum | createEngineeringDatum(Map properties) Creates an engineering datum. | public synchronized Ellipsoid | createFlattenedSphere(Map properties, double semiMajorAxis, double inverseFlattening, Unit unit) Creates an ellipsoid from an major radius, and inverse flattening. | public synchronized GeodeticDatum | createGeodeticDatum(Map properties, Ellipsoid ellipsoid, PrimeMeridian primeMeridian) Creates geodetic datum from ellipsoid and (optionaly) Bursa-Wolf parameters. | public synchronized ImageDatum | createImageDatum(Map properties, PixelInCell pixelInCell) Creates an image datum. | public synchronized PrimeMeridian | createPrimeMeridian(Map properties, double longitude, Unit angularUnit) Creates a prime meridian, relative to Greenwich. | public synchronized TemporalDatum | createTemporalDatum(Map properties, Date origin) Creates a temporal datum from an enumerated type value. | public synchronized VerticalDatum | createVerticalDatum(Map properties, VerticalDatumType type) Creates a vertical datum from an enumerated type value. | public synchronized void | freeUnused() Free all aliases that have been unused up to date. |
DatumAliases | public DatumAliases()(Code) | | Constructs a new datum factory with the default backing factory and alias table.
|
DatumAliases | public DatumAliases(DatumFactory factory)(Code) | | Constructs a new datum factory using the specified factory and the default alias table.
Parameters: factory - The factory to use for datum creation. |
DatumAliases | public DatumAliases(DatumFactory factory, URL aliasURL)(Code) | | Constructs a new datum factory which delegates its work to the specified factory.
The aliases table is read from the specified URL. The fist line in this file most
be the authority names. All other names are aliases.
Parameters: factory - The factory to use for datum creation. Parameters: aliasURL - The url to the alias table. |
createEllipsoid | public synchronized Ellipsoid createEllipsoid(Map properties, double semiMajorAxis, double semiMinorAxis, Unit unit) throws FactoryException(Code) | | Creates an ellipsoid from radius values.
Parameters: properties - Name and other properties to give to the new object. Parameters: semiMajorAxis - Equatorial radius in supplied linear units. Parameters: semiMinorAxis - Polar radius in supplied linear units. Parameters: unit - Linear units of ellipsoid axes. throws: FactoryException - if the object creation failed. |
createEngineeringDatum | public synchronized EngineeringDatum createEngineeringDatum(Map properties) throws FactoryException(Code) | | Creates an engineering datum.
Parameters: properties - Name and other properties to give to the new object. throws: FactoryException - if the object creation failed. |
createFlattenedSphere | public synchronized Ellipsoid createFlattenedSphere(Map properties, double semiMajorAxis, double inverseFlattening, Unit unit) throws FactoryException(Code) | | Creates an ellipsoid from an major radius, and inverse flattening.
Parameters: properties - Name and other properties to give to the new object. Parameters: semiMajorAxis - Equatorial radius in supplied linear units. Parameters: inverseFlattening - Eccentricity of ellipsoid. Parameters: unit - Linear units of major axis. throws: FactoryException - if the object creation failed. |
createGeodeticDatum | public synchronized GeodeticDatum createGeodeticDatum(Map properties, Ellipsoid ellipsoid, PrimeMeridian primeMeridian) throws FactoryException(Code) | | Creates geodetic datum from ellipsoid and (optionaly) Bursa-Wolf parameters.
Parameters: properties - Name and other properties to give to the new object. Parameters: ellipsoid - Ellipsoid to use in new geodetic datum. Parameters: primeMeridian - Prime meridian to use in new geodetic datum. throws: FactoryException - if the object creation failed. |
createImageDatum | public synchronized ImageDatum createImageDatum(Map properties, PixelInCell pixelInCell) throws FactoryException(Code) | | Creates an image datum.
Parameters: properties - Name and other properties to give to the new object. Parameters: pixelInCell - Specification of the way the image grid is associatedwith the image data attributes. throws: FactoryException - if the object creation failed. |
createPrimeMeridian | public synchronized PrimeMeridian createPrimeMeridian(Map properties, double longitude, Unit angularUnit) throws FactoryException(Code) | | Creates a prime meridian, relative to Greenwich.
Parameters: properties - Name and other properties to give to the new object. Parameters: longitude - Longitude of prime meridian in supplied angular units East of Greenwich. Parameters: angularUnit - Angular units of longitude. throws: FactoryException - if the object creation failed. |
createTemporalDatum | public synchronized TemporalDatum createTemporalDatum(Map properties, Date origin) throws FactoryException(Code) | | Creates a temporal datum from an enumerated type value.
Parameters: properties - Name and other properties to give to the new object. Parameters: origin - The date and time origin of this temporal datum. throws: FactoryException - if the object creation failed. |
createVerticalDatum | public synchronized VerticalDatum createVerticalDatum(Map properties, VerticalDatumType type) throws FactoryException(Code) | | Creates a vertical datum from an enumerated type value.
Parameters: properties - Name and other properties to give to the new object. Parameters: type - The type of this vertical datum (often “geoidal”). throws: FactoryException - if the object creation failed. |
freeUnused | public synchronized void freeUnused()(Code) | | Free all aliases that have been unused up to date. If one of those alias is needed at a
later time, the aliases table will be reloaded.
|
|
|