Module org.opengis.geoapi

Package org.opengis.referencing.crs

Interface EngineeringCRS

All Superinterfaces:

CoordinateReferenceSystem, IdentifiedObject, ReferenceSystem, SingleCRS

@UML(identifier="EngineeringCRS",
     specification=ISO_19111)
public interface EngineeringCRS
extends SingleCRS

A 1-, 2- or 3-dimensional CRS used locally. It can be divided into three broad categories:

• planet-fixed systems applied to engineering activities on or near the surface of the planet;
• CRSs on moving platforms such as road vehicles, vessels, aircraft, or spacecraft.
• CRSs used to describe spatial location internally on an image.

Planet-fixed engineering CRSs are commonly based on a simple flat-earth approximation of the planet's surface, and the effect of planet curvature on feature geometry is ignored: calculations on coordinates use simple plane arithmetic without any corrections for planet curvature.

Engineering CRSs used on moving platforms are subject to all the motions of the platform with which they are associated. In this case the associated coordinates are meaningful only relative to the moving platform. Transformation of coordinates from these moving engineering CRSs to planet-referenced CRSs involves time-dependent coordinate operation parameters.

Permitted coordinate systems

This type of CRS can be used with coordinate systems of type AffineCS, CartesianCS, CylindricalCS, LinearCS, PolarCS, SphericalCS.

Since:

1.0

See Also:

• CRSAuthorityFactory.createEngineeringCRS(String)
• CRSFactory.createEngineeringCRS(Map, EngineeringDatum, DatumEnsemble, CoordinateSystem)

Field Summary

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, DOMAINS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Fields inherited from interface org.opengis.referencing.ReferenceSystem

DOMAIN_OF_VALIDITY_KEY, SCOPE_KEY

Method Summary

Modifier and Type	Method	Description
EngineeringDatum	getDatum()	Returns the datum, which shall be an engineering one.
default DatumEnsemble<EngineeringDatum>	getDatumEnsemble()	Returns the datum ensemble, which shall have engineering datum members.

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getDomains, getIdentifiers, getName, getRemarks, toWKT

Methods inherited from interface org.opengis.referencing.ReferenceSystem

getDomainOfValidity, getScope

Methods inherited from interface org.opengis.referencing.crs.SingleCRS

getCoordinateSystem

Method Details

getDatum

@UML(identifier="datum",
     obligation=CONDITIONAL,
     specification=ISO_19111)
EngineeringDatum getDatum()

Returns the datum, which shall be an engineering one. This property may be null if this CRS is related to an object identified only by a datum ensemble.

Specified by:

getDatum in interface SingleCRS

Returns:

the engineering datum, or null if this CRS is related to an object identified only by a datum ensemble.

Condition:

Mandatory if the datum ensemble is not documented.

getDatumEnsemble

@UML(identifier="datum",
     obligation=CONDITIONAL,
     specification=ISO_19111)
default DatumEnsemble<EngineeringDatum> getDatumEnsemble()

Returns the datum ensemble, which shall have engineering datum members. This property may be null if this CRS is related to an object identified only by a single datum.

The default implementation returns null.

Specified by:

getDatumEnsemble in interface SingleCRS

Returns:

the datum ensemble, or null if this CRS is related to an object identified only by a single datum.

Since:

3.1

Condition:

Mandatory if the datum is not documented.