woss::CoordZ Class Reference

3D-Coordinates (lat, long, depth) class definitions and functions library More...

#include <coordinates-definitions.h>

Inheritance diagram for woss::CoordZ:

Collaboration diagram for woss::CoordZ:

Classes
class	CartCoords
	Class that represents cartesian coordinates. More...

Public Types
enum class	CoordZSpheroidType { COORDZ_SPHERE = 0 , COORDZ_GRS80 , COORDZ_WGS84 }
	Spheroid model to use. More...

Public Member Functions
constexpr	CoordZ (double lat=COORD_NOT_SET_VALUE, double lon=COORD_NOT_SET_VALUE, double z=COORD_NOT_SET_VALUE)
constexpr	CoordZ (const Coord &coords, double depth=COORD_NOT_SET_VALUE)
constexpr	CoordZ (const CoordZ &copy)=default
constexpr	CoordZ (CoordZ &&tmp)=default
constexpr void	setDepth (double d)
constexpr double	getDepth () const
constexpr CartCoords	getCartCoords (CoordZSpheroidType type=CoordZSpheroidType::COORDZ_SPHERE) const
constexpr double	getCartX (CoordZSpheroidType type=CoordZSpheroidType::COORDZ_SPHERE) const
constexpr double	getCartY (CoordZSpheroidType type=CoordZSpheroidType::COORDZ_SPHERE) const
constexpr double	getCartZ (CoordZSpheroidType type=CoordZSpheroidType::COORDZ_SPHERE) const
constexpr double	getSphericalRho () const
constexpr double	getSphericalTheta () const
constexpr double	getSphericalPhi () const
constexpr double	getCartDistance (const CoordZ &coords, CoordZSpheroidType type=CoordZSpheroidType::COORDZ_SPHERE) const
constexpr double	getCartRelZenith (const CoordZ &coords) const
constexpr double	getCartRelAzimuth (const CoordZ &coords) const
constexpr bool	isValid () const
constexpr CoordZ &	operator= (const CoordZ &coordz)=default
constexpr CoordZ &	operator= (CoordZ &&coordz)=default
Public Member Functions inherited from woss::Coord
constexpr	Coord (double lat=COORD_NOT_SET_VALUE, double lon=COORD_NOT_SET_VALUE)
constexpr	Coord (const Coord &copy)=default
constexpr	Coord (Coord &&tmp)=default
constexpr void	setLatitude (double lat)
constexpr void	setLongitude (double lon)
constexpr bool	isValid () const
constexpr double	getLatitude () const
constexpr double	getLongitude () const
constexpr int	getMarsdenSquare () const
constexpr int	getMarsdenOneDegreeSquare () const
constexpr MarsdenCoord	getMarsdenCoord () const
constexpr double	getInitialBearing (const Coord &destination) const
constexpr double	getFinalBearing (const Coord &destination) const
constexpr double	getGreatCircleDistance (const Coord &destination, double depth=0) const
constexpr Coord &	operator= (const Coord &copy)=default
constexpr Coord &	operator= (Coord &&tmp)=default

Static Public Member Functions
static constexpr CoordZ	getCoordZAlongCartLine (const CoordZ &start, const CoordZ &end, double distance)
static constexpr CoordZ	getCoordZAlongGreatCircle (const CoordZ &start, const CoordZ &end, double distance)
static constexpr CoordZ	getCoordZFromCartesianCoords (double x, double y, double z, CoordZSpheroidType type=CoordZSpheroidType::COORDZ_SPHERE)
static constexpr CoordZ	getCoordZFromCartesianCoords (const CartCoords &cart_coords)
static constexpr CoordZ	getCoordZFromSphericalCoords (double rho, double theta, double phi)
Static Public Member Functions inherited from woss::Coord
static constexpr Coord	getCoordFromBearing (const Coord &start_coord, double bearing, double distance, double depth=0.0)
static constexpr Coord	getCoordAlongGreatCircle (const Coord &start_coord, const Coord &end_coord, double distance, double depth=0.0)
static constexpr Coord	getCoordFromUtmWgs84 (double easting, double northing, double utm_zone_number, UtmZoneChar utm_zone_char)

Static Public Attributes
static constexpr double	COORDZ_MIN_DEPTH = 0.0
	Minimum valid depth.
Static Public Attributes inherited from woss::Coord
static constexpr double	COORD_MIN_LATITUDE = -90.0
	Minimum valid Latitude.
static constexpr double	COORD_MAX_LATITUDE = 90.0
	Maximum valid Latitude.
static constexpr double	COORD_MIN_LONGITUDE = -180.0
	Minimum valid Longitude.
static constexpr double	COORD_MAX_LONGITUDE = 180.0
	Maximum valid Longitude.
static constexpr double	EARTH_RADIUS = 6371000.0
	Mean earth radius in meters.
static constexpr double	EARTH_SEMIMAJOR_AXIS = 6378137.0
	Earth's semi-major axis in meters as defined by both GRS80 and WGS84.
static constexpr double	EARTH_GRS80_POLAR_RADIUS = 6356752.3141
	Earth's semi-major axis in meters as defined by GRS80.
static constexpr double	EARTH_WGS84_POLAR_RADIUS = 6356752.314245
	Earth's polar radius in meters as defined by WGS84.
static constexpr double	EARTH_GRS80_ECCENTRICITY = 0.0818191910428158
	Earth's first eccentricity as defined by GRS80.
static constexpr double	EARTH_WGS84_ECCENTRICITY = 0.0818191908426215
	Earth's first eccentricity as defined by WGS84.

Protected Attributes
double	depth
Protected Attributes inherited from woss::Coord
double	latitude
double	longitude
int	marsden_square
int	marsden_one_degree

Friends
constexpr CoordZ	operator+ (const CoordZ &left, const CoordZ &right)
constexpr CoordZ	operator- (const CoordZ &left, const CoordZ &right)
constexpr CoordZ &	operator+= (CoordZ &left, const CoordZ &right)
constexpr CoordZ &	operator-= (CoordZ &left, const CoordZ &right)
constexpr bool	operator== (const CoordZ &left, const CoordZ &right)
constexpr bool	operator!= (const CoordZ &left, const CoordZ &right)
constexpr bool	operator> (const CoordZ &left, const CoordZ &right)
constexpr bool	operator< (const CoordZ &left, const CoordZ &right)
constexpr bool	operator>= (const CoordZ &left, const CoordZ &right)
constexpr bool	operator<= (const CoordZ &left, const CoordZ &right)
std::ostream &	operator<< (std::ostream &os, const CoordZ &instance)

Additional Inherited Members
Protected Member Functions inherited from woss::Coord
constexpr void	updateMarsdenCoord ()
Static Protected Member Functions inherited from woss::Coord
static constexpr bool	isValidUtmZoneChar (UtmZoneChar utm_zone_char)

Detailed Description

3D-Coordinates (lat, long, depth) class definitions and functions library

CoordZ class inherit from Coord, adding a depth value

Member Enumeration Documentation

CoordZSpheroidType

enum class woss::CoordZ::CoordZSpheroidType

strong

Spheroid model to use.

Spheroid model to use: perfect sphere (CoordZSpheroidType::COORDZ_SPHERE), Geodetic Reference System 1980 (COORDZ_GRS80), or World Geodetic System 1984 (COORDZ_WGS84)

Enumerator
COORDZ_SPHERE
COORDZ_GRS80
COORDZ_WGS84

Constructor & Destructor Documentation

CoordZ() [1/4]

woss::CoordZ::CoordZ ( double lat = COORD_NOT_SET_VALUE, double lon = COORD_NOT_SET_VALUE, double z = COORD_NOT_SET_VALUE )

inlineconstexpr

CoordZ constructor.

Parameters

lat	decimal degree latitude value. Default value makes the instance not valid
lon	decimal degree longitude value. Default value makes the instance not valid
z	depth value in meters. Default value makes the instance not valid

References woss::Coord::Coord(), and depth.

Referenced by CoordZ(), CoordZ(), getCartDistance(), getCartRelAzimuth(), getCartRelZenith(), getCoordZAlongCartLine(), getCoordZAlongGreatCircle(), getCoordZFromCartesianCoords(), getCoordZFromCartesianCoords(), getCoordZFromSphericalCoords(), operator!=, operator+, operator+=, operator-, operator-=, operator<, operator<<, operator<=, operator=(), operator=(), operator==, operator>, and operator>=.

Here is the call graph for this function:

CoordZ() [2/4]

woss::CoordZ::CoordZ ( const Coord & coords, double depth = COORD_NOT_SET_VALUE )

inlineexplicitconstexpr

Explicit CoordZ constructor. No implicit cast from Coord to CoordZ is allowed.

Parameters

coords	a Coord reference
depth	depth value in meters. Default value makes the instance not valid

References woss::Coord::Coord(), and depth.

Here is the call graph for this function:

CoordZ() [3/4]

woss::CoordZ::CoordZ ( const CoordZ & copy )

constexprdefault

References CoordZ().

Here is the call graph for this function:

CoordZ() [4/4]

woss::CoordZ::CoordZ ( CoordZ && tmp )

constexprdefault

References CoordZ().

Here is the call graph for this function:

Member Function Documentation

getCartCoords()

CoordZ::CartCoords woss::CoordZ::getCartCoords ( CoordZSpheroidType type = CoordZSpheroidType::COORDZ_SPHERE ) const

inlineconstexpr

Gets cartesian x coordinate

Parameters

type	Earh Model type

Returns

x in meters

References COORDZ_GRS80, COORDZ_SPHERE, depth, woss::Coord::EARTH_GRS80_ECCENTRICITY, woss::Coord::EARTH_RADIUS, woss::Coord::EARTH_SEMIMAJOR_AXIS, woss::Coord::EARTH_WGS84_ECCENTRICITY, woss::Coord::latitude, and woss::Coord::longitude.

Referenced by WossCoordDefTest::doCoordCartTests(), getCartDistance(), getCartRelAzimuth(), getCartRelZenith(), getCartX(), getCartY(), getCartZ(), and getCoordZAlongCartLine().

getCartDistance()

double woss::CoordZ::getCartDistance ( const CoordZ & coords, CoordZSpheroidType type = CoordZSpheroidType::COORDZ_SPHERE ) const

inlineconstexpr

Gets the distance from cartesian coordinates approximations

Parameters

coords

a const reference to a valid CoordZ object

Returns

distance in meters

References CoordZ(), getCartCoords(), woss::CoordZ::CartCoords::getX(), woss::CoordZ::CartCoords::getY(), woss::CoordZ::CartCoords::getZ(), and isValid().

Referenced by WossMPropagation::computeGain(), WossCoordDefTest::doBearingTests(), WossCoordDefTest::doCoordCartTests(), getCartRelZenith(), WossMPropagation::getGain(), woss::WossManager::getWossPressure(), woss::WossManager::getWossPressure(), woss::WossManagerResDb::getWossPressure(), woss::WossManagerResDbMT::getWossPressure(), woss::WossManagerResDbMT::getWossPressure(), woss::WossManager::getWossTimeArr(), woss::WossManager::getWossTimeArr(), woss::WossManagerResDb::getWossTimeArr(), woss::WossManagerResDbMT::getWossTimeArr(), woss::WossManagerResDbMT::getWossTimeArr(), woss::Location::isEquivalentTo(), woss::CoordComparator< CompUser, CoordZ >::operator()(), and ChEstimatorPlugIn::recvSyncClMsg().

Here is the call graph for this function:

getCartRelAzimuth()

double woss::CoordZ::getCartRelAzimuth ( const CoordZ & coords ) const

inlineconstexpr

Gets relative azimuth from cartesian coordinates approximations, assuming earth as a sphere of ray = 6371000.0 meters

Returns

azimuth in radians

References CoordZ(), COORDZ_SPHERE, getCartCoords(), woss::CoordZ::CartCoords::getX(), woss::CoordZ::CartCoords::getY(), and isValid().

Referenced by getCoordZAlongCartLine().

Here is the call graph for this function:

getCartRelZenith()

double woss::CoordZ::getCartRelZenith ( const CoordZ & coords ) const

inlineconstexpr

Gets relative zenith from cartesian coordinates approximations, assuming earth as a sphere of ray = 6371000.0 meters

Returns

zenith in radians

References CoordZ(), COORDZ_SPHERE, getCartCoords(), getCartDistance(), woss::CoordZ::CartCoords::getZ(), and isValid().

Referenced by getCoordZAlongCartLine().

Here is the call graph for this function:

getCartX()

double woss::CoordZ::getCartX ( CoordZSpheroidType type = CoordZSpheroidType::COORDZ_SPHERE ) const

inlineconstexpr

Gets cartesian x coordinate

Parameters

type	Earh Model type

Returns

x in meters

References getCartCoords(), and woss::CoordZ::CartCoords::getX().

Referenced by woss::Location::getX(), WossPosition::WossPosition(), and woss::Transducer::writeVertBeamPattern().

Here is the call graph for this function:

getCartY()

double woss::CoordZ::getCartY ( CoordZSpheroidType type = CoordZSpheroidType::COORDZ_SPHERE ) const

inlineconstexpr

Gets cartesian y coordinate

Parameters

type	Earh Model type

Returns

y in meters

References getCartCoords(), and woss::CoordZ::CartCoords::getY().

Referenced by woss::Location::getY(), WossPosition::WossPosition(), and woss::Transducer::writeVertBeamPattern().

Here is the call graph for this function:

getCartZ()

double woss::CoordZ::getCartZ ( CoordZSpheroidType type = CoordZSpheroidType::COORDZ_SPHERE ) const

inlineconstexpr

Gets cartesian z coordinate

Parameters

type	Earh Model type

Returns

z in meters

References getCartCoords(), and woss::CoordZ::CartCoords::getZ().

Referenced by woss::Location::getZ(), WossPosition::WossPosition(), and woss::Transducer::writeVertBeamPattern().

Here is the call graph for this function:

getCoordZAlongCartLine()

CoordZ woss::CoordZ::getCoordZAlongCartLine ( const CoordZ & start, const CoordZ & end, double distance )

staticconstexpr

Gets The CoordZ at given distance along the line in cartesian coordinates, assuming earth as a sphere of ray = 6371000.0 meters that ties start and end CoordZ

Parameters

start	a const reference to a valid CoordZ object
end	a const reference to a valid CoordZ object
distance	travel distance in meters

Returns

a valid CoordZ object

References CoordZ(), COORDZ_SPHERE, depth, woss::Coord::EARTH_RADIUS, getCartCoords(), getCartRelAzimuth(), getCartRelZenith(), woss::CoordZ::CartCoords::getX(), woss::CoordZ::CartCoords::getY(), and woss::CoordZ::CartCoords::getZ().

Here is the call graph for this function:

getCoordZAlongGreatCircle()

CoordZ woss::CoordZ::getCoordZAlongGreatCircle ( const CoordZ & start, const CoordZ & end, double distance )

staticconstexpr

Gets The CoordZ at given distance along the great circle at starting CoordZ depth. The output depth is calculated uniformly between start and end depth that ties start and end CoordZ

Parameters

start	a const reference to a valid CoordZ object
end	a const reference to a valid CoordZ object
distance	travel distance in meters

Returns

a valid CoordZ object

References woss::Coord::Coord(), CoordZ(), woss::Coord::getCoordAlongGreatCircle(), getDepth(), and woss::Coord::getGreatCircleDistance().

Referenced by WossWpPosition::WayPoint::getCurrentPosition().

Here is the call graph for this function:

getCoordZFromCartesianCoords() [1/2]

CoordZ woss::CoordZ::getCoordZFromCartesianCoords ( const CartCoords & cart_coords )

inlinestaticconstexpr

Gets the CoordZ converted from given cartesian coordinates

Parameters

cart_coords

const reference to a valid CoordZ::CartCoords object

Returns

a valid CoordZ object

References CoordZ(), getCoordZFromCartesianCoords(), woss::CoordZ::CartCoords::getType(), woss::CoordZ::CartCoords::getX(), woss::CoordZ::CartCoords::getY(), and woss::CoordZ::CartCoords::getZ().

Here is the call graph for this function:

getCoordZFromCartesianCoords() [2/2]

CoordZ woss::CoordZ::getCoordZFromCartesianCoords ( double x, double y, double z, CoordZSpheroidType type = CoordZSpheroidType::COORDZ_SPHERE )

inlinestaticconstexpr

Gets the CoordZ converted from given cartesian coordinates

Parameters

x	x axis
y	y axis
z	z axis
type	Earth model type

Returns

a valid CoordZ object

References CoordZ(), COORDZ_GRS80, COORDZ_SPHERE, woss::Coord::EARTH_GRS80_POLAR_RADIUS, woss::Coord::EARTH_RADIUS, woss::Coord::EARTH_SEMIMAJOR_AXIS, woss::Coord::EARTH_WGS84_POLAR_RADIUS, woss::Coord::latitude, and woss::Coord::longitude.

Referenced by WossCoordDefTest::doCoordCartTests(), and getCoordZFromCartesianCoords().

Here is the call graph for this function:

getCoordZFromSphericalCoords()

CoordZ woss::CoordZ::getCoordZFromSphericalCoords ( double rho, double theta, double phi )

staticconstexpr

Gets the CoordZ converted from given spherical coordinates

Parameters

rho	radius
theta	theta angle
phi	phi angle

Returns

a valid CoordZ object

References CoordZ(), and woss::Coord::EARTH_RADIUS.

Here is the call graph for this function:

getDepth()

double woss::CoordZ::getDepth ( ) const

inlineconstexpr

Gets depth

Returns

depth in meters

References depth.

Referenced by woss::BellhopWoss::checkDepthOffsets(), getCoordZAlongGreatCircle(), woss::Location::getDepth(), WossChannelModule::getPropDelay(), WossWpPosition::WayPoint::getTimeOfArrival(), woss::WossManager::getWossPressure(), woss::WossManagerResDb::getWossPressure(), woss::WossManagerResDbMT::getWossPressure(), woss::WossManager::getWossTimeArr(), woss::WossManagerResDb::getWossTimeArr(), woss::WossManagerResDbMT::getWossTimeArr(), woss::Location::operator<<, WossUnitTest::testCoordZ(), WossWpPosition::updateVerticalOrientation(), and WossPosition::WossPosition().

getSphericalPhi()

double woss::CoordZ::getSphericalPhi ( ) const

inlineconstexpr

Gets spherical phi coordinate, assuming earth as a sphere of ray = 6371000.0 meters

Returns

z in meters

References woss::Coord::longitude.

Referenced by woss::Transducer::writeVertBeamPattern().

getSphericalRho()

double woss::CoordZ::getSphericalRho ( ) const

inlineconstexpr

Gets spherical rho coordinate, assuming earth as a sphere of ray = 6371000.0 meters

Returns

x in meters

References depth, and woss::Coord::EARTH_RADIUS.

getSphericalTheta()

double woss::CoordZ::getSphericalTheta ( ) const

inlineconstexpr

Gets spherical theta coordinate, assuming earth as a sphere of ray = 6371000.0 meters

Returns

y in meters

References woss::Coord::latitude.

Referenced by woss::Transducer::writeVertBeamPattern().

isValid()

bool woss::CoordZ::isValid ( ) const

inlineconstexpr

Checks the validity of coordinates and depth provided

Returns

true if coordinates and depth are valid, false otherwise

References COORDZ_MIN_DEPTH, depth, and woss::Coord::isValid().

Referenced by WossCoordDefTest::doCoordCartTests(), WossCoordDefTest::doRun(), getCartDistance(), getCartRelAzimuth(), getCartRelZenith(), woss::ACToolboxWoss::initCoordZVector(), woss::Location::isEquivalentTo(), operator+, operator+=, operator-, operator-=, and woss::Woss::Woss().

Here is the call graph for this function:

operator=() [1/2]

CoordZ & woss::CoordZ::operator= ( const CoordZ & coordz )

constexprdefault

Assignment operator

Parameters

copy	const reference to a CoordZ object to be copied

Returns

CoordZ reference to this

References CoordZ().

Here is the call graph for this function:

operator=() [2/2]

CoordZ & woss::CoordZ::operator= ( CoordZ && coordz )

constexprdefault

Move assignment operator

Parameters

copy	rvalue reference to a CoordZ object to be moved

Returns

CoordZ reference to this

References CoordZ().

Here is the call graph for this function:

setDepth()

void woss::CoordZ::setDepth ( double d )

inlineconstexpr

Sets depth

Parameters

d	depth in meters

References depth.

Referenced by woss::ACToolboxWoss::initCoordZVector().

Friends And Related Symbol Documentation

operator!=

bool operator!= ( const CoordZ & left, const CoordZ & right )

friend

Inequality operator

Parameters

left	left operand const reference
right	right operand const reference

Returns

true if left != right, false otherwise

References CoordZ(), depth, woss::Coord::latitude, and woss::Coord::longitude.

operator+

CoordZ operator+ ( const CoordZ & left, const CoordZ & right )

friend

Sum operator

Parameters

left	left operand const reference
right	right operand const reference

Returns

a new const instance holding the operation result

References CoordZ(), depth, isValid(), woss::Coord::latitude, and woss::Coord::longitude.

operator+=

CoordZ & operator+= ( CoordZ & left, const CoordZ & right )

friend

Compound assignment sum operator

Parameters

left	left operand reference
right	right operand const reference

Returns

left reference after the operation

References CoordZ(), depth, isValid(), woss::Coord::latitude, and woss::Coord::longitude.

operator-

CoordZ operator- ( const CoordZ & left, const CoordZ & right )

friend

Subtraction operator

Parameters

left	left operand const reference
right	right operand const reference

Returns

a new const instance holding the operation result

References CoordZ(), depth, isValid(), woss::Coord::latitude, and woss::Coord::longitude.

operator-=

CoordZ & operator-= ( CoordZ & left, const CoordZ & right )

friend

Compound assignment subtraction operator

Parameters

left	left operand reference
right	right operand const reference

Returns

left reference after the operation

References CoordZ(), depth, isValid(), woss::Coord::latitude, and woss::Coord::longitude.

operator<

bool operator< ( const CoordZ & left, const CoordZ & right )

friend

Less than operator

Parameters

left	left operand const reference
right	right operand const reference

Returns

true if left < right, false otherwise

References CoordZ(), depth, woss::Coord::latitude, and woss::Coord::longitude.

operator<<

std::ostream & operator<< ( std::ostream & os, const CoordZ & instance )

friend

<< operator

Parameters

os	left operand ostream reference
instance	right operand const CoordZ reference

Returns

os reference after the operation

References CoordZ(), depth, woss::Coord::latitude, woss::Coord::longitude, woss::Coord::marsden_one_degree, and woss::Coord::marsden_square.

operator<=

bool operator<= ( const CoordZ & left, const CoordZ & right )

friend

Less than or equal to operator

Parameters

left	left operand const reference
right	right operand const reference

Returns

true if left <= right, false otherwise

References CoordZ().

operator==

bool operator== ( const CoordZ & left, const CoordZ & right )

friend

Equality operator

Parameters

left	left operand const reference
right	right operand const reference

Returns

true if left == right, false otherwise

References CoordZ(), depth, woss::Coord::latitude, and woss::Coord::longitude.

operator>

bool operator> ( const CoordZ & left, const CoordZ & right )

friend

Greater than operator

Parameters

left	left operand const reference
right	right operand const reference

Returns

true if left > right, false otherwise

References CoordZ(), depth, woss::Coord::latitude, and woss::Coord::longitude.

operator>=

bool operator>= ( const CoordZ & left, const CoordZ & right )

friend

Greater than or equal to operator

Parameters

left	left operand const reference
right	right operand const reference

Returns

true if left >= right, false otherwise

References CoordZ().

Member Data Documentation

COORDZ_MIN_DEPTH

double woss::CoordZ::COORDZ_MIN_DEPTH = 0.0

staticconstexpr

Minimum valid depth.

Referenced by isValid().

depth

double woss::CoordZ::depth

protected

Depth value

Referenced by CoordZ(), CoordZ(), getCartCoords(), getCoordZAlongCartLine(), getDepth(), getSphericalRho(), isValid(), operator!=, operator+, operator+=, operator-, operator-=, operator<, operator<<, operator==, operator>, and setDepth().

---

The documentation for this class was generated from the following file:

• woss/woss_def/coordinates-definitions.h