| org.geotools.referencing.AbstractIdentifiedObject org.geotools.referencing.datum.AbstractDatum
All known Subclasses: org.geotools.referencing.datum.DefaultEngineeringDatum, org.geotools.referencing.datum.DefaultTemporalDatum, org.geotools.referencing.datum.DefaultVerticalDatum, org.geotools.referencing.datum.DefaultGeodeticDatum, org.geotools.referencing.datum.DefaultImageDatum,
AbstractDatum | public class AbstractDatum extends AbstractIdentifiedObject implements Datum(Code) | | Specifies the relationship of a coordinate system to the earth, thus creating a
. A datum
uses a parameter or set of parameters that determine the location of the origin of the coordinate
reference system. Each datum subtype can be associated with only specific types of
.
A datum can be defined as a set of real points on the earth that have coordinates.
The definition of the datum may also include the temporal behavior (such as the
rate of change of the orientation of the coordinate axes).
This class is conceptually abstract, even if it is technically possible to
instantiate it. Typical applications should create instances of the most specific subclass with
Default prefix instead. An exception to this rule may occurs when it is not possible to
identify the exact type.
version: $Id: AbstractDatum.java 28264 2007-12-05 21:53:08Z desruisseaux $ author: Martin Desruisseaux since: 2.1 See Also: org.geotools.referencing.cs.AbstractCS See Also: org.geotools.referencing.crs.AbstractCRS |
Constructor Summary | |
public | AbstractDatum(Datum datum) Constructs a new datum with the same values than the specified one.
This copy constructor provides a way to wrap an arbitrary implementation into a
Geotools one or a user-defined one (as a subclass), usually in order to leverage
some implementation-specific API. | public | AbstractDatum(Map properties) Constructs a datum from a set of properties. |
Method Summary | |
public boolean | equals(AbstractIdentifiedObject object, boolean compareMetadata) Compares the specified object with this datum for equality.
Parameters: object - The object to compare to this . Parameters: compareMetadata - true for performing a strict comparaison, or false for comparing only properties relevant to transformations. | protected String | formatWKT(Formatter formatter) Format the inner part of a
Well
Known Text (WKT) element.
Note: All subclasses will override this method, but only
DefaultGeodeticDatum will
not invokes this parent method, because horizontal datum do not write
the datum type.
Parameters: formatter - The formatter to use. | public InternationalString | getAnchorPoint() Description, possibly including coordinates, of the point or points used to anchor the datum
to the Earth. | public Extent | getDomainOfValidity() Area or region or timeframe in which this datum is valid. | int | getLegacyDatumType() Gets the type of the datum as an enumerated code. | public Date | getRealizationEpoch() The time after which this datum definition is valid. | public InternationalString | getScope() Description of domain of usage, or limitations of usage, for which this
datum object is valid. | public Extent | getValidArea() Area or region in which this datum object is valid. |
AbstractDatum | public AbstractDatum(Datum datum)(Code) | | Constructs a new datum with the same values than the specified one.
This copy constructor provides a way to wrap an arbitrary implementation into a
Geotools one or a user-defined one (as a subclass), usually in order to leverage
some implementation-specific API. This constructor performs a shallow copy,
i.e. the properties are not cloned.
since: 2.2 |
AbstractDatum | public AbstractDatum(Map properties)(Code) | | Constructs a datum from a set of properties. The properties given in argument follow
the same rules than for the
. Additionally, the following properties are understood by this
construtor:
|
equals | public boolean equals(AbstractIdentifiedObject object, boolean compareMetadata)(Code) | | Compares the specified object with this datum for equality.
Parameters: object - The object to compare to this . Parameters: compareMetadata - true for performing a strict comparaison, or false for comparing only properties relevant to transformations. true if both objects are equal. |
formatWKT | protected String formatWKT(Formatter formatter)(Code) | | Format the inner part of a
Well
Known Text (WKT) element.
Note: All subclasses will override this method, but only
DefaultGeodeticDatum will
not invokes this parent method, because horizontal datum do not write
the datum type.
Parameters: formatter - The formatter to use. The WKT element name. |
getAnchorPoint | public InternationalString getAnchorPoint()(Code) | | Description, possibly including coordinates, of the point or points used to anchor the datum
to the Earth. Also known as the "origin", especially for Engineering and Image Datums.
- For a geodetic datum, this point is also known as the fundamental point, which is
traditionally the point where the relationship between geoid and ellipsoid is defined.
In some cases, the "fundamental point" may consist of a number of points. In those
cases, the parameters defining the geoid/ellipsoid relationship have then been averaged
for these points, and the averages adopted as the datum definition.
- For an engineering datum, the anchor point may be a physical point, or it may be a
point with defined coordinates in another CRS.
- For an image datum, the anchor point is usually either the centre of the image or the
corner of the image.
- For a temporal datum, this attribute is not defined. Instead of the anchor point,
a temporal datum carries a separate time origin of type
Date .
|
getDomainOfValidity | public Extent getDomainOfValidity()(Code) | | Area or region or timeframe in which this datum is valid.
since: 2.4 |
getLegacyDatumType | int getLegacyDatumType()(Code) | | Gets the type of the datum as an enumerated code. Datum type was provided
for all kind of datum in the legacy OGC 01-009 specification. In the new
OGC 03-73 (ISO 19111) specification, datum type is provided only for
vertical datum. Nevertheless, we keep this method around since it is
needed for WKT formatting. Note that we returns the datum type ordinal
value, not the code list object.
|
getRealizationEpoch | public Date getRealizationEpoch()(Code) | | The time after which this datum definition is valid. This time may be precise (e.g. 1997
for IRTF97) or merely a year (e.g. 1983 for NAD83). In the latter case, the epoch usually
refers to the year in which a major recalculation of the geodetic control network, underlying
the datum, was executed or initiated. An old datum can remain valid after a new datum is
defined. Alternatively, a datum may be superseded by a later datum, in which case the
realization epoch for the new datum defines the upper limit for the validity of the
superseded datum.
|
getScope | public InternationalString getScope()(Code) | | Description of domain of usage, or limitations of usage, for which this
datum object is valid.
|
Methods inherited from org.geotools.referencing.AbstractIdentifiedObject | protected static Set asSet(Object[] array)(Code)(Java Doc) protected static void ensureAngularUnit(Unit unit) throws IllegalArgumentException(Code)(Java Doc) protected static void ensureLinearUnit(Unit unit) throws IllegalArgumentException(Code)(Java Doc) protected static void ensureNonNull(String name, Object object) throws IllegalArgumentException(Code)(Java Doc) protected static void ensureNonNull(String name, Object[] array, int index) throws IllegalArgumentException(Code)(Java Doc) protected static void ensureTimeUnit(Unit unit) throws IllegalArgumentException(Code)(Java Doc) final public boolean equals(Object object)(Code)(Java Doc) public boolean equals(AbstractIdentifiedObject object, boolean compareMetadata)(Code)(Java Doc) protected static boolean equals(IdentifiedObject object1, IdentifiedObject object2, boolean compareMetadata)(Code)(Java Doc) protected static boolean equals(IdentifiedObject[] array1, IdentifiedObject[] array2, boolean compareMetadata)(Code)(Java Doc) protected static boolean equals(Collection collection1, Collection collection2, boolean compareMetadata)(Code)(Java Doc) public Collection getAlias()(Code)(Java Doc) public ReferenceIdentifier getIdentifier(Citation authority)(Code)(Java Doc) public static ReferenceIdentifier getIdentifier(IdentifiedObject info, Citation authority)(Code)(Java Doc) public Set getIdentifiers()(Code)(Java Doc) public ReferenceIdentifier getName()(Code)(Java Doc) public String getName(Citation authority)(Code)(Java Doc) public static String getName(IdentifiedObject info, Citation authority)(Code)(Java Doc) public static Map getProperties(IdentifiedObject info)(Code)(Java Doc) public static Map getProperties(IdentifiedObject info, Citation authority)(Code)(Java Doc) public InternationalString getRemarks()(Code)(Java Doc) public int hashCode()(Code)(Java Doc) public boolean nameMatches(String name)(Code)(Java Doc) public static boolean nameMatches(IdentifiedObject object, String name)(Code)(Java Doc) public static boolean nameMatches(IdentifiedObject o1, IdentifiedObject o2)(Code)(Java Doc)
|
|
|