Module org.opengis.geoapi

Package org.opengis.referencing.datum

Interface DynamicReferenceFrame

All Superinterfaces:

Datum, IdentifiedObject

@Classifier(ABSTRACT)
public interface DynamicReferenceFrame
extends Datum

Reference frame in which some of the defining parameters have time dependency. The time-varying parameters can describe time evolution of defining station coordinates. Examples:

• Horizontally: defining station coordinates having linear velocities to account for crustal motion.
• Vertically: defining station heights having velocity to account for post-glacial isostatic rebound motion.

This interface should not be implemented alone, but combined with the GeodeticDatum or VerticalDatum interface using multi-inheritance of interfaces.

Since:

3.1

Departure from OGC/ISO standard for harmonization between different specifications

ISO 19111 defines two distinct interfaces, DynamicGeodeticReferenceFrame and DynamicVerticalReferenceFrame. GeoAPI defines a single interface for all cases, with the requirement that implementers shall combine this interface with GeodeticReferenceFrame or VerticalReferenceFrame respectively using multi-inheritance of interfaces. This is a design similar to org.opengis.referencing.crs.DerivedCRS.

Field Summary

Fields inherited from interface org.opengis.referencing.datum.Datum

ANCHOR_DEFINITION_KEY, ANCHOR_EPOCH_KEY, ANCHOR_POINT_KEY, CONVENTIONAL_RS_KEY, DOMAIN_OF_VALIDITY_KEY, PUBLICATION_DATE_KEY, REALIZATION_EPOCH_KEY, SCOPE_KEY

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, DOMAINS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Method Summary

Modifier and Type	Method	Description
Temporal	getFrameReferenceEpoch()	Returns the epoch to which the coordinates of stations defining the dynamic geodetic reference frame are referenced.

Methods inherited from interface org.opengis.referencing.datum.Datum

getAnchorDefinition, getAnchorEpoch, getAnchorPoint, getConventionalRS, getDomainOfValidity, getPublicationDate, getRealizationEpoch, getScope

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getDomains, getIdentifiers, getName, getRemarks, toWKT

Method Details

getFrameReferenceEpoch

@UML(identifier="frameReferenceEpoch",
     obligation=MANDATORY,
     specification=ISO_19111)
Temporal getFrameReferenceEpoch()

Returns the epoch to which the coordinates of stations defining the dynamic geodetic reference frame are referenced.

Temporal object type

The type of the returned object depends on the epoch accuracy and the calendar in use. For reference frames relative to the Earth, the temporal type should be Year if the epoch is merely a year, YearMonth or LocalDate if a better precision is available, up to OffsetDateTime or Instant for maximal precision. For reference frames relative to another planet, the time measurement may use a non-Gregorian calendar. In the latter case, the type of the returned temporal object is currently implementation dependent.

Returns:

epoch to which the coordinates of stations defining the dynamic geodetic reference frame are referenced.

See Also:

• CoordinateMetadata.getCoordinateEpoch()
• CoordinateOperation.getSourceEpoch()
• CoordinateOperation.getTargetEpoch()