Interface CoordinateReferenceSystem

All Superinterfaces:

Identified­Object, Reference­System

All Known Subinterfaces:

Compound­CRS, Derived­CRS, Engineering­CRS, General­Derived­CRS, Geocentric­CRS, Geodetic­CRS, Geographic­CRS, Image­CRS, Projected­CRS, Single­CRS, Temporal­CRS, Vertical­CRS

All Known Implementing Classes:

Abstract­CRS, Default­Compound­CRS, Default­Derived­CRS, Default­Engineering­CRS, Default­Geocentric­CRS, Default­Geographic­CRS, Default­Parametric­CRS, Default­Projected­CRS, Default­Temporal­CRS, Default­Vertical­CRS

@UML(identifier="SC_CRS",
     specification=ISO_19111)
public interface CoordinateReferenceSystem
extends ReferenceSystem

Abstract coordinate reference system, usually defined by a coordinate system and a datum. The concept of a coordinate reference system (CRS) captures the choice of values for the parameters that constitute the degrees of freedom of the coordinate space. The fact that such a choice has to be made, either arbitrarily or by adopting values from survey measurements, leads to the large number of coordinate reference systems in use around the world. It is also the cause of the little understood fact that the latitude and longitude of a point are not unique. Without the full specification of the coordinate reference system, coordinates are ambiguous at best and meaningless at worst. However for some interchange purposes it is sufficient to confirm the identity of the system without necessarily having the full system definition.

The concept of coordinates may be expanded from a strictly spatial context to include time. Time is then added as another coordinate to the coordinate tuple. It is even possible to add two time-coordinates, provided the two coordinates describe different independent quantities. An example of the latter is the time/space position of a subsurface point of which the vertical coordinate is expressed as the two-way travel time of a sound signal in milliseconds, as is common in seismic imaging. A second time-coordinate indicates the time of observation, usually expressed in whole years.

Since:

1.0

Field Summary

Fields inherited from interface IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Modifier and Type	Field	Description
static final String	ALIAS_KEY	Key for the "alias" property to be given to the object factory create­Foo(…) methods.
static final String	IDENTIFIERS_KEY	Key for the "identifiers" property to be given to the object factory create­Foo(…) methods.
static final String	NAME_KEY	Key for the "name" property to be given to the object factory create­Foo(…) methods.
static final String	REMARKS_KEY	Key for the "remarks" property to be given to the object factory create­Foo(…) methods.

Fields inherited from interface ReferenceSystem

DOMAIN_OF_VALIDITY_KEY, SCOPE_KEY

Modifier and Type	Field	Description
static final String	DOMAIN_OF_VALIDITY_KEY	Key for the "domain­Of­Validity" property to be given to the object factory create­Foo(…) methods.
static final String	SCOPE_KEY	Key for the "scope" property to be given to the object factory create­Foo(…) methods.

Method Summary

Modifier and Type	Method	Description
Coordinate­System	get­Coordinate­System()	Returns a relevant coordinate system instance.

Methods inherited from interface IdentifiedObject

get­Alias, get­Identifiers, get­Name, get­Remarks, to­WKT

Modifier and Type	Method	Description
Collection<Generic­Name>	get­Alias()	An alternative name by which this object is identified.
Set<Reference­Identifier>	get­Identifiers()	An identifier which references elsewhere the object's defining information.
Reference­Identifier	get­Name()	The primary name by which this object is identified.
International­String	get­Remarks()	Comments on or information about this object, including data source information.
String	to­WKT()	Returns a Well Known Text (WKT) for this object.

Methods inherited from interface ReferenceSystem

get­Domain­Of­Validity, get­Scope

Modifier and Type	Method	Description
Extent	get­Domain­Of­Validity()	Area or region or timeframe in which this (coordinate) reference system is valid.
International­String	get­Scope()	Description of domain of usage, or limitations of usage, for which this Reference System object is valid.

Method Details

getCoordinateSystem

CoordinateSystem getCoordinateSystem()

Returns a relevant coordinate system instance. Special cases:

• If the CRS instance on which this method is invoked is an instance of the single CRS interface, then the CS instance which is returned shall be one of the defined sub-interfaces of coordinate system.

• If the CRS instance on which this method is invoked is an instance of the compound CRS interface, then the CS instance which is returned shall have dimension and axis components obtained from different components of the instance CRS.

Returns:

The coordinate system.