|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
ObjectAbstractFactory
ReferencingFactory
DatumAliases
public class DatumAliases
A datum factory that add aliases to a datum name before to
delegates the datum
creation to an other factory. Aliases are especially important for datum
since their name 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. Bursa-Wolf
parameters). Unfortunatly, different softwares often use different names for the same datum,
which result in OperationNotFoundException
when
attempting to convert coordinates from one coordinate
reference system 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 aliases property (as
generic names) 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 authority
factory or any WKT parser using this
factory will takes advantage of the aliases table.
modules/library/referencing (gt-referencing.jar)
Field Summary |
---|
Fields inherited from class ReferencingFactory |
---|
LOGGER |
Fields inherited from class AbstractFactory |
---|
hints, MAXIMUM_PRIORITY, MINIMUM_PRIORITY, NORMAL_PRIORITY, priority |
Constructor Summary | |
---|---|
DatumAliases()
Constructs a new datum factory with the default backing factory and alias table. |
|
DatumAliases(DatumFactory factory)
Constructs a new datum factory using the specified factory and the default alias table. |
|
DatumAliases(DatumFactory factory,
URL aliasURL)
Constructs a new datum factory which delegates its work to the specified factory. |
Method Summary | |
---|---|
Ellipsoid |
createEllipsoid(Map<String,?> properties,
double semiMajorAxis,
double semiMinorAxis,
Unit<Length> unit)
Creates an ellipsoid from radius values. |
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. |
GeodeticDatum |
createGeodeticDatum(Map<String,?> properties,
Ellipsoid ellipsoid,
PrimeMeridian primeMeridian)
Creates geodetic datum from ellipsoid and (optionaly) Bursa-Wolf parameters. |
ImageDatum |
createImageDatum(Map<String,?> properties,
PixelInCell pixelInCell)
Creates an image datum. |
PrimeMeridian |
createPrimeMeridian(Map<String,?> properties,
double longitude,
Unit<Angle> angularUnit)
Creates a prime meridian, relative to Greenwich. |
TemporalDatum |
createTemporalDatum(Map<String,?> properties,
Date origin)
Creates a temporal datum from an enumerated type value. |
VerticalDatum |
createVerticalDatum(Map<String,?> properties,
VerticalDatumType type)
Creates a vertical datum from an enumerated type value. |
void |
freeUnused()
Free all aliases that have been unused up to date. |
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 |
Constructor Detail |
---|
public DatumAliases()
public DatumAliases(DatumFactory factory)
factory
- The factory to use for datum creation.public DatumAliases(DatumFactory factory, URL aliasURL)
factory
- The factory to use for datum creation.aliasURL
- The url to the alias table.Method Detail |
---|
public EngineeringDatum createEngineeringDatum(Map<String,?> properties) throws FactoryException
createEngineeringDatum
in interface DatumFactory
properties
- Name and other properties to give to the new object.
FactoryException
- if the object creation failed.public GeodeticDatum createGeodeticDatum(Map<String,?> properties, Ellipsoid ellipsoid, PrimeMeridian primeMeridian) throws FactoryException
createGeodeticDatum
in interface DatumFactory
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.
FactoryException
- if the object creation failed.public ImageDatum createImageDatum(Map<String,?> properties, PixelInCell pixelInCell) throws FactoryException
createImageDatum
in interface DatumFactory
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.
FactoryException
- if the object creation failed.public TemporalDatum createTemporalDatum(Map<String,?> properties, Date origin) throws FactoryException
createTemporalDatum
in interface DatumFactory
properties
- Name and other properties to give to the new object.origin
- The date and time origin of this temporal datum.
FactoryException
- if the object creation failed.public VerticalDatum createVerticalDatum(Map<String,?> properties, VerticalDatumType type) throws FactoryException
createVerticalDatum
in interface DatumFactory
properties
- Name and other properties to give to the new object.type
- The type of this vertical datum (often geoidal).
FactoryException
- if the object creation failed.public Ellipsoid createEllipsoid(Map<String,?> properties, double semiMajorAxis, double semiMinorAxis, Unit<Length> unit) throws FactoryException
createEllipsoid
in interface DatumFactory
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.
FactoryException
- if the object creation failed.public Ellipsoid createFlattenedSphere(Map<String,?> properties, double semiMajorAxis, double inverseFlattening, Unit<Length> unit) throws FactoryException
createFlattenedSphere
in interface DatumFactory
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.
FactoryException
- if the object creation failed.public PrimeMeridian createPrimeMeridian(Map<String,?> properties, double longitude, Unit<Angle> angularUnit) throws FactoryException
createPrimeMeridian
in interface DatumFactory
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.
FactoryException
- if the object creation failed.public void freeUnused()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |