Terrestrial Domain

Specification

The Terrestrial domain (tracktable::domain::terrestrial) concerns points on the surface of the Earth. These points are located using longitude and latitude. In Tracktable, longitude and latitude are always measured in degrees and longitude always comes first. We prefer to let longitude range from -180 to 180 but the underlying math doesn’t care.

Units

Position in the terrestrial domain is measured in degrees of longitude and latitude. Longitude is always coordinate 0 and latitude is always coordinate 1. Points are presumed to lie on the surface of the Earth. If you want to include altitude, use the user-defined properties.

Distances are measured in kilometers. Speeds are measured in kilometers per hour.

Module Contents

class TerrestrialPoint : public tracktable::PointLonLat 

2D point on a sphere

This class represents a point on a sphere. Its coordinates are measured in degrees of longitude and latitude.

Distances between TerrestrialPoints are measured in kilometers. Speeds between two TerrestrialTrajectoryPoints will be measured in kilometers per hour.

Subclassed by tracktable::TrajectoryPoint< TerrestrialPoint >

Public Types

using Superclass = PointLonLat 

Public Functions

TerrestrialPoint() = default: Create an uninitialized point.

TerrestrialPoint(TerrestrialPoint const &other) = default

Copy constructor: make this point like another

Parameters:: other – [in] Const point to make a copy of

TerrestrialPoint(TerrestrialPoint &&other) = default

Copy constructor: make this point like another

Parameters:: other – [in] Const point to make a copy of

inline TerrestrialPoint(Superclass const &other)

Copy constructor: use PointLonLat instances as if they were TerrestrialPoint instances

Parameters:: other – [in] Const point to make a copy of

~TerrestrialPoint() override = default: Empty destructor - nothing to do here.

inline TerrestrialPoint &operator=(TerrestrialPoint const &other): Explicitly delegate assignment to prevent compiler hijinks.

TerrestrialPoint &operator=(TerrestrialPoint &&other) = default

inline TerrestrialPoint(double _longitude, double _latitude)

Convenience constructor.

Parameters:

_longitude – [in] Longitude in degrees
_latitude – [in] Latitude in degrees

template<class Archive> inline void serialize(Archive &ar, const unsigned int)

Serialize the points to an archive

Parameters:

ar – [in] Archive to serialize to
version – [in] Version of the archive

Public Static Functions

static inline CartesianPoint3D ECEF_from_km(const coord_type _longitude, const coord_type _latitude, const double _altitude)

Returns ECEF values for lon, lat, and altitude. Uses a km convention.

Note

this expects an altitude in km (not ft or m).

Parameters:

_longitude – [in] Longitude in degrees
_latitude – [in] Latitude in degrees
_altitude – [in] Altitude in km

Returns:

3D Earth Centered, Earth Fixed point in km

Friends

friend class boost::serialization::access

class TerrestrialTrajectoryPoint : public tracktable::TrajectoryPoint<TerrestrialPoint>

Earth Centered Earth Fixed

This group of functions is useful for converting longitude and latitude to a cartesian point. A static method is provided to convert any arbitrary point. ECEF_from_feet will be the most common use case. Multiple functions will throw an exception if altitude is not present. To bypass exception throws, use ECEF(ratio,altString) with the appropriate ratio to convert to km and the name of the property you are expecting to find altitude in.