Defines an angle and provides unit conversions. More...

#include <Angle.h>

Inheritance diagram for Isis::Angle:

Collaboration diagram for Isis::Angle:

Public Types
enum	Units { Degrees, Radians }
	The set of usable angle measurement units. More...

Public Member Functions
	Angle ()
	Constructs a blank angle object which needs a value to be set in order to do any calculations. More...

	Angle (double angle, Units unit)
	Constructs an angle object with the entered value and unit. More...

	Angle (const Angle &angle)
	Constructs an angle object from another Angle object. More...

	Angle (QString angle)
	Constructs an angle object with units of Angle::Degrees from a QString of the general form "dd mm ss.ss" (there can be more than 2 digits per piece.) More...

virtual	~Angle ()
	Destroys the angle object. More...

bool	isValid () const
	This indicates whether we have a legitimate angle stored or are in an unset, or invalid, state. More...

Angle &	operator= (const Angle &angle2)
	Assign angle object equal to another. More...

Angle	operator+ (const Angle &angle2) const
	Add angle value to another. More...

Angle	operator- (const Angle &angle2) const
	Subtract angle value from another and return the resulting angle. More...

Angle	operator* (double value) const
	Multiply this angle by a double and return the resulting angle. More...

Angle	operator/ (double value) const
	Divide this angle by a double. More...

double	operator/ (Angle value) const
	Divide this angle by another angle and return the ratio. More...

bool	operator< (const Angle &angle2) const
	Test if the other angle is less than the current angle. More...

bool	operator> (const Angle &angle2) const
	Test if the other angle is greater than the current angle. More...

void	operator+= (const Angle &angle2)
	Add angle value to another as double and replace original. More...

void	operator-= (const Angle &angle2)
	Subtract angle value from another and set this instance to the resulting angle. More...

Angle	operator* (int value) const
	Multiply this angle by an integer and return the resulting angle. More...

void	operator*= (double value)
	Multiply this angle by a double and set this instance to the resulting angle. More...

Angle	operator/ (int value) const
	Divide this angle by an integer and return the resulting angle. More...

void	operator/= (double value)
	Divide this angle by a double and return the resulting angle. More...

bool	operator== (const Angle &angle2) const
	Test if another angle is equal to this angle. More...

bool	operator!= (const Angle &angle2) const
	Test if another angle is not equal to this angle. More...

bool	operator<= (const Angle &angle2) const
	Test if the other angle is less than or equal to the current angle. More...

bool	operator>= (const Angle &angle2) const
	Test if the other angle is greater than or equal to the current angle. More...

double	radians () const
	Convert an angle to a double. More...

double	degrees () const
	Get the angle in units of Degrees. More...

void	setRadians (double radians)
	Set the angle in units of Radians. More...

void	setDegrees (double degrees)
	Set the angle in units of Degrees. More...

virtual QString	toString (bool includeUnits=true) const
	Get the angle in human-readable form. More...

double	unitWrapValue (const Units &unit) const
	Return wrap value in desired units. More...

virtual double	angle (const Units &unit) const
	Return angle value in desired units. More...

virtual void	setAngle (const double &angle, const Units &unit)
	Set angle value in desired units. More...

Static Public Member Functions
static Angle	fullRotation ()
	Makes an angle to represent a full rotation (0-360 or 0-2pi). More...

Friends
Angle	operator* (double mult, Angle angle)
	Multiply this angle by a double and return the resulting angle. More...

Detailed Description

Defines an angle and provides unit conversions.

Author: 2010-10-09 Debbie A. Cook

Member Enumeration Documentation

◆ Units

enum Isis::Angle::Units

The set of usable angle measurement units.

Enumerator

Degrees

Degrees are generally considered more human readable, 0-360 is one circle, however most math does not use this unit.

Use these for displaying to the user and accepting input from the user.

Radians

Radians are generally used in mathematical equations, 0-2*PI is one circle, however these are more difficult for users to understand when displayed since they have PI in them.

This is the default unit and is necessary for most math library calls.

Constructor & Destructor Documentation

◆ Angle() [1/4]

Isis::Angle::Angle ( )

Constructs a blank angle object which needs a value to be set in order to do any calculations.

References Isis::Null.

Referenced by Isis::Longitude::force180Domain(), fullRotation(), operator*(), operator+(), operator-(), operator/(), Isis::Latitude::planetographic(), Isis::Latitude::setAngle(), and Isis::Latitude::setPlanetographic().

◆ Angle() [2/4]

Isis::Angle::Angle	(	double	angle,
		Units	unit
	)

Constructs an angle object with the entered value and unit.

Parameters

angle	The initial angle value in units of the unit parameter
unit	The unit of the initial angle (see Angle::Units)

References angle(), and setAngle().

◆ Angle() [3/4]

Isis::Angle::Angle ( const Angle & fromAngle )

Constructs an angle object from another Angle object.

Parameters

fromAngle The angle object to copy on initialization

◆ Angle() [4/4]

Isis::Angle::Angle ( QString angle )

Constructs an angle object with units of Angle::Degrees from a QString of the general form "dd mm ss.ss" (there can be more than 2 digits per piece.)

Parameters

angle The value of the angle in degrees, as a QString of the form: "dd mm ss.ss"

References _FILEINFO_, angle(), Degrees, degrees(), Isis::IException::Programmer, and setAngle().

◆ ~Angle()

Isis::Angle::~Angle ( )

virtual

Destroys the angle object.

References Isis::Null.

Member Function Documentation

◆ angle()

double Isis::Angle::angle ( const Units & unit ) const

virtual

Return angle value in desired units.

Parameters

unit	Desired units of the angle (see Angle::Units)

Returns: angle value in specified units

References _FILEINFO_, Degrees, Isis::Null, Isis::IException::Programmer, Isis::RAD2DEG, and Radians.

Referenced by Angle(), degrees(), Isis::Longitude::force360Domain(), operator<(), operator==(), operator>(), Isis::Latitude::planetocentric(), Isis::Longitude::positiveEast(), Isis::Longitude::positiveWest(), radians(), Isis::Latitude::setAngle(), and setAngle().

◆ degrees()

double Isis::Angle::degrees ( ) const

inline

Get the angle in units of Degrees.

Returns: A double-value representing this angle. Null if not valid.

References angle(), and Degrees.

Referenced by Angle(), Isis::Cube::attachSpiceFromIsd(), Isis::MosaicGridTool::autoGrid(), Isis::PhotometricFunction::compute(), Isis::MosaicGridTool::drawGrid(), Isis::AdjustedLatitudeFilter::evaluate(), Isis::AdjustedLongitudeFilter::evaluate(), Isis::APrioriLatitudeFilter::evaluate(), Isis::APrioriLongitudeFilter::evaluate(), Isis::Longitude::force180Domain(), Isis::Longitude::force360Domain(), Isis::BundleControlPoint::formatBundleLatitudinalOutputDetailString(), Isis::BundleTargetBody::formatBundleOutputString(), Isis::BundleControlPoint::formatBundleRectangularOutputDetailString(), Isis::AbstractPointItem::getData(), Isis::GridGraphicsItem::GridGraphicsItem(), Isis::ImageTreeWidgetItem::ImageTreeWidgetItem(), Isis::DemShape::localRadius(), Isis::MosaicControlNetTool::mouseButtonRelease(), operator<<(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::MosaicGridToolConfigDialog::readSettings(), Isis::Latitude::setAngle(), setDegrees(), Isis::CameraGroundMap::SetGround(), Isis::VimsGroundMap::SetGround(), Isis::UniversalGroundMap::SetGround(), Isis::Camera::SetGround(), Isis::CSMCamera::SetGround(), Isis::BundleTargetBody::setSolveSettings(), Isis::UniversalGroundMap::SetUnboundGround(), Isis::CSMCamera::subSpacecraftPoint(), TEST(), Isis::RingPlaneProjection::To180Domain(), Isis::TProjection::To180Domain(), Isis::RingPlaneProjection::To360Domain(), Isis::TProjection::To360Domain(), Isis::ControlNetVersioner::toPvl(), Isis::MosaicGridTool::toPvl(), toString(), Isis::Sensor::UniversalLatitude(), and Isis::Sensor::UniversalLongitude().

◆ fullRotation()

Angle Isis::Angle::fullRotation ( )

static

Makes an angle to represent a full rotation (0-360 or 0-2pi).

Returns: the angle of 1 full rotation

References Angle(), and Degrees.

Referenced by Isis::Hillshade::shadedValue(), and Isis::Longitude::to360Range().

◆ isValid()

bool Isis::Angle::isValid ( ) const

This indicates whether we have a legitimate angle stored or are in an unset, or invalid, state.

Returns: True if we have a legitimate angle value, false if not initialized

References Isis::Null.

Referenced by Isis::GroundGrid::CreateGrid(), Isis::Longitude::force180Domain(), Isis::Longitude::force360Domain(), Isis::UniversalGroundMap::GroundRange(), Isis::DemShape::localRadius(), Isis::SunShadowTool::mouseMove(), operator*(), operator+(), operator-(), operator/(), operator<(), operator>(), Isis::Latitude::planetographic(), Isis::NaifDskPlateModel::point(), Isis::Image::save(), Isis::Shape::save(), Isis::ControlPoint::SetAprioriSurfacePoint(), Isis::Hillshade::setAzimuth(), Isis::GroundGrid::SetGroundLimits(), Isis::SurfacePoint::SetSpherical(), Isis::SurfacePoint::SetSphericalSigmas(), Isis::Hillshade::setZenith(), Isis::Longitude::to360Range(), and toString().

◆ operator!=()

bool Isis::Angle::operator!= ( const Angle & angle2 ) const

inline

Test if another angle is not equal to this angle.

Takes the negated result of the '==' operator.

Parameters

angle2 The comparison angle (on right-hand-side of != operator)

Returns: true if the angle does not equal the comparision angle

◆ operator*() [1/2]

Angle Isis::Angle::operator* ( double value ) const

Multiply this angle by a double and return the resulting angle.

If this is an invalid angle, then the result will be an invalid angle.

Parameters

value The value to multiply to this angle

Returns: Multiplied angle

References Angle(), isValid(), Radians, and radians().

◆ operator*() [2/2]

Angle Isis::Angle::operator* ( int value ) const

inline

Multiply this angle by an integer and return the resulting angle.

Parameters

value The integer value to multiply with this angle

Returns: Product of the angles

◆ operator*=()

void Isis::Angle::operator*= ( double value )

inline

Multiply this angle by a double and set this instance to the resulting angle.

Parameters

value The double value to multiply with this angle

◆ operator+()

Angle Isis::Angle::operator+ ( const Angle & angle2 ) const

Add angle value to another.

If either of these are invalid angles, then the result will be an invalid angle.

Parameters

angle2 The angle to add to this angle

Returns: sum angle

References Angle(), isValid(), Radians, and radians().

◆ operator+=()

void Isis::Angle::operator+= ( const Angle & angle2 )

inline

Add angle value to another as double and replace original.

Parameters

angle2 The angle to add to this angle

Returns: sum angle, replaces original

◆ operator-()

Angle Isis::Angle::operator- ( const Angle & angle2 ) const

Subtract angle value from another and return the resulting angle.

If either of these are invalid angles, then the result will be an invalid angle.

Parameters

angle2 The angle to subtract from this angle

Returns: difference angle

References Angle(), isValid(), Radians, and radians().

◆ operator-=()

void Isis::Angle::operator-= ( const Angle & angle2 )

inline

Subtract angle value from another and set this instance to the resulting angle.

Parameters

angle2 The angle to subtract from this angle

◆ operator/() [1/3]

double Isis::Angle::operator/ ( Angle value ) const

Divide this angle by another angle and return the ratio.

Parameters

value The ratio, Null if invalid

Returns: Quotient of the angles

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

◆ operator/() [2/3]

Angle Isis::Angle::operator/ ( double value ) const

Divide this angle by a double.

Parameters

value The double value to use as the divisor

Returns: Quotient of the angles

References Angle(), isValid(), Radians, and radians().

◆ operator/() [3/3]

Angle Isis::Angle::operator/ ( int value ) const

inline

Divide this angle by an integer and return the resulting angle.

Parameters

value The double value to use as the divisor

Returns: Quotient of the angles

◆ operator/=()

void Isis::Angle::operator/= ( double value )

inline

Divide this angle by a double and return the resulting angle.

Parameters

value The double value to use as the divisor

◆ operator<()

bool Isis::Angle::operator< ( const Angle & angle2 ) const

Test if the other angle is less than the current angle.

If either is invalid, then an exception will be thrown.

Parameters

angle2 The comparison angle (on right-hand-side of < operator)

Returns: True if the angle is less than the comparision angle

References _FILEINFO_, angle(), isValid(), Isis::IException::Programmer, and Radians.

◆ operator<=()

bool Isis::Angle::operator<= ( const Angle & angle2 ) const

inline

Test if the other angle is less than or equal to the current angle.

Parameters

angle2 The comparison angle (on right-hand-side of < operator)

Returns: true if the angle is less than or equal to the comparision angle

◆ operator=()

Angle& Isis::Angle::operator= ( const Angle & angle2 )

inline

Assign angle object equal to another.

Parameters

angle2 The angle value to copy

Returns: The new angle value

References Radians, radians(), and setAngle().

◆ operator==()

bool Isis::Angle::operator== ( const Angle & angle2 ) const

inline

Test if another angle is equal to this angle.

This does not compensate for going around a circle: Angle(360, Angle::Degrees) does not equal Angle(0, Angle::Degrees)

Invalid angles are equal to each other.

Parameters

angle2 The comparison angle (on right-hand-side of == operator)

Returns: true if the angle equals the comparision angle

References angle(), and Radians.

◆ operator>()

bool Isis::Angle::operator> ( const Angle & angle2 ) const

Test if the other angle is greater than the current angle.

If either is invalid, then an exception will be thrown.

Parameters

angle2 The comparison angle (on right-hand-side of > operator)

Returns: True if the angle is greater than the comparision angle

References _FILEINFO_, angle(), isValid(), Isis::IException::Programmer, and Radians.

◆ operator>=()

bool Isis::Angle::operator>= ( const Angle & angle2 ) const

inline

Test if the other angle is greater than or equal to the current angle.

Parameters

angle2 The comparison angle (on right-hand-side of < operator)

Returns: true if the angle is greater than or equal to the comparision angle

◆ radians()

double Isis::Angle::radians ( ) const

inline

Convert an angle to a double.

This will return the radians version of the angle.

Returns: The angle value in radians

operator double() const { return angle(Radians); } Get the angle in units of Radians.

Returns: A double-value representing this angle. Null if not valid.

References angle(), and Radians.

Referenced by Isis::Latitude::add(), Isis::CameraGroundMap::EllipsoidPartial(), Isis::SurfacePoint::GetDistanceToPoint(), Isis::Camera::GetLocalNormal(), Isis::GridGraphicsItem::GridGraphicsItem(), Isis::Longitude::inRange(), Isis::Latitude::Latitude(), Isis::EllipsoidShape::localRadius(), Isis::BundleTargetBody::localRadius(), Isis::Longitude::Longitude(), Isis::SunShadowTool::mouseMove(), operator*(), operator+(), operator-(), operator/(), operator<<(), operator=(), Isis::Latitude::planetographic(), Isis::CameraGroundMap::PointPartial(), Isis::SurfacePoint::ResetLocalRadius(), Isis::LinearAlgebra::rotate(), Isis::Image::save(), Isis::Shape::save(), Isis::SpiceRotation::setEphemerisTimePckPolyFunction(), Isis::VimsGroundMap::SetGround(), Isis::Latitude::setPlanetographic(), setRadians(), Isis::BundleTargetBody::setSolveSettings(), Isis::SurfacePoint::SetSphericalMatrix(), Isis::SurfacePoint::SetSphericalSigmas(), and Isis::Hillshade::shadedValue().

◆ setAngle()

void Isis::Angle::setAngle	(	const double &	angle,
		const Units &	unit
	)

virtual

Set angle value in desired units.

Parameters

angle	The angle value in units of the unit parameter
unit	Desired units of the angle (see Angle::Units)

Reimplemented in Isis::Latitude.

References _FILEINFO_, angle(), Isis::DEG2RAD, Degrees, Isis::IsSpecial(), Isis::Null, Isis::IException::Programmer, and Radians.

Referenced by Angle(), operator=(), Isis::Latitude::setAngle(), setDegrees(), Isis::Longitude::setPositiveEast(), Isis::Longitude::setPositiveWest(), and setRadians().

◆ setDegrees()

void Isis::Angle::setDegrees ( double degrees )

inline

Set the angle in units of Degrees.

Parameters

degrees The new angle value, Null for invalid angle

References Degrees, degrees(), and setAngle().

◆ setRadians()

void Isis::Angle::setRadians ( double radians )

inline

Set the angle in units of Radians.

Parameters

radians The new angle value, Null for invalid angle

References Radians, radians(), and setAngle().

Referenced by Isis::LinearAlgebra::toAxisAngle(), and Isis::LinearAlgebra::toEulerAngles().

◆ toString()

QString Isis::Angle::toString ( bool includeUnits = true ) const

virtual

Get the angle in human-readable form.

Parameters

includeUnits Include the angle's units in the text.

Returns: A user-displayable angle string.

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

Referenced by Isis::Latitude::inRange(), Isis::Latitude::Latitude(), Isis::operator<<(), Isis::Latitude::planetographic(), and Isis::Hillshade::shadedValue().

◆ unitWrapValue()

double Isis::Angle::unitWrapValue ( const Units & unit ) const

Return wrap value in desired units.

The 'wrap' value is the value where one circle occurs - angles greater than this are conceptually 'wrapping' back to zero. For example, this is 2*PI in radians because 2*PI == 0 on a circle. Please keep in mind we still differentiate those two angles.

Parameters

unit	Desired units of the Angle wrap constant (see Angle::Units)

Returns: Wrap value in specified units

References _FILEINFO_, Degrees, Isis::PI, Isis::IException::Programmer, and Radians.

Referenced by Isis::Longitude::positiveWest(), and Isis::Longitude::setPositiveWest().

Friends And Related Function Documentation

◆ operator*

Angle operator*	(	double	mult,
		Angle	angle
	)

friend

Multiply this angle by a double and return the resulting angle.

If this is an invalid angle, then the result will be an invalid angle.

Parameters

mult	The value to multiply to this angle
angle	The angle being multiplied by mult

Returns: Multiplied angle

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

/home/isis3mgr/repos/ISIS3/isis/src/base/objs/Angle/Angle.h
/home/isis3mgr/repos/ISIS3/isis/src/base/objs/Angle/Angle.cpp

Public Types

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Member Enumeration Documentation

◆ Units

Constructor & Destructor Documentation

◆ Angle() [1/4]

◆ Angle() [2/4]

◆ Angle() [3/4]

◆ Angle() [4/4]

◆ ~Angle()

Member Function Documentation

◆ angle()

◆ degrees()

◆ fullRotation()

◆ isValid()

◆ operator!=()

◆ operator*() [1/2]

◆ operator*() [2/2]

◆ operator*=()

◆ operator+()

◆ operator+=()

◆ operator-()

◆ operator-=()

◆ operator/() [1/3]

◆ operator/() [2/3]

◆ operator/() [3/3]

◆ operator/=()

◆ operator<()

◆ operator<=()

◆ operator=()

◆ operator==()

◆ operator>()

◆ operator>=()

◆ radians()

◆ setAngle()

◆ setDegrees()

◆ setRadians()

◆ toString()

◆ unitWrapValue()

Friends And Related Function Documentation

◆ operator*