Package org.jscience.geography.coordinates.crs

Class CoordinateReferenceSystem<C extends Coordinates<?>>

  • All Implemented Interfaces:
    org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.IdentifiedObject, org.opengis.referencing.ReferenceSystem
    Direct Known Subclasses:
    CompoundCRS, GeocentricCRS, GeographicCRS, ProjectedCRS, TemporalCRS, VerticalCRS
    public abstract class CoordinateReferenceSystem<C extends Coordinates<?>>
extends Object
implements org.opengis.referencing.crs.CoordinateReferenceSystem
    This class represents an arbitrary system of reference for which coordinates of same significance can be stated.

    • Constructor Detail

      • CoordinateReferenceSystem

        public CoordinateReferenceSystem()

    • Method Detail

      • getConverterTo

        public <T extends Coordinates<?>> CoordinatesConverter<C,​T> getConverterTo​(CoordinateReferenceSystem<T> that)
        Returns the converter between this coordinate reference system and the one specified.
        Parameters:
        that - the coordinate reference system to convert to.
        Returns:
        the corresponding coordinates converter.
        Throws:
        ConversionException - if the conversion is not possible (e.g. geographic to temporal).

      • coordinatesOf

        protected abstract C coordinatesOf​(CoordinateReferenceSystem.AbsolutePosition position)
        Returns the coordinates in this reference system of the specified absolute position.
        Parameters:
        position - the absolute position for which the coordinates in this reference system is returned.
        Returns:
        the coordinates for the specified absolute position.
        Throws:
        ConversionException - if a conversion error occurs.

      • positionOf

        protected abstract CoordinateReferenceSystem.AbsolutePosition positionOf​(C coordinates,
                                                                         CoordinateReferenceSystem.AbsolutePosition position)
        Returns the absolute position from the coordinates in this reference system. This update may require information already supplied by the position. For example, the height for a pressure altitude might depends upon the latitude/longitude and the time.
        Parameters:
        coordinates - the coordinates for which the absolute position is adjusted.
        position - the position object to update.
        Returns:
        the corresponding absolute position.
        Throws:
        ConversionException - if a conversion error occurs.

      • getCoordinateSystem

        public abstract org.opengis.referencing.cs.CoordinateSystem getCoordinateSystem()
        Returns the OpenGIS coordinate system associated to this coordinate reference system.
        Specified by:
        getCoordinateSystem in interface org.opengis.referencing.crs.CoordinateReferenceSystem
        Returns:
        the corresponding coordinate system.

      • getValidArea

        public org.opengis.metadata.extent.Extent getValidArea()
        OpenGIS® - Area for which the (coordinate) reference system is valid.
        Specified by:
        getValidArea in interface org.opengis.referencing.ReferenceSystem
        Returns:
        coordinate reference system valid area, or null (default) if not available.

      • getScope

        public org.opengis.util.InternationalString getScope()
        OpenGIS® - Description of domain of usage, or limitations of usage, for which this (coordinate) reference system object is valid.
        Specified by:
        getScope in interface org.opengis.referencing.ReferenceSystem

      • getName

        public org.opengis.metadata.Identifier getName()
        OpenGIS® - The primary name by which this object is identified.
        Specified by:
        getName in interface org.opengis.referencing.IdentifiedObject
        Returns:
        an identifier holding the class name.

      • getAlias

        public Collection<String> getAlias()
        OpenGIS® - An alternative name by which this object is identified.
        Specified by:
        getAlias in interface org.opengis.referencing.IdentifiedObject
        Returns:
        The aliases, or an empty collection if there is none.

      • getIdentifiers

        public Set<String> getIdentifiers()
        OpenGIS® - An identifier which references elsewhere the object's defining information. Alternatively an identifier by which this object can be referenced.
        Specified by:
        getIdentifiers in interface org.opengis.referencing.IdentifiedObject
        Returns:
        This object identifiers, or an empty set if there is none.

      • getRemarks

        public org.opengis.util.InternationalString getRemarks()
        OpenGIS® - Comments on or information about this object, including data source information.
        Specified by:
        getRemarks in interface org.opengis.referencing.IdentifiedObject
        Returns:
        null (default).

      • toWKT

        public String toWKT()
             throws UnsupportedOperationException
        OpenGIS® - Returns a Well Known Text (WKT) for this object. This operation may fails if an object is too complex for the WKT format capability (for example an engineering CRS} with different unit for each axis).
        Specified by:
        toWKT in interface org.opengis.referencing.IdentifiedObject
        Returns:
        The Well Know Text for this object.
        Throws:
        UnsupportedOperationException - If this object can't be formatted as WKT (default).