Distance measurement, usually in meters. More...

#include <Distance.h>

Collaboration diagram for Isis::Distance:

Public Types
enum	Units { Meters, Kilometers, Pixels, SolarRadii }
	This is a list of available units to access and store Distances in. More...

Public Member Functions
	Distance ()
	This initializes the distance to an invalid state. More...

	Distance (double distance, Units distanceUnit)
	This is the general purpose constructor for Distance. More...

	Distance (double distanceInPixels, double pixelsPerMeter)
	This is a constructor for Distance given pixels with a conversion ratio. More...

	Distance (const Distance &distanceToCopy)
	This is the copy constructor for Distance. More...

virtual	~Distance ()
	This will free the memory allocated by this instance of the Distance class. More...

double	meters () const
	Get the distance in meters. More...

void	setMeters (double distanceInMeters)
	Set the distance in meters. More...

double	kilometers () const
	Get the distance in kilometers. More...

void	setKilometers (double distanceInKilometers)
	Set the distance in kilometers. More...

double	pixels (double pixelsPerMeter=1.0) const
	Get the distance in pixels using the given conversion ratio. More...

void	setPixels (double distanceInPixels, double pixelsPerMeter=1.0)
	Set the distance in pixels. More...

double	solarRadii () const
	Get the distance in solar radii (a unit of ~696,265km). More...

void	setSolarRadii (double distanceInSolarRadii)
	Set the distance in solar radii. More...

QString	toString () const
	Get a textual representation of this distance. More...

bool	isValid () const
	Test if this distance has been initialized or not. More...

bool	operator> (const Distance &otherDistance) const
	Compare two distances with the greater than operator. More...

bool	operator< (const Distance &otherDistance) const
	Compare two distances with the less than operator. More...

bool	operator>= (const Distance &otherDistance) const
	Compare two distances with the greater than or equal to operator. More...

bool	operator<= (const Distance &otherDistance) const
	Compare two distances with the less than or equal to operator. More...

bool	operator== (const Distance &otherDistance) const
	Compare two distances with the == operator. More...

bool	operator!= (const Distance &otherDistance) const
	Compare two distances with the != operator. More...

Distance &	operator= (const Distance &distanceToCopy)
	Assign this distance to the value of another distance. More...

Distance	operator+ (const Distance &distanceToAdd) const
	Add another distance to this distance (1km + 1m = 1005m) More...

Displacement	operator- (const Distance &distanceToSub) const
	Subtract another distance from this distance (1km - 1m = 995m). More...

double	operator/ (const Distance &distanceToDiv) const
	Divide another distance into this distance (5m / 1m = 5). More...

Distance	operator/ (const double &valueToDiv) const
	Divide a value from this distance (5m / 2 = 2.5m). More...

Distance	operator* (const double &valueToMult) const
	Multiply this distance by a value (5m * 2 = 10m). More...

void	operator+= (const Distance &distanceToAdd)
	Add and assign the given distance to ourselves. More...

void	operator-= (const Distance &distanceToSub)
	Subtract and assign the given distance from ourself. More...

void	operator/= (const double &valueToDiv)
	Divide this distance by a value and assign the result to ourself. More...

void	operator*= (const double &valueToMult)
	Multiply this distance by a value and assign the result to ourself. More...

Protected Member Functions
virtual double	distance (Units distanceUnit) const
	This is a helper method to access distances in a universal manner with uniform error checking. More...

virtual void	setDistance (const double &distance, Units distanceUnit)
	This is a helper method to set distances in a universal manner with uniform error checking. More...

Private Attributes
double	m_distanceInMeters
	This is the distance value that this class is encapsulating, always stored in meters. More...

Friends
Distance	operator* (double mult, Distance dist)
	Multiply this distance by a value (5m * 2 = 10m). More...

Detailed Description

Distance measurement, usually in meters.

This class is designed to encapsulate the concept of a distance. This is typically used for Radius and XYZ values but is also available as a general purpose class. This class does not accept negative values.

Author: 2010-10-12 Steven Lambright

History:: 2011-04-18 Steven Lambright Improved special pixel math handling

History:: 2012-02-16 Steven Lambright - Brought up to method and member naming standards.

History:: 2012-03-22 Steven Lambright - Added toString().

History:: 2012-03-22 Steven Lambright - Added solarRadii(), setSolarRadii(), and the unit SolarRadii. References #1232.

Definition at line 34 of file Distance.h.

Member Enumeration Documentation

◆ Units

enum Isis::Distance::Units

This is a list of available units to access and store Distances in.

These values can be passed to the constructor to specify which unit the double you are passing in is in.

Enumerator
Meters	The distance is being specified in meters.
Kilometers	The distance is being specified in kilometers.
Pixels	The distance is being specified in pixels.
SolarRadii	"Solar radius is a unit of distance used to express the size of stars in astronomy equal to the current radius of the Sun. " We're using 6.959910^8 meters, because that's the actual unit value, even though the radius has been more accurately calculated to 6.9634210^8 m. http://en.wikipedia.org/wiki/Solar_radius http://www.astro.wisc.edu/~dolan/constants.html https://www.cfa.harvard.edu/~dfabricant/huchra/ay145/constants.html

Definition at line 41 of file Distance.h.

Constructor & Destructor Documentation

◆ Distance() [1/4]

Isis::Distance::Distance ( )

This initializes the distance to an invalid state.

You must set the distance later on with operator= or one of the Set methods.

Definition at line 21 of file Distance.cpp.

References Meters, Isis::Null, and setDistance().

Referenced by operator*(), operator+(), and operator/().

◆ Distance() [2/4]

Isis::Distance::Distance	(	double	distance,
		Units	distanceUnit
	)

This is the general purpose constructor for Distance.

This will initialize with the given distance. If Pixels are supplied as the units, then a default pixels/meter = 1.0 will be used.

Parameters

distance	The distance to initialize with, must be in units of distanceUnit and not be negative
distanceUnit	The unit distance is in, can be any value in Distance::Units

Definition at line 36 of file Distance.cpp.

References distance(), Meters, Pixels, and setDistance().

◆ Distance() [3/4]

Isis::Distance::Distance	(	double	distanceInPixels,
		double	pixelsPerMeter
	)

This is a constructor for Distance given pixels with a conversion ratio.

This will initialize with the pixels converted to meters.

Parameters

distanceInPixels	The distance to initialize with, must be in units of pixels and should not be negative
pixelsPerMeter	The pixels/meter conversion factor

Definition at line 52 of file Distance.cpp.

References Meters, and setDistance().

◆ Distance() [4/4]

Isis::Distance::Distance ( const Distance & distanceToCopy )

This is the copy constructor for Distance.

The distance passed in will be exactly duplicated.

Parameters

distanceToCopy This is the distance we are making an exact duplicate of

Definition at line 64 of file Distance.cpp.

References Meters, meters(), and setDistance().

◆ ~Distance()

Isis::Distance::~Distance ( )

virtual

This will free the memory allocated by this instance of the Distance class.

Definition at line 73 of file Distance.cpp.

References m_distanceInMeters, and Isis::Null.

Member Function Documentation

◆ distance()

double Isis::Distance::distance ( Units distanceUnit ) const

protectedvirtual

This is a helper method to access distances in a universal manner with uniform error checking.

Parameters

distanceUnit Unit of the return value. If this is invalid, an exception will be thrown.

Returns: The distance in units of distanceUnit

Definition at line 405 of file Distance.cpp.

References Kilometers, m_distanceInMeters, Meters, Isis::Null, Pixels, Isis::IException::Programmer, and SolarRadii.

Referenced by Distance(), isValid(), kilometers(), meters(), pixels(), setDistance(), and solarRadii().

◆ isValid()

bool Isis::Distance::isValid ( ) const

Test if this distance has been initialized or not.

Returns: True if this distance has been initialized.

Definition at line 192 of file Distance.cpp.

References distance(), Meters, and Isis::Null.

Referenced by Isis::StereoTool::calculateElevation(), Isis::FindTool::centerLinkedViewports(), Isis::Camera::ComputeAzimuth(), Isis::FeatureNomenclature::featureDiameterGreaterThan(), Isis::Camera::GroundRangeResolution(), operator*(), operator*=(), operator+(), operator+=(), operator-(), Isis::Displacement::operator-=(), operator-=(), operator/(), operator/=(), operator<(), operator>(), Isis::SurfacePoint::ResetLocalRadius(), Isis::Image::save(), Isis::Shape::save(), Isis::ControlPoint::SetAprioriSurfacePoint(), Isis::CameraGroundMap::SetGround(), Isis::LineScanCameraGroundMap::SetGround(), Isis::RadarGroundMap::SetGround(), Isis::Camera::SetGround(), Isis::CSMCamera::SetGround(), Isis::Camera::SetImageMapProjection(), Isis::SurfacePoint::SetRectangular(), Isis::SurfacePoint::SetRectangularSigmas(), Isis::SurfacePoint::SetSpherical(), Isis::SurfacePoint::SetSphericalPoint(), Isis::SurfacePoint::SetSphericalSigmas(), toString(), Isis::SunShadowTool::updateRow(), and Isis::SunShadowTool::updateShadowHeightEdit().

◆ kilometers()

double Isis::Distance::kilometers ( ) const

Get the distance in kilometers.

Returns: Current distance, in kilometers, guaranteed to be >= 0.0

Definition at line 106 of file Distance.cpp.

References distance(), and Kilometers.

Referenced by Isis::BundleTargetBody::applyParameterCorrections(), Isis::Camera::ComputeAzimuth(), Isis::SurfacePoint::DistanceToDouble(), Isis::BundleControlPoint::formatBundleLatitudinalOutputDetailString(), Isis::BundleTargetBody::formatBundleOutputString(), Isis::BundleControlPoint::formatBundleRectangularOutputDetailString(), Isis::SpacecraftPosition::getDistanceLightTime(), Isis::Camera::GetLocalNormal(), Isis::SpacecraftPosition::getRadiusLightTime(), Isis::SpatialPlotTool::getSpatialStatistics(), Isis::TriangularPlate::hasPoint(), Isis::VimsGroundMap::Init(), Isis::DemShape::intersectSurface(), Isis::EquatorialCylindricalShape::intersectSurface(), Isis::RadarGroundMap::Iterate(), Isis::CameraGroundMap::MeanRadiusPartial(), Isis::TriangularPlate::point(), Isis::CameraGroundMap::PointPartial(), Isis::EmbreeShapeModel::pointToRay(), Isis::SurfacePoint::ResetLocalRadius(), Isis::RadarGroundMap::SetFocalPlane(), Isis::VimsGroundMap::SetGround(), Isis::BundleTargetBody::setSolveSettings(), Isis::SurfacePoint::SetSphericalPoint(), Isis::Sensor::SpacecraftAltitude(), Isis::TargetInfoWidget::TargetInfoWidget(), Isis::SunShadowTool::updateRow(), and Isis::SunShadowTool::updateShadowHeightEdit().

◆ meters()

double Isis::Distance::meters ( ) const

Get the distance in meters.

Returns: Current distance, in meters, guaranteed to be >= 0.0

Definition at line 85 of file Distance.cpp.

References distance(), and Meters.

Referenced by Isis::CameraStatistics::addStats(), Isis::StereoTool::calculateElevation(), Isis::Camera::ComputeAzimuth(), Isis::BundleAdjust::computeBundleStatistics(), Isis::ControlNetFilter::CubeDistanceFilter(), Isis::Displacement::Displacement(), Distance(), Isis::FindTool::distancePerPixel(), Isis::SurfacePoint::DistanceToDouble(), Isis::QnetSetAprioriDialog::fillAverageAprioriLineEdits(), Isis::QnetSetAprioriDialog::fillCurrentAprioriLineEdits(), Isis::QnetSetAprioriDialog::fillReferenceAprioriLineEdits(), Isis::QnetSetAprioriDialog::fillSigmaLineEdits(), Isis::QnetCubeDistanceFilter::filter(), Isis::QnetPointDistanceFilter::filter(), Isis::BundleControlPoint::formatAdjustedSigmaString(), Isis::SpatialPlotTool::getSpatialStatistics(), Isis::GroundGrid::GroundGrid(), Isis::BundleAdjust::init(), Isis::StereoTool::measureSaved(), operator!=(), operator*(), operator*=(), operator+(), operator+=(), operator-(), Isis::Displacement::operator-=(), operator-=(), operator/(), operator/=(), operator<(), operator=(), operator==(), operator>(), Isis::BundleSolutionInfo::outputText(), Isis::ControlNetFilter::PointDistanceFilter(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::SunShadowTool::recalculateShadowHeight(), Isis::Camera::ringRangeResolution(), Isis::ProjectionFactory::RingsCreateForCube(), Isis::Image::save(), Isis::Shape::save(), Isis::SurfacePoint::SetRectangularSigmas(), Isis::SurfacePoint::SetSphericalSigmas(), Isis::SurfacePoint::SetSphericalSigmasDistance(), Isis::BundleControlPoint::setWeights(), Isis::ControlNetVersioner::toPvl(), toString(), Isis::BundleControlPoint::updateAdjustedSurfacePointLatitudinally(), Isis::MeasureTool::updateDist(), Isis::TrackTool::updateLabels(), Isis::SunShadowTool::updateRow(), Isis::AdvancedTrackTool::updateRow(), Isis::SunShadowTool::updateShadowHeightEdit(), Isis::ControlPointEditWidget::updateSurfacePointInfo(), Isis::QnetTool::updateSurfacePointInfo(), and Isis::ControlNetVersioner::writeFirstPoint().

◆ operator!=()

bool Isis::Distance::operator!= ( const Distance & otherDistance ) const

inline

Compare two distances with the != operator.

Two uninitialized distances are equal to each other.

Parameters

otherDistance This is the distance we're comparing to, i.e. on the right hand side of the operator when used

Returns: True if this distance is not equal to the given distance

Definition at line 133 of file Distance.h.

References meters().

◆ operator*()

Distance Isis::Distance::operator* ( const double & valueToMult ) const

Multiply this distance by a value (5m * 2 = 10m).

Parameters

valueToMult This is the value to multiply by

Returns: Resulting value

Definition at line 313 of file Distance.cpp.

References Distance(), Isis::IsSpecial(), isValid(), Meters, and meters().

◆ operator*=()

void Isis::Distance::operator*= ( const double & valueToMult )

Multiply this distance by a value and assign the result to ourself.

Parameters

valueToMult This is the value we are going to multiply by

Definition at line 387 of file Distance.cpp.

References Isis::IsSpecial(), isValid(), Meters, meters(), Isis::Null, and setDistance().

◆ operator+()

Distance Isis::Distance::operator+ ( const Distance & distanceToAdd ) const

Add another distance to this distance (1km + 1m = 1005m)

Parameters

distanceToAdd This is the distance we are adding to ourselves

Returns: Resulting distance, self not modified

Definition at line 254 of file Distance.cpp.

References Distance(), isValid(), Meters, and meters().

◆ operator+=()

void Isis::Distance::operator+= ( const Distance & distanceToAdd )

Add and assign the given distance to ourselves.

Parameters

distanceToAdd This is the distance we are to duplicate exactly

Definition at line 340 of file Distance.cpp.

References isValid(), Meters, meters(), Isis::Null, and setDistance().

◆ operator-()

Displacement Isis::Distance::operator- ( const Distance & distanceToSub ) const

Subtract another distance from this distance (1km - 1m = 995m).

This could throw an exception if the result is negative.

Parameters

distanceToSub This is the distance we are subtracting from ourself

Returns: Resulting distance, self not modified

Definition at line 268 of file Distance.cpp.

References isValid(), Isis::Displacement::Meters, and meters().

◆ operator-=()

void Isis::Distance::operator-= ( const Distance & distanceToSub )

Subtract and assign the given distance from ourself.

This could throw an exception if the result is negative, in which case the new value is never applied.

Parameters

distanceToSub This is the distance we are to subtract

Definition at line 357 of file Distance.cpp.

References isValid(), Meters, meters(), Isis::Null, and setDistance().

◆ operator/() [1/2]

double Isis::Distance::operator/ ( const Distance & distanceToDiv ) const

Divide another distance into this distance (5m / 1m = 5).

Parameters

distanceToDiv This is the divisor displacement (denominator)

Returns: Resulting value

Definition at line 284 of file Distance.cpp.

References isValid(), meters(), and Isis::Null.

◆ operator/() [2/2]

Distance Isis::Distance::operator/ ( const double & valueToDiv ) const

Divide a value from this distance (5m / 2 = 2.5m).

Parameters

valueToDiv This is the divisor displacement (denominator)

Returns: Resulting value

Definition at line 298 of file Distance.cpp.

References Distance(), Isis::IsSpecial(), isValid(), Meters, and meters().

◆ operator/=()

void Isis::Distance::operator/= ( const double & valueToDiv )

Divide this distance by a value and assign the result to ourself.

Parameters

valueToDiv This is the displacement we are to divide by

Definition at line 372 of file Distance.cpp.

References Isis::IsSpecial(), isValid(), Meters, meters(), Isis::Null, and setDistance().

◆ operator<()

bool Isis::Distance::operator< ( const Distance & otherDistance ) const

Compare two distances with the less than operator.

Parameters

otherDistance This is the distance we're comparing to, i.e. on the right hand side of the operator when used

Returns: True if this distance is less than the given distance

Definition at line 222 of file Distance.cpp.

References isValid(), meters(), and Isis::IException::Programmer.

◆ operator<=()

bool Isis::Distance::operator<= ( const Distance & otherDistance ) const

inline

Compare two distances with the less than or equal to operator.

Parameters

otherDistance This is the distance we're comparing to, i.e. on the right hand side of the operator when used

Returns: True if this distance is less than or equal to the given distance

Definition at line 107 of file Distance.h.

◆ operator=()

Distance & Isis::Distance::operator= ( const Distance & distanceToCopy )

Assign this distance to the value of another distance.

Parameters

distanceToCopy This is the distance we are to duplicate exactly

Returns: Resulting distance, a reference to this distance after assignment

Definition at line 239 of file Distance.cpp.

References Meters, meters(), and setDistance().

◆ operator==()

bool Isis::Distance::operator== ( const Distance & otherDistance ) const

inline

Compare two distances with the == operator.

Two uninitialized distances are equal to each other.

Parameters

otherDistance This is the distance we're comparing to, i.e. on the right hand side of the operator when used

Returns: True if this distance is equal to the given distance

Definition at line 120 of file Distance.h.

References meters().

◆ operator>()

bool Isis::Distance::operator> ( const Distance & otherDistance ) const

Compare two distances with the greater than operator.

Parameters

otherDistance This is the distance we're comparing to, i.e. on the right hand side of the operator when used

Returns: True if this distance is greater than the given distance

Definition at line 204 of file Distance.cpp.

References isValid(), meters(), and Isis::IException::Programmer.

◆ operator>=()

bool Isis::Distance::operator>= ( const Distance & otherDistance ) const

inline

Compare two distances with the greater than or equal to operator.

Parameters

otherDistance This is the distance we're comparing to, i.e. on the right hand side of the operator when used

Returns: True if this distance is greater than or equal to the given distance

Definition at line 94 of file Distance.h.

◆ pixels()

double Isis::Distance::pixels ( double pixelsPerMeter = 1.0 ) const

Get the distance in pixels using the given conversion ratio.

Parameters

pixelsPerMeter Pixels/Meters conversion ratio to use, stored data is always in meters

Returns: Current distance, in pixels, guaranteed to be >= 0.0 if pixelsPerMeter is positive

Definition at line 131 of file Distance.cpp.

References distance(), and Meters.

Referenced by Isis::RawCubeChunk::RawCubeChunk().

◆ setDistance()

void Isis::Distance::setDistance	(	const double &	distance,
		Units	distanceUnit
	)

protectedvirtual

This is a helper method to set distances in a universal manner with uniform error checking.

Parameters

distance	The distance, in units of distanceUnit, to set this class to. If this is negative an exception will be thrown and the state unmodified.
distanceUnit	Unit of distance. If this is invalid, an exception will be thrown and the state left unmodified.

Definition at line 452 of file Distance.cpp.

References distance(), Isis::IsSpecial(), Kilometers, m_distanceInMeters, Meters, Isis::Null, Pixels, Isis::IException::Programmer, and SolarRadii.

Referenced by Distance(), operator*=(), operator+=(), operator-=(), operator/=(), operator=(), setKilometers(), setMeters(), setPixels(), and setSolarRadii().

◆ setKilometers()

void Isis::Distance::setKilometers ( double distanceInKilometers )

Set the distance in kilometers.

Parameters

distanceInKilometers This is the value to set this distance to, given in kilometers. This will throw an exception if the value is negative.

Definition at line 118 of file Distance.cpp.

References Kilometers, and setDistance().

◆ setMeters()

void Isis::Distance::setMeters ( double distanceInMeters )

Set the distance in meters.

Parameters

distanceInMeters This is the value to set this distance to, given in meters. This will throw an exception if the value is negative.

Definition at line 96 of file Distance.cpp.

References Meters, and setDistance().

Referenced by Isis::BundleResults::initialize().

◆ setPixels()

void Isis::Distance::setPixels	(	double	distanceInPixels,
		double	pixelsPerMeter = `1.0`
	)

Set the distance in pixels.

Parameters

distanceInPixels	This is the value to set this distance to, given in pixels. This will throw an exception if the distance is negative after the conversion to meters.
pixelsPerMeter	Pixels/Meters conversion ratio to use, stored data is always in meters

Definition at line 145 of file Distance.cpp.

References Meters, and setDistance().

◆ setSolarRadii()

void Isis::Distance::setSolarRadii ( double distanceInSolarRadii )

Set the distance in solar radii.

Parameters

distanceInSolarRadii This is the value to set this distance to, given in solar radii. This will throw an exception if the value is negative.

Definition at line 167 of file Distance.cpp.

References setDistance(), and SolarRadii.

◆ solarRadii()

double Isis::Distance::solarRadii ( ) const

Get the distance in solar radii (a unit of ~696,265km).

Returns: Current distance, in solar radii, guaranteed to be >= 0.0

Definition at line 155 of file Distance.cpp.

References distance(), and SolarRadii.

◆ toString()

QString Isis::Distance::toString ( ) const

Get a textual representation of this distance.

Returns: XXX meters (or empty string if not valid).

Definition at line 177 of file Distance.cpp.

References isValid(), meters(), and Isis::toString().

Friends And Related Function Documentation

◆ operator*

Distance operator*	(	double	mult,
		Distance	dist
	)

friend

Multiply this distance by a value (5m * 2 = 10m).

Parameters

mult	This is the value to multiply by
dist	This is the distance to multiply into

Returns: Resulting value

Definition at line 329 of file Distance.cpp.

Member Data Documentation

◆ m_distanceInMeters

double Isis::Distance::m_distanceInMeters

private

This is the distance value that this class is encapsulating, always stored in meters.

Definition at line 159 of file Distance.h.

Referenced by distance(), setDistance(), and ~Distance().

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

src/base/objs/Distance/Distance.h
src/base/objs/Distance/Distance.cpp

Public Types

Public Member Functions

Protected Member Functions

Private Attributes

Friends

Detailed Description

Member Enumeration Documentation

◆ Units

Constructor & Destructor Documentation

◆ Distance() [1/4]

◆ Distance() [2/4]

◆ Distance() [3/4]

◆ Distance() [4/4]

◆ ~Distance()

Member Function Documentation

◆ distance()

◆ isValid()

◆ kilometers()

◆ meters()

◆ operator!=()

◆ operator*()

◆ operator*=()

◆ operator+()

◆ operator+=()

◆ operator-()

◆ operator-=()

◆ operator/() [1/2]

◆ operator/() [2/2]

◆ operator/=()

◆ operator<()

◆ operator<=()

◆ operator=()

◆ operator==()

◆ operator>()

◆ operator>=()

◆ pixels()

◆ setDistance()

◆ setKilometers()

◆ setMeters()

◆ setPixels()

◆ setSolarRadii()

◆ solarRadii()

◆ toString()

Friends And Related Function Documentation

◆ operator*

Member Data Documentation

◆ m_distanceInMeters