Isis::RingCylindrical Class Reference
[Map Projection]

Ring Cylindrical Map Projection. More...

#include <RingCylindrical.h>

Public Types
enum	RingLongitudeDirection { Clockwise, CounterClockwise }
	This enum defines the types of ring longitude directions supported in this class. More...
enum	ProjectionType { Triaxial, RingPlane }
	This enum defines the subclasses of Projection supported in Isis. More...
Public Member Functions
	RingCylindrical (Pvl &label, bool allowDefaults=false)
	Constructs a RingCylindrical object.
	~RingCylindrical ()
	Destroys the RingCylindrical object.
bool	operator== (const Projection &proj)
	Compares two Projection objects to see if they are equal.
QString	Name () const
	Returns the name of the map projection, "RingCylindrical".
QString	Version () const
	Returns the version of the map projection.
bool	IsEquatorialCylindrical ()
	This method returns true if the projection is equatorial cylindrical.
double	TrueScaleRingRadius () const
	Returns the center radius, in meters.
double	CenterRingLongitude () const
	Returns the center longitude, in degrees.
double	CenterRingRadius () const
	Returns the center radius, in meters.
bool	SetGround (const double ringRadius, const double ringLongitude)
	This method is used to set the radius/longitude (assumed to be of the correct RingLongitudeDirection, and RingLongitudeDomain.
bool	SetCoordinate (const double x, const double y)
	This method is used to set the projection x/y.
bool	XYRange (double &minX, double &maxX, double &minY, double &maxY)
	This method is used to determine the x/y range which completely covers the area of interest specified by the radus/lon range.
PvlGroup	Mapping ()
	This function returns the keywords that this projection uses.
PvlGroup	MappingRingRadii ()
	This function returns the radii keywords that this projection uses.
PvlGroup	MappingRingLongitudes ()
	This function returns the longitude keywords that this projection uses.
virtual bool	operator== (const Projection &proj)
	This method determines whether two map projection objects are equal by comparing the resolution, and projection name.
double	LocalRadius () const
	This returns a local radius.
bool	IsClockwise () const
	This indicates if the longitude direction type is positive west (as opposed to postive east).
bool	IsCounterClockwise () const
	This indicates if the longitude direction type is positive east (as opposed to postive west).
std::string	RingLongitudeDirectionString () const
	This method returns the ring longitude direction as a string.
bool	Has180Domain () const
	This indicates if the longitude domain is -180 to 180 (as opposed to 0 to 360).
bool	Has360Domain () const
	This indicates if the ring longitude domain is 0 to 360 (as opposed to -180 to 180).
std::string	RingLongitudeDomainString () const
	This method returns the ring longitude domain as a string.
double	MinimumRingRadius () const
	This returns the minimum radius of the area of interest.
double	MaximumRingRadius () const
	This returns the maximum radius of the area of interest.
double	MinimumRingLongitude () const
	This returns the minimum ring longitude of the area of interest.
double	MaximumRingLongitude () const
	This returns the maximum ring longitude of the area of interest.
double	RingRadius () const
	This returns a radius.
double	RingLongitude () const
	This returns a ring longitude with correct ring longitude direction and domain as specified in the label object.
bool	SetUniversalGround (const double ringRadius, const double ringLongitude)
	This method is used to set the ring radius/longitude which must be PositiveEast/Domain360 (ring longitude).
double	UniversalRingRadius ()
	This returns a universal radius, which is just the radius in meters.
double	UniversalRingLongitude ()
	This returns a universal ring longitude (clockwise in 0 to 360 domain).
double	Scale () const
	This method returns the scale for mapping world coordinates into projection coordinates.
bool	operator!= (const Projection &proj)
	This method determines whether two map projection objects are not equal.
void	setProjectionType (const ProjectionType ptype)
	Sets the projection subclass type.
ProjectionType	projectionType () const
	Returns an enum value for the projection type.
bool	IsSky () const
	Returns true if projection is sky and false if it is land.
bool	HasGroundRange () const
	This indicates if the longitude direction type is positive west (as opposed to postive east).
double	Rotation () const
	Returns the value of the Rotation keyword from the mapping group.
void	SetWorldMapper (WorldMapper *mapper)
	If desired the programmer can use this method to set a world mapper to be used in the SetWorld, WorldX, and WorldY methods.
bool	IsGood () const
	This indicates if the last invocation of SetGround, SetCoordinate, SetUniversalGround, or SetWorld was with successful or not.
double	XCoord () const
	This returns the projection X provided SetGround, SetCoordinate, SetUniversalGround, or SetWorld returned with success.
double	YCoord () const
	This returns the projection Y provided SetGround, SetCoordinate, SetUniversalGround, or SetWorld returned with success.
bool	SetWorld (const double x, const double y)
	This method is used to set a world coordinate.
double	WorldX () const
	This returns the world X coordinate provided SetGround, SetCoordinate, SetUniversalGround, or SetWorld returned with success.
double	WorldY () const
	This returns the world Y coordinate provided SetGround, SetCoordinate, SetUniversalGround, or SetWorld returned with success.
double	ToWorldX (const double projectionX) const
	This method converts a projection x value to a world x value.
double	ToWorldY (const double projectionY) const
	This method converts a projection y value to a world y value.
double	ToProjectionX (const double worldX) const
	This method converts a world x value to a projection x value.
double	ToProjectionY (const double worldY) const
	This method converts a world y value to a projection y value.
double	Resolution () const
	This method returns the resolution for mapping world coordinates into projection coordinates.
void	SetUpperLeftCorner (const Displacement &x, const Displacement &y)
	This method is used to find the XY range for oblique aspect projections (non-polar projections) by "walking" around each of the min/max lat/lon.
Static Public Member Functions
static double	ToClockwise (const double ringLongitude, const int domain)
	This method converts an ring longitude into the clockwise direction.
static double	ToCounterClockwise (const double ringLongitude, const int domain)
	This method converts an ring longitude into the counterclockwise direction.
static double	To180Domain (const double lon)
	This method converts a ring longitude into the -180 to 180 domain.
static double	To360Domain (const double lon)
	This method converts an ring longitude into the 0 to 360 domain.
static double	ToHours (double angle)
	Converts the given angle (in degrees) to hours by using the ratio 15 degrees per hour.
static QString	ToDMS (double angle)
	Converts the given angle (in degrees) to degrees, minutes, seconds.
static QString	ToHMS (double angle)
	Converts the given angle (in degrees) to hours, minutes, seconds.
Protected Member Functions
void	XYRangeCheck (const double ringRadius, const double ringLongitude)
	This convience function is established to assist in the development of the XYRange virtual method.
void	SetXY (double x, double y)
	This protected method is a helper for derived classes.
void	SetComputedXY (double x, double y)
	This protected method is a helper for derived classes.
double	GetX () const
	Calculates the unrotated form of current x value.
double	GetY () const
	Calculates the unrotated form of the current y value.
double	PixelResolution () const
	Returns the pixel resolution value from the PVL mapping group in meters/pixel.
Protected Attributes
double	m_ringRadius
	This contain a ring radius value in m.
double	m_ringLongitude
	This contain a ring longitude value.
RingLongitudeDirection	m_ringLongitudeDirection
	An enumerated type indicating the LongitudeDirection read from the labels.
int	m_ringLongitudeDomain
	This integer is either 180 or 360 and is read from the labels.
double	m_minimumRingRadius
	Contains the minimum ring radius for the entire ground range.
double	m_maximumRingRadius
	Contains the maximum ring radius for the entire ground range.
double	m_minimumRingLongitude
	Contains the minimum longitude for the entire ground range.
double	m_maximumRingLongitude
	Contains the maximum longitude for the entire ground range.
WorldMapper *	m_mapper
	This points to a mapper passed into the SetWorldMapper method.
bool	m_good
	Indicates if the contents of m_x, m_y, m_latitude, and m_longitude are valid.
bool	m_sky
	Indicates whether projection is sky or land.
bool	m_groundRangeGood
	Indicates if the ground range (min/max lat/lons) were read from the labels.
double	m_minimumX
	The data elements m_minimumX, m_minimumY, m_maximumX, and m_maximumY are convience data elements when you write the XYRange virtual function.
double	m_maximumX
	See minimumX description.
double	m_minimumY
	See minimumX description.
double	m_maximumY
	See minimumX description.
PvlGroup	m_mappingGrp
	Mapping group that created this projection.

Detailed Description

Ring Cylindrical Map Projection.

This class provides methods for the forward and inverse equations of a Ring Cylindrical map projection (for a sphere).

The Ring Cylindrical projection is an

Please see the Projection class for a full accounting of all the methods available.

See also:: Equirectangular

Author:: 2013-03-10 Debbie A. Cook

Member Enumeration Documentation

enum Isis::Projection::ProjectionType [inherited]

This enum defines the subclasses of Projection supported in Isis.

Enumerator:

Triaxial	These projections are used to map triaxial and irregular-shaped bodies.
RingPlane	These projections are used to map ring planes.

enum Isis::RingPlaneProjection::RingLongitudeDirection [inherited]

This enum defines the types of ring longitude directions supported in this class.

Enumerator:

Clockwise	Ring longitude values increase in the clockwise direction.
CounterClockwise	Ring longitude values increase in the counterclockwise direction.

Constructor & Destructor Documentation

Isis::RingCylindrical::RingCylindrical	(	Pvl &	label,
		bool	allowDefaults = `false`
	)

Constructs a RingCylindrical object.

Parameters:

	label	This argument must be a Label containing the proper mapping information as indicated in the Projection class. Additionally, the ring cylindrical projection requires the center azimuth to be defined in the keyword CenterRingLongitude.
	allowDefaults	If set to false, the constructor requires that the keyword CenterRingLongitude exist in the label. Otherwise if it does not exist it will be computed and written to the label using the middle of the azimuth range as specified in the labels. Defaults to false

Exceptions:

IException

References _FILEINFO_, Isis::RingPlaneProjection::Clockwise, Isis::DEG2RAD(), Isis::PvlObject::findGroup(), Isis::PvlContainer::hasKeyword(), Isis::IException::Io, Isis::RingPlaneProjection::m_maximumRingLongitude, Isis::RingPlaneProjection::m_maximumRingRadius, Isis::RingPlaneProjection::m_minimumRingLongitude, Isis::RingPlaneProjection::m_minimumRingRadius, Isis::RingPlaneProjection::m_ringLongitudeDirection, Isis::toString(), and Isis::PvlObject::Traverse.

Isis::RingCylindrical::~RingCylindrical ( )

Destroys the RingCylindrical object.

Member Function Documentation

double Isis::RingCylindrical::CenterRingLongitude ( ) const

Returns the center longitude, in degrees.

Returns:: double The center longitude.

References Isis::RingPlaneProjection::Clockwise, Isis::RingPlaneProjection::m_ringLongitudeDirection, and Isis::RAD2DEG().

double Isis::RingCylindrical::CenterRingRadius ( ) const

Returns the center radius, in meters.

Returns:: double The center radius.

double Isis::Projection::GetX ( ) const [protected, inherited]

Calculates the unrotated form of current x value.

Returns:: double The unrotated x-value.

References Isis::PI().

Referenced by Isis::TransverseMercator::SetCoordinate(), Isis::Sinusoidal::SetCoordinate(), Isis::SimpleCylindrical::SetCoordinate(), SetCoordinate(), Isis::PolarStereographic::SetCoordinate(), Isis::PointPerspective::SetCoordinate(), Isis::Orthographic::SetCoordinate(), Isis::ObliqueCylindrical::SetCoordinate(), Isis::Mercator::SetCoordinate(), Isis::LambertConformal::SetCoordinate(), and Isis::Equirectangular::SetCoordinate().

double Isis::Projection::GetY ( ) const [protected, inherited]

Calculates the unrotated form of the current y value.

Returns:: double The unrotated y-value.

References Isis::PI().

Referenced by Isis::TransverseMercator::SetCoordinate(), Isis::Sinusoidal::SetCoordinate(), Isis::SimpleCylindrical::SetCoordinate(), SetCoordinate(), Isis::PolarStereographic::SetCoordinate(), Isis::PointPerspective::SetCoordinate(), Isis::Orthographic::SetCoordinate(), Isis::ObliqueCylindrical::SetCoordinate(), Isis::Mercator::SetCoordinate(), Isis::LambertConformal::SetCoordinate(), and Isis::Equirectangular::SetCoordinate().

bool Isis::RingPlaneProjection::Has180Domain ( ) const [inherited]

This indicates if the longitude domain is -180 to 180 (as opposed to 0 to 360).

The ring longitude domain was obtained from the label during object construction.

Returns:: bool

References Isis::RingPlaneProjection::m_ringLongitudeDomain.

Referenced by Isis::RingPlaneProjection::operator==().

bool Isis::RingPlaneProjection::Has360Domain ( ) const [inherited]

This indicates if the ring longitude domain is 0 to 360 (as opposed to -180 to 180).

The ring longitude domain was obtained from the label during object construction.

Returns:: bool

References Isis::RingPlaneProjection::m_ringLongitudeDomain.

bool Isis::Projection::HasGroundRange ( ) const [inherited]

This indicates if the longitude direction type is positive west (as opposed to postive east).

The longitude type was obtained from the label during object construction.

Returns:: bool This indicates if the longitude direction type is positive east (as opposed to postive west). The longitude type was obtained from the label during object construction.; bool This method returns the longitude direction as a string. It will return either PositiveEast or PositiveWest.; string The longitude direction, "PositiveEast" or "PositiveWest". This indicates if the longitude domain is -180 to 180 (as opposed to 0 to 360). The longitude domain was obtained from the label during object construction.; bool This indicates if the longitude domain is 0 to 360 (as opposed to -180 to 180). The longitude domain was obtained from the label during object construction.; bool This method converts a longitude into the -180 to 180 domain. It will leave the longitude unchanged if it is already in the domain.

Parameters:

lon

Longitude to convert into the -180 to 180 domain.

Exceptions:

IException::Unknown

- "The given longitude is invalid."

Returns:: double The longitude, converted to 180 domain. This method converts a longitude into the 0 to 360 domain. It will leave the longitude unchanged if it is already in the domain.

Parameters:

lon

Longitude to convert into the 0 to 360 domain.

Returns:: double The longitude, converted to 360 domain. This method returns the longitude domain as a string. It will return either 180 or 360.; string The longitude domain, "180" or "360". This indicates that the labels contained minimum and maximum ground coordinatess (e.g., a ground range coverage). If the projection has ground range coverage then the MinimumLatitude, MaximumLatitude, MinimumLongitude, and MaximumLongitude methods or comparable methods for other projection types can be used. The ground range coverage essentially defines the area of user interest.; bool

References Isis::Projection::m_groundRangeGood.

Referenced by Isis::ProjectionFactory::CreateForCube(), Isis::RingPlaneProjection::Mapping(), Isis::TProjection::MappingLatitudes(), Isis::TProjection::MappingLongitudes(), Isis::RingPlaneProjection::MappingRingLongitudes(), MappingRingLongitudes(), Isis::Planar::MappingRingLongitudes(), Isis::RingPlaneProjection::MappingRingRadii(), MappingRingRadii(), Isis::Planar::MappingRingRadii(), Isis::ProjectionFactory::RingsCreateForCube(), and Isis::TProjection::xyRangeOblique().

bool Isis::RingPlaneProjection::IsClockwise ( ) const [inherited]

This indicates if the longitude direction type is positive west (as opposed to postive east).

The longitude type was obtained from the label during object construction.

Returns:: bool

References Isis::RingPlaneProjection::Clockwise, and Isis::RingPlaneProjection::m_ringLongitudeDirection.

Referenced by Isis::RingPlaneProjection::operator==().

bool Isis::RingPlaneProjection::IsCounterClockwise ( ) const [inherited]

This indicates if the longitude direction type is positive east (as opposed to postive west).

The longitude type was obtained from the label during object construction.

Returns:: bool

References Isis::RingPlaneProjection::CounterClockwise, and Isis::RingPlaneProjection::m_ringLongitudeDirection.

bool Isis::RingCylindrical::IsEquatorialCylindrical ( ) [virtual]

This method returns true if the projection is equatorial cylindrical.

In other words, if the projection is cylindrical and an image projected at 0 is the same as an image projected at 360.

Returns:: bool true if the projection is equatorial cylindrical

Reimplemented from Isis::Projection.

bool Isis::Projection::IsGood ( ) const [inherited]

This indicates if the last invocation of SetGround, SetCoordinate, SetUniversalGround, or SetWorld was with successful or not.

If there was success then the Latitude, Longitude, XCoord, YCoord, UniversalLatitude, UniversalLongitude, WorldX, and WorldY methods can be utilized.

Returns:: bool True if the last call to SetGround, SetCoordinate, SetUniversalGround, or SetWorld was successful.

References Isis::Projection::m_good.

Referenced by Isis::ProjectionFactory::CreateForCube(), Isis::Chip::Load(), Isis::ProjectionFactory::RingsCreateForCube(), Isis::SubArea::UpdateLabel(), Isis::TProjection::XYRangeCheck(), and Isis::RingPlaneProjection::XYRangeCheck().

bool Isis::Projection::IsSky ( ) const [inherited]

Returns true if projection is sky and false if it is land.

Returns:: bool

References Isis::Projection::m_sky.

Referenced by Isis::Camera::RaDecRange(), Isis::Camera::RaDecResolution(), Isis::Camera::SetImage(), and Isis::Camera::SetRightAscensionDeclination().

double Isis::RingPlaneProjection::LocalRadius ( ) const [virtual, inherited]

This returns a local radius.

The method can only be used if SetGround, SetCoordinate, SetUniversalGround, or SetWorld return with success. Success can also be checked using the IsGood method.

Returns:: double

Implements Isis::Projection.

References Isis::RingPlaneProjection::m_ringRadius.

PvlGroup Isis::RingCylindrical::Mapping ( ) [virtual]

This function returns the keywords that this projection uses.

For RingCylindrical, this is the CenterRingRadius and CenterRingLongitude.

Returns:: PvlGroup The keywords that this projection uses

Reimplemented from Isis::RingPlaneProjection.

References Isis::RingPlaneProjection::Clockwise, Isis::RingPlaneProjection::m_ringLongitudeDirection, Isis::RAD2DEG(), and Isis::toString().

PvlGroup Isis::RingCylindrical::MappingRingLongitudes ( ) [virtual]

This function returns the longitude keywords that this projection uses.

For RingCylindrical, this is the CenterRingLongitude.

Returns:: PvlGroup The ring longitude keywords that this projection uses

Reimplemented from Isis::RingPlaneProjection.

References Isis::Projection::HasGroundRange(), and Isis::Projection::m_mappingGrp.

PvlGroup Isis::RingCylindrical::MappingRingRadii ( ) [virtual]

This function returns the radii keywords that this projection uses.

For RingCylindrical, this is the CenterRingRadius.

Returns:: PvlGroup The latitude keywords that this projection uses

Reimplemented from Isis::RingPlaneProjection.

References Isis::Projection::HasGroundRange(), and Isis::Projection::m_mappingGrp.

double Isis::RingPlaneProjection::MaximumRingLongitude ( ) const [inherited]

This returns the maximum ring longitude of the area of interest.

The value was obtained from the labels during object construction. This method can only be used if HasGroundRange returns a true.

Returns:: double

References Isis::RingPlaneProjection::m_maximumRingLongitude.

double Isis::RingPlaneProjection::MaximumRingRadius ( ) const [inherited]

This returns the maximum radius of the area of interest.

The value was obtained from the labels during object construction. This method can only be used if HasGroundRange returns a true.

Returns:: double

References Isis::RingPlaneProjection::m_maximumRingRadius.

double Isis::RingPlaneProjection::MinimumRingLongitude ( ) const [inherited]

This returns the minimum ring longitude of the area of interest.

The value was obtained from the labels during object construction. This method can only be used if HasGroundRange returns a true.

Returns:: double

References Isis::RingPlaneProjection::m_minimumRingLongitude.

double Isis::RingPlaneProjection::MinimumRingRadius ( ) const [inherited]

This returns the minimum radius of the area of interest.

The value was obtained from the labels during object construction. This method can only be used if HasGroundRange returns a true.

Returns:: double

References Isis::RingPlaneProjection::m_minimumRingRadius.

QString Isis::RingCylindrical::Name ( ) const [virtual]

Returns the name of the map projection, "RingCylindrical".

Returns:: QString Name of projection, "RingCylindrical"

Implements Isis::RingPlaneProjection.

bool Isis::Projection::operator!= ( const Projection & proj ) [inherited]

This method determines whether two map projection objects are not equal.

True is returned if they have at least some differences in the radii, latitude type, longitude direction, resolution, or projection name.

Parameters:

proj

A reference to a Projection object to which this Projection will be compared.

Returns:: bool Indicates whether the Projection objects are not equivalent.

bool Isis::Projection::operator== ( const Projection & proj ) [virtual, inherited]

This method determines whether two map projection objects are equal by comparing the resolution, and projection name.

Parameters:

proj

A reference to a Projection object to which this Projection will be compared.

Returns:: bool Indicates whether the Projection objects are equivalent.

References Isis::Projection::Name(), and Isis::Projection::Resolution().

bool Isis::RingCylindrical::operator== ( const Projection & proj ) [virtual]

Compares two Projection objects to see if they are equal.

Parameters:

proj

Projection object to do comparison on

Returns:: bool Returns true if the Projection objects are equal, and false if they are not

Reimplemented from Isis::RingPlaneProjection.

double Isis::Projection::PixelResolution ( ) const [protected, inherited]

Returns the pixel resolution value from the PVL mapping group in meters/pixel.

Returns:: double pixel resolution in meters/pixel

Referenced by XYRange(), and Isis::Planar::XYRange().

Projection::ProjectionType Isis::Projection::projectionType ( ) const [inherited]

Returns an enum value for the projection type.

Returns:: projection subclass type

Referenced by Isis::MosaicGridTool::autoGrid(), Isis::MosaicGridTool::fromPvl(), Isis::MosaicFindTool::getUserGroundPoint(), Isis::GridGraphicsItem::GridGraphicsItem(), Isis::UniversalGroundMap::GroundRange(), Isis::MosaicFindTool::mouseButtonRelease(), Isis::MosaicGridTool::setLatExtents(), Isis::MosaicGridTool::setLonExtents(), Isis::Projection::SetUniversalGround(), Isis::UniversalGroundMap::UniversalLatitude(), Isis::UniversalGroundMap::UniversalLongitude(), Isis::MosaicTrackTool::updateLabels(), and Isis::MosaicAreaTool::userChangedBox().

double Isis::Projection::Resolution ( ) const [inherited]

This method returns the resolution for mapping world coordinates into projection coordinates.

For example, if the world coordinate system is an image then this routine returns the number of meters per pixel. Likewise, if the world coordinate system is a piece of paper, it might return the number of meters per inch of paper. If the SetWorldMapper method is not invoked then this method returns 1.0

Returns:: double The resolution, in appropriate units.

References Isis::Projection::m_mapper, and Isis::WorldMapper::Resolution().

Referenced by Isis::ProcessExport::CreateWorldFile(), Isis::Projection::operator==(), and Isis::UniversalGroundMap::Resolution().

double Isis::RingPlaneProjection::RingLongitude ( ) const [inherited]

This returns a ring longitude with correct ring longitude direction and domain as specified in the label object.

The method can only be used if SetGround, SetCoordinate, SetUniversalGround, or SetWorld return with success. Success can also be checked using the IsGood method.

Returns:: double

References Isis::RingPlaneProjection::m_ringLongitude.

Referenced by Isis::UniversalGroundMap::UniversalLongitude().

string Isis::RingPlaneProjection::RingLongitudeDirectionString ( ) const [inherited]

This method returns the ring longitude direction as a string.

It will return either Clockwise or CounterClockwise.

Returns:: string The ring longitude direction, "Clockwise" or "CounterClockwise".

References Isis::RingPlaneProjection::Clockwise, and Isis::RingPlaneProjection::m_ringLongitudeDirection.

string Isis::RingPlaneProjection::RingLongitudeDomainString ( ) const [inherited]

This method returns the ring longitude domain as a string.

It will return either 180 or 360.

Returns:: string The ring longitude domain, "180" or "360".

References Isis::RingPlaneProjection::m_ringLongitudeDomain.

double Isis::RingPlaneProjection::RingRadius ( ) const [inherited]

This returns a radius.

The method can only be used if SetGround, SetCoordinate, SetUniversalGround, or SetWorld return with success. Success can also be checked using the IsGood method.

Returns:: double

References Isis::RingPlaneProjection::m_ringRadius.

Referenced by Isis::UniversalGroundMap::UniversalLatitude().

double Isis::Projection::Rotation ( ) const [inherited]

Returns the value of the Rotation keyword from the mapping group.

Returns:: double The rotation of the map.

double Isis::RingPlaneProjection::Scale ( ) const [virtual, inherited]

This method returns the scale for mapping world coordinates into projection coordinates.

For example, if the world coordinate system is an image then this routine returns the number of pixels per degree. Likewise, if the world coordinate system is a piece of paper, it might return the number of inches of paper per degree. If the SetWorldMapper method is not invoked then this method returns 1.0

Returns:: double The scale for mapping.

Implements Isis::Projection.

References Isis::DEG2RAD(), Isis::Projection::m_mapper, Isis::WorldMapper::Resolution(), and Isis::RingPlaneProjection::TrueScaleRingRadius().

void Isis::Projection::SetComputedXY	(	double	x,
		double	y
	)			`[protected, inherited]`

This protected method is a helper for derived classes.

It takes unrotated x and y values, rotates them using the rotation angle data member, and stores the results in the current x and y data members.

Parameters:

	x	The unrotated x coordinate.
	y	The unrotated y coordinate.

References Isis::Projection::m_good, Isis::Null, and Isis::PI().

bool Isis::RingCylindrical::SetCoordinate	(	const double	x,
		const double	y
	)			`[virtual]`

This method is used to set the projection x/y.

The Set forces an attempted calculation of the corresponding latitude/longitude position. This may or may not be successful and a status is returned as such.

Parameters:

	x	X coordinate of the projection in units that are the same as the radii in the label
	y	Y coordinate of the projection in units that are the same as the radii in the label

Returns:: bool Indicates whether the ring radius and longitude were successfully calculated and whether the coordinate was successfully set.

Reimplemented from Isis::RingPlaneProjection.

References Isis::RingPlaneProjection::Clockwise, Isis::Projection::GetX(), Isis::Projection::GetY(), Isis::Projection::m_good, Isis::RingPlaneProjection::m_maximumRingRadius, Isis::RingPlaneProjection::m_ringLongitude, Isis::RingPlaneProjection::m_ringLongitudeDirection, Isis::RingPlaneProjection::m_ringRadius, Isis::RAD2DEG(), and Isis::Projection::SetXY().

bool Isis::RingCylindrical::SetGround	(	const double	ringRadius,
		const double	ringLongitude
	)			`[virtual]`

This method is used to set the radius/longitude (assumed to be of the correct RingLongitudeDirection, and RingLongitudeDomain.

The Set forces an attempted calculation of the projection X/Y values. This may or may not be successful and a status is returned as such.

Parameters:

	ringRadius	Ring radius value to project
	ringLongitude	Ring longitude (azimuth) value to project

Returns:: bool Indicates whether the x and y values were successfully calculated and whether the ground values were successfully set.

Reimplemented from Isis::RingPlaneProjection.

References Isis::RingPlaneProjection::Clockwise, Isis::DEG2RAD(), Isis::Projection::m_good, Isis::RingPlaneProjection::m_ringLongitude, Isis::RingPlaneProjection::m_ringLongitudeDirection, Isis::RingPlaneProjection::m_ringRadius, and Isis::Projection::SetComputedXY().

void Isis::Projection::setProjectionType ( const ProjectionType ptype ) [inherited]

Sets the projection subclass type.

Parameters:

ptype

The projection subclass type

Referenced by Isis::RingPlaneProjection::RingPlaneProjection(), and Isis::TProjection::TProjection().

bool Isis::RingPlaneProjection::SetUniversalGround	(	const double	ringRadius,
		const double	ringLongitude
	)			`[virtual, inherited]`

This method is used to set the ring radius/longitude which must be PositiveEast/Domain360 (ring longitude).

The Set forces an attempted calculation of the projection X/Y values. This may or may not be successful and a status is returned as such.

Parameters:

	ringRadius	The ring radius value to project
	ringLongitude	PositiveEast, Domain360 ring longitude value to project

Returns:: bool Indicates whether the method was successful.

Reimplemented from Isis::Projection.

References Isis::RingPlaneProjection::Clockwise, Isis::Projection::m_good, Isis::RingPlaneProjection::m_ringLongitude, Isis::RingPlaneProjection::m_ringLongitudeDirection, Isis::RingPlaneProjection::m_ringLongitudeDomain, Isis::RingPlaneProjection::m_ringRadius, Isis::Null, Isis::RingPlaneProjection::SetGround(), Isis::RingPlaneProjection::To180Domain(), and Isis::RingPlaneProjection::To360Domain().

Referenced by Isis::Projection::SetUniversalGround().

void Isis::Projection::SetUpperLeftCorner	(	const Displacement &	x,
		const Displacement &	y
	)			`[inherited]`

This method is used to find the XY range for oblique aspect projections (non-polar projections) by "walking" around each of the min/max lat/lon.

Parameters:

	minX	Minimum x projection coordinate which covers the latitude longitude range specified in the labels.
	maxX	Maximum x projection coordinate which covers the latitude longitude range specified in the labels.
	minY	Minimum y projection coordinate which covers the latitude longitude range specified in the labels.
	maxY	Maximum y projection coordinate which covers the latitude longitude range specified in the labels.

Returns:: bool Indicates whether the method was successful.

See also:: XYRange()

Author:: Stephen Lambright This method searches for extreme (min/max/discontinuity) coordinate values along the constBorder line between minBorder and maxBorder (that is, across latitudes/longitudes). This method locates the extrema by utilizing the findExtreme() method until the coordinate values converge. Then, extremeVal parameter is updated with this value before returning.

Discontinuities are stored in m_specialLatCases and m_specialLonCases so they may be checked again later, which creates significantly more accuracy in some cases.

Parameters:

	minBorder	Minimum latitude or longitude to search between.
	maxBorder	Maximum latitude or longitude to search between.
	extremeVal	The resulting global coordinate value (min or max value for x or y, depending on findMin and searchX) on the constBorder.
	constBorder	The latitude or longitude that remains constant. The method will step along this border.
	searchX	Indicates whether the method is searching for a min or max x-coordinate. If false the method searches for min or max y-coordinate.
	searchLongitude	Indicates whether the method will search along a longitude. If true, constBorder is longitude and all other borders are latitudes. If false, the method searches a latitude (constBorder is a lat, other borders lons).
	findMin	Indicates whether the method is looking for a minimum coordinate value. If false, the method is looking for a maximum value.

Author:: Steven Lambright Searches for extreme (min/max/discontinuity) coordinate values across latitudes/longitudes.

This method looks for these extrema along the constBorder between minBorder and maxBorder by stepping along constBorder (10 times) from the minBorder and maxBorder. Then, the range of this extreme value is recorded in minBorder and maxBorder and the coordinate values corresponding to these new borders are stored in minBorderX, minBorderY, maxBorderX and maxBorderY.

This function should be used by calling it repeatedly until minBorderX and minBorderY do not equal maxBorderX and maxBorderY, respectively. Discontinuities will cause the minBorderX, minBorderY, maxBorderX and maxBorderY to never converge. If minBorderX never comes close to maxBorderX or minBorderY never comes close to maxBorderY, then between minBorder and maxBorder is the value of the most extreme value. In this case, either the smaller or larger of the x or y values found will be correct, depending on the values of findMin and searchX.

Parameters:

	minBorder	Minimum latitude or longitude to search between. This value gets updated to a more precise range.
	maxBorder	Maximum latitude or longitude to search between. This value gets updated to a more precise range.
	minBorderX	The x-value corresponding to the lower resultant minBorder and the constBorder, which is more accurate when nearly equal to maxBorderX.
	minBorderY	The y-value corresponding to the lower resultant minBorder and the constBorder, which is more accurate when nearly equal to maxBorderY.
	maxBorderX	The x-value corresponding to the higher resultant maxBorder and the constBorder, which is more accurate when nearly equal to minBorderX.
	maxBorderY	The y-value corresponding to the higher resultant maxBorder and the constBorder, which is more accurate when nearly equal to minBorderY.
	constBorder	The latitude or longitude that remains constant. The method will step along this border.
	searchX	Indicates whether the method is searching for a min or max x-coordinate. If false the method searches for min or max y-coordinate.
	searchLongitude	Indicates whether the method will search along a longitude. If true, constBorder is longitude and all other borders are latitudes. If false, the method searches a latitude (constBorder is a lat, other borders lons).
	findMin	Indicates whether the method is looking for a minimum coordinate value. If false, the method is looking for a maximum value.

Author:: Stephen Lambright This function sets the ground for the given border values. It calls the SetGround(lat, lon) method with the appropriate lat/lon values, depending on whether variableIsLat is true.

This method is used by doSearch and findExtreme in order to set the ground correctly each time.

Parameters:

	variableBorder	The latitude or longitude that is variable in the search methods.
	constBorder	The latitude or longitude that is constant in the search methods.
	variableIsLat	Indicates whether variableBorder is the latittude value and constBorder is the longitude value. If false, variableBorder is the longitude value and constBorder is the latitude value.

Author:: Stephen Lambright This method sets the UpperLeftCornerX and UpperLeftCornerY keywords in the projection mapping group, in meters.

Parameters:

	x	the upper left corner x value
	y	the upper left corner y value

References Isis::PvlContainer::addKeyword(), Isis::Projection::m_mappingGrp, Isis::Displacement::meters(), Isis::PvlContainer::Replace, and Isis::toString().

Referenced by Isis::ProjectionFactory::CreateForCube(), Isis::ProjectionFactory::CreateFromCube(), Isis::ProjectionFactory::RingsCreateForCube(), and Isis::ProjectionFactory::RingsCreateFromCube().

bool Isis::Projection::SetWorld	(	const double	worldX,
		const double	worldY
	)			`[inherited]`

This method is used to set a world coordinate.

A world coordinate is a different coordinate type that has a one-to-one mapping to the projection coordinate system. For example, mapping pixel samples and lines to projection x's and y's. The Set forces an attempted calculation of the corresponding latitude/longitude position. This may or may not be successful and a status is returned as such. Note that is only applies if the Projection object was given an WorldMapper object during construction. If an WorldMapper was not supplied then SetWorld operates exactly the same as SetCoordinate (impling that world coordinate and projection coordinate are identical).

Parameters:

	worldX	World X coordinate in units that are specified by the WorldMapper object (e.g., pixels, millimeters, etc)
	worldY	World Y coordinate in units that are specified by the WorldMapper object (e.g., pixels, millimeters, etc)

Returns:: bool Indicates whether the method was successful.

References Isis::Projection::m_mapper, Isis::WorldMapper::ProjectionX(), Isis::WorldMapper::ProjectionY(), and Isis::Projection::SetCoordinate().

Referenced by Isis::ProcessExport::CreateWorldFile(), Isis::UniversalGroundMap::GroundRange(), Isis::Chip::Load(), Isis::UniversalGroundMap::SetImage(), Isis::Camera::SetImage(), Isis::SubArea::UpdateLabel(), and Isis::PolygonTools::XYToLatLon().

void Isis::Projection::SetWorldMapper ( WorldMapper * mapper ) [inherited]

If desired the programmer can use this method to set a world mapper to be used in the SetWorld, WorldX, and WorldY methods.

Mappers typically transform a projection coordinate (x/y) into the desired working coordinate system, for example, cube pixels or inches on a piece of paper. They transform in both directions (world to projection and projection to world). This allows for conversions from line/sample to latitude/longitude and vice versa. This projection will take ownership of the WorldMapper pointer.

Parameters:

mapper

Pointer to the mapper

References Isis::Projection::m_mapper.

Referenced by Isis::ProjectionFactory::CreateForCube(), Isis::ProjectionFactory::CreateFromCube(), Isis::ProjectionFactory::RingsCreateForCube(), and Isis::ProjectionFactory::RingsCreateFromCube().

void Isis::Projection::SetXY	(	double	x,
		double	y
	)			`[protected, inherited]`

This protected method is a helper for derived classes.

It takes a rotated x,y and stores them in the current x and y data members.

Parameters:

	x	The rotated x coordinate.
	y	The rotated y coordinate.

References Isis::Projection::m_good, and Isis::Null.

double Isis::RingPlaneProjection::To180Domain ( const double ringLongitude ) [static, inherited]

This method converts a ring longitude into the -180 to 180 domain.

It will leave the ring longitude unchanged if it is already in the domain.

Parameters:

ringLongitude

A ring longitude to convert into the -180 to 180 domain.

Exceptions:

IException::Unknown

- "The given longitude is invalid."

Returns:: double The ring longitude, converted to 180 domain.

References _FILEINFO_, Isis::Angle::Degrees, Isis::Null, and Isis::IException::Unknown.

Referenced by Isis::Planar::SetCoordinate(), Isis::RingPlaneProjection::SetUniversalGround(), Isis::RingPlaneProjection::ToClockwise(), and Isis::RingPlaneProjection::ToCounterClockwise().

double Isis::RingPlaneProjection::To360Domain ( const double ringLongitude ) [static, inherited]

This method converts an ring longitude into the 0 to 360 domain.

It will leave the ring longitude unchanged if it is already in the domain.

Parameters:

ringLongitude

The ring longitude to convert into the 0 to 360 domain.

Returns:: double The ring longitude, converted to 360 domain.

References _FILEINFO_, Isis::Angle::Degrees, Isis::Null, and Isis::IException::Unknown.

Referenced by Isis::Planar::SetCoordinate(), Isis::RingPlaneProjection::SetUniversalGround(), Isis::RingPlaneProjection::ToClockwise(), Isis::RingPlaneProjection::ToCounterClockwise(), and Isis::RingPlaneProjection::UniversalRingLongitude().

double Isis::RingPlaneProjection::ToClockwise	(	const double	ringLongitude,
		const int	domain
	)			`[static, inherited]`

This method converts an ring longitude into the clockwise direction.

Parameters:

	ringLongitude	The ring longitude to convert into the clockwise direction.
	domain	Must be an integer value of 180 (for -180 to 180) or 360 (for 0 to 360).

Exceptions:

	IException::Unknown	- "The given ring longitude is invalid."
	IException::Unknown	- "Unable to convert ring longitude. Domain is not 180 or 360."

Returns:: double The ring longitude value, in clockwise direction.

References _FILEINFO_, Isis::Null, Isis::RingPlaneProjection::To180Domain(), Isis::RingPlaneProjection::To360Domain(), and Isis::IException::Unknown.

double Isis::RingPlaneProjection::ToCounterClockwise	(	const double	ringLongitude,
		const int	domain
	)			`[static, inherited]`

This method converts an ring longitude into the counterclockwise direction.

Parameters:

	ringLongitude	The ring Longitude to convert into the counterclockwise direction.
	domain	Must be an integer value of 180 (for -180 to 180) or 360 (for 0 to 360).

Exceptions:

	IException::Unknown	- "The given ring longitude is invalid."
	IException::Unknown	- "Unable to convert ring longitude. Domain is not 180 or 360."

Returns:: double The ring longitude value, in counterclockwise direction.

References _FILEINFO_, Isis::Null, Isis::RingPlaneProjection::To180Domain(), Isis::RingPlaneProjection::To360Domain(), and Isis::IException::Unknown.

QString Isis::Projection::ToDMS ( double angle ) [static, inherited]

Converts the given angle (in degrees) to degrees, minutes, seconds.

Outputs in the form xxx yym zz.zzzs, for example, 206.291 degrees is 206 17m 27.6s

Parameters:

angle

Angle in degrees to be converted to degrees, minutes, seconds

Returns:: string The angle in Degrees, minutes, seconds

QString Isis::Projection::ToHMS ( double angle ) [static, inherited]

Converts the given angle (in degrees) to hours, minutes, seconds.

Outputs in the form xxh yym zz.zzzs For example, 206.291 will be 13h 45m 09.84s

Parameters:

angle

Angle in degrees to be converted to hours, minutes, seconds

Returns:: string The angle in Hours, minutes, seconds

References Isis::Projection::ToHours().

double Isis::Projection::ToHours ( double angle ) [static, inherited]

Converts the given angle (in degrees) to hours by using the ratio 15 degrees per hour.

Parameters:

angle

Angle in degrees to be converted to hours

Returns:: double The number of hours for the given angle.

Referenced by Isis::Projection::ToHMS().

double Isis::Projection::ToProjectionX ( const double worldX ) const [inherited]

This method converts a world x value to a projection x value.

For example, if the world coordinate system is an image then this method converts a sample position to a projection x value. Note that if SetWorldMapper is not used then this routine simply returns the value of the argument. That is, no mapping occurs.

Parameters:

worldX

World x coordinate

Exceptions:

IException::Unknown

- "The given x-value is invalid."

Returns:: double The projection X coordinate value.

References _FILEINFO_, Isis::Projection::m_mapper, Isis::Null, Isis::WorldMapper::ProjectionX(), and Isis::IException::Unknown.

Referenced by Isis::OverlapStatistics::OverlapStatistics(), and Isis::ProcessMapMosaic::StartProcess().

double Isis::Projection::ToProjectionY ( const double worldY ) const [inherited]

This method converts a world y value to a projection y value.

For example, if the world coordinate system is an image then this method converts a line position to a projection y value. Note that if SetWorldMapper is not used then this routine simply returns the value of the argument. That is, no mapping occurs.

Parameters:

worldY

World y coordinate

Exceptions:

IException::Unknown

- "The given y-value is invalid."

Returns:: double The projection Y coordinate value.

References _FILEINFO_, Isis::Projection::m_mapper, Isis::Null, Isis::WorldMapper::ProjectionY(), and Isis::IException::Unknown.

Referenced by Isis::OverlapStatistics::OverlapStatistics(), and Isis::ProcessMapMosaic::StartProcess().

double Isis::Projection::ToWorldX ( const double projectionX ) const [inherited]

This method converts a projection x value to a world x value.

For example, if the world coordinate system is an image then this method converts a projection x to a sample position. Note that if SetWorldMapper is not used then this routine simply returns the value of the argument. That is, no mapping occurs.

Parameters:

projectionX

Projection x value in meters

Exceptions:

IException::Unknown

- "The given x-value is invalid."

Returns:: double The world X coordinate value.

References _FILEINFO_, Isis::Projection::m_mapper, Isis::Null, Isis::IException::Unknown, and Isis::WorldMapper::WorldX().

Referenced by Isis::OverlapStatistics::OverlapStatistics(), Isis::ProcessMapMosaic::RingsSetOutputCube(), Isis::ProcessMapMosaic::SetOutputCube(), and Isis::ProcessMapMosaic::StartProcess().

double Isis::Projection::ToWorldY ( const double projectionY ) const [inherited]

This method converts a projection y value to a world y value.

For example, if the world coordinate system is an image then this method converts a projection y to a line position. Note that if SetWorldMapper is not used then this routine simply returns the value of the argument. That is, no mapping occurs.

Parameters:

projectionY

Projection y value in meters

Exceptions:

IException::Unknown

- "The given y-value is invalid."

Returns:: double The world Y coordinate value.

References _FILEINFO_, Isis::Projection::m_mapper, Isis::Null, Isis::IException::Unknown, and Isis::WorldMapper::WorldY().

Referenced by Isis::OverlapStatistics::OverlapStatistics(), Isis::ProcessMapMosaic::RingsSetOutputCube(), Isis::ProcessMapMosaic::SetOutputCube(), and Isis::ProcessMapMosaic::StartProcess().

double Isis::RingCylindrical::TrueScaleRingRadius ( ) const [virtual]

Returns the center radius, in meters.

TODO: Correct this comment for planar projection, assuming right now scale at center of projection. (believe scale is uniform across planar projection)

**NOTE** In the case of Planar projections, there is NO radius that is entirely true to scale. The only true scale for this projection is at the single point, (center radius, center azimuth).

Returns:: double The center radius.

Reimplemented from Isis::RingPlaneProjection.

double Isis::RingPlaneProjection::UniversalRingLongitude ( ) [inherited]

This returns a universal ring longitude (clockwise in 0 to 360 domain).

The method can only be used if SetGround, SetCoordinate, SetUniversalGround, or SetWorld return with success. Success can also be checked using the IsGood method.

Returns:: double The universal ring longitude.

References Isis::RingPlaneProjection::Clockwise, Isis::RingPlaneProjection::m_ringLongitude, Isis::RingPlaneProjection::m_ringLongitudeDirection, and Isis::RingPlaneProjection::To360Domain().

Referenced by Isis::Camera::SetImage().

double Isis::RingPlaneProjection::UniversalRingRadius ( ) [inherited]

This returns a universal radius, which is just the radius in meters.

Returns:: double The universal radius.

References Isis::RingPlaneProjection::m_ringRadius.

Referenced by Isis::Camera::SetImage().

QString Isis::RingCylindrical::Version ( ) const [virtual]

Returns the version of the map projection.

Returns:: QString Version number

Implements Isis::RingPlaneProjection.

double Isis::Projection::WorldX ( ) const [inherited]

This returns the world X coordinate provided SetGround, SetCoordinate, SetUniversalGround, or SetWorld returned with success.

Success can also be checked using the IsGood method. The units of X will be in the units as specified by the WorldMapper object which was given to the SetWorldMapper method. If a mapper object was not given then world coordinates are the same as the projection coordinates (i.e., WorldX and XCoord will return the same value).

Returns:: double The world X coordinate.

References Isis::Projection::m_mapper, and Isis::WorldMapper::WorldX().

Referenced by Isis::Chip::Load(), Isis::DemShape::localRadius(), Isis::UniversalGroundMap::Sample(), Isis::Camera::SetRightAscensionDeclination(), and Isis::ProcessMapMosaic::StartProcess().

double Isis::Projection::WorldY ( ) const [inherited]

This returns the world Y coordinate provided SetGround, SetCoordinate, SetUniversalGround, or SetWorld returned with success.

Success can also be checked using the IsGood method. The units of Y will be in the units as specified by the WorldMapper object which was given to the SetWorldMapper. If a mapper object was not given then world coordinates are the same as the projection coordinates (i.e., WorldY and YCoord will return the same value).

Returns:: double The world Y coordinate.

References Isis::Projection::m_mapper, and Isis::WorldMapper::WorldY().

Referenced by Isis::UniversalGroundMap::Line(), Isis::Chip::Load(), Isis::DemShape::localRadius(), and Isis::Camera::SetRightAscensionDeclination().

double Isis::Projection::XCoord ( ) const [inherited]

This returns the projection X provided SetGround, SetCoordinate, SetUniversalGround, or SetWorld returned with success.

Success can also be checked using the IsGood method. The units of X will be in the same . units as the radii obtained from the label.

Returns:: double

Referenced by Isis::ProjectionFactory::CreateForCube(), Isis::ProcessExport::CreateWorldFile(), Isis::MosaicFindTool::getUserGroundPoint(), Isis::GridGraphicsItem::GridGraphicsItem(), Isis::PolygonTools::LatLonToXY(), Isis::MosaicSceneItem::reproject(), Isis::ProjectionFactory::RingsCreateForCube(), Isis::TProjection::SetCoordinate(), Isis::RingPlaneProjection::SetCoordinate(), Isis::MosaicGridTool::setLatExtents(), Isis::SubArea::UpdateLabel(), Isis::MosaicAreaTool::userChangedBox(), Isis::LambertConformal::XYRange(), Isis::TProjection::XYRangeCheck(), and Isis::RingPlaneProjection::XYRangeCheck().

bool Isis::RingCylindrical::XYRange	(	double &	minX,
		double &	maxX,
		double &	minY,
		double &	maxY
	)			`[virtual]`

This method is used to determine the x/y range which completely covers the area of interest specified by the radus/lon range.

The radius/longitude range may be obtained from the labels. This method should not be used if HasGroundRange is false. The purpose of this method is to return the x/y range so it can be used to compute how large a map may need to be. For example, how big a piece of paper is needed or how large of an image needs to be created. This is method and therefore must be written by the derived class (e.g., RingCylindrical). The method may fail as indicated by its return value.

Parameters:

	&minX	Reference to the address where the minimum x coordinate value will be written. The Minimum x projection coordinate calculated by this method covers the radius/longitude range specified in the labels.
	&maxX	Reference to the address where the maximum x coordinate value will be written. The Maximum x projection coordinate calculated by this method covers the radius/longitude range specified in the labels.
	&minY	Reference to the address where the minimum y coordinate value will be written. The Minimum y projection coordinate calculated by this method covers the radius/longitude range specified in the labels.
	&maxY	Reference to the address where the maximum y coordinate value will be written. The Maximum y projection coordinate calculated by this method covers the radius/longitude range specified in the labels.

Returns:: bool Indicates whether the method was able to determine the X/Y Range of the projection. If yes, minX, maxX, minY, maxY will be set with these values.

Reimplemented from Isis::RingPlaneProjection.

References Isis::RingPlaneProjection::m_maximumRingLongitude, Isis::RingPlaneProjection::m_maximumRingRadius, Isis::Projection::m_maximumX, Isis::Projection::m_maximumY, Isis::RingPlaneProjection::m_minimumRingLongitude, Isis::RingPlaneProjection::m_minimumRingRadius, Isis::Projection::m_minimumX, Isis::Projection::m_minimumY, Isis::Projection::PixelResolution(), and Isis::RingPlaneProjection::XYRangeCheck().

void Isis::RingPlaneProjection::XYRangeCheck	(	const double	ringRadius,
		const double	ringLongitude
	)			`[protected, virtual, inherited]`

This convience function is established to assist in the development of the XYRange virtual method.

It allows the developer to test ground points (ring radius/longitude) to see if they produce a minimum/maximum projection coordinate. For example in Planar,

       bool Planar::XYRange(double &minX, double &maxX,
                                    double &minY, double &maxY) {
        // Check the corners of the ring rad/lon range
         XYRangeCheck (m_minimumRingRadius,m_minimumRingLongitude);
         XYRangeCheck (m_maximumRingRadius,m_minimumRingLongitude);
         XYRangeCheck (m_minimumRingRadius,m_maximumRingLongitude);
         XYRangeCheck (m_maximumRingRadius,m_maximumRingLongitude);

         // If the ring longitude crosses 0/360 check there
         if ((m_minimumRingLongitude < 0.0) && (m_maximumRingLongitude > 0.0)) ||
             (m_minimumRingLongitude < 360.0) && (m_maximumRingLongitude > 360.0)) {
           XYRangeCheck (minimumRingRadius, 0. or 360.);
           XYRangeCheck (maximumRingRadius, 0 or 360.);
         }

         // Make sure everything is ordered
         if (m_minimumX >= m_maximumX) return false;
         if (m_minimumY >= m_maximumY) return false;

         // Return X/Y min/maxs
         minX = m_minimumX;
         maxX = m_maximumX;
         minY = m_minimumY;
         maxY = m_maximumY;
         return true;
      }

Parameters:

	ringRadius	Test for min/max projection coordinates at this radius
	ringLongitude	Test for min/max projection coordinates at this ring longitude

Implements Isis::Projection.

References Isis::Projection::IsGood(), Isis::Projection::m_good, Isis::Projection::m_maximumX, Isis::Projection::m_maximumY, Isis::Projection::m_minimumX, Isis::Projection::m_minimumY, Isis::Null, Isis::RingPlaneProjection::SetGround(), Isis::Projection::XCoord(), and Isis::Projection::YCoord().

Referenced by XYRange(), and Isis::Planar::XYRange().

double Isis::Projection::YCoord ( ) const [inherited]

This returns the projection Y provided SetGround, SetCoordinate, SetUniversalGround, or SetWorld returned with success.

Success can also be checked using the IsGood method. The units of Y will be in the same units as the radii obtained from the label.

Returns:: double

Referenced by Isis::ProjectionFactory::CreateForCube(), Isis::ProcessExport::CreateWorldFile(), Isis::MosaicFindTool::getUserGroundPoint(), Isis::GridGraphicsItem::GridGraphicsItem(), Isis::PolygonTools::LatLonToXY(), Isis::MosaicSceneItem::reproject(), Isis::ProjectionFactory::RingsCreateForCube(), Isis::TProjection::SetCoordinate(), Isis::RingPlaneProjection::SetCoordinate(), Isis::MosaicGridTool::setLatExtents(), Isis::SubArea::UpdateLabel(), Isis::MosaicAreaTool::userChangedBox(), Isis::LambertConformal::XYRange(), Isis::TProjection::XYRangeCheck(), and Isis::RingPlaneProjection::XYRangeCheck().

Member Data Documentation

bool Isis::Projection::m_good [protected, inherited]

Indicates if the contents of m_x, m_y, m_latitude, and m_longitude are valid.

bool Isis::Projection::m_groundRangeGood [protected, inherited]

Indicates if the ground range (min/max lat/lons) were read from the labels.

Referenced by Isis::Projection::HasGroundRange(), Isis::RingPlaneProjection::RingPlaneProjection(), Isis::TProjection::TProjection(), Isis::TProjection::XYRange(), and Isis::RingPlaneProjection::XYRange().

WorldMapper* Isis::Projection::m_mapper [protected, inherited]

This points to a mapper passed into the SetWorldMapper method.

This mapper allows the programmer to specify a different world coordinate system. Thus the programmer could pass in line/sample positions in order to obtain a latitude/longitude or set a lat/lon and get a line/sample.

Referenced by Isis::Projection::Projection(), Isis::Projection::Resolution(), Isis::TProjection::Scale(), Isis::RingPlaneProjection::Scale(), Isis::Projection::SetWorld(), Isis::Projection::SetWorldMapper(), Isis::Projection::ToProjectionX(), Isis::Projection::ToProjectionY(), Isis::Projection::ToWorldX(), Isis::Projection::ToWorldY(), Isis::Projection::WorldX(), Isis::Projection::WorldY(), and Isis::Projection::~Projection().

PvlGroup Isis::Projection::m_mappingGrp [protected, inherited]

Mapping group that created this projection.

double Isis::RingPlaneProjection::m_maximumRingLongitude [protected, inherited]

Contains the maximum longitude for the entire ground range.

Only usable if m_groundRangeGood is true.

Referenced by Isis::RingPlaneProjection::MaximumRingLongitude(), Isis::Planar::Planar(), RingCylindrical(), Isis::RingPlaneProjection::RingPlaneProjection(), Isis::RingPlaneProjection::XYRange(), XYRange(), and Isis::Planar::XYRange().

double Isis::RingPlaneProjection::m_maximumRingRadius [protected, inherited]

Contains the maximum ring radius for the entire ground range.

Only usable if m_groundRangeGood is true.

Referenced by Isis::RingPlaneProjection::MaximumRingRadius(), Isis::Planar::Planar(), RingCylindrical(), Isis::RingPlaneProjection::RingPlaneProjection(), SetCoordinate(), Isis::RingPlaneProjection::XYRange(), XYRange(), and Isis::Planar::XYRange().

double Isis::Projection::m_maximumX [protected, inherited]

See minimumX description.

Referenced by Isis::Projection::Projection(), Isis::TransverseMercator::XYRange(), Isis::Sinusoidal::XYRange(), Isis::SimpleCylindrical::XYRange(), Isis::Robinson::XYRange(), XYRange(), Isis::PolarStereographic::XYRange(), Isis::PointPerspective::XYRange(), Isis::Planar::XYRange(), Isis::Orthographic::XYRange(), Isis::Mercator::XYRange(), Isis::LunarAzimuthalEqualArea::XYRange(), Isis::LambertConformal::XYRange(), Isis::Equirectangular::XYRange(), Isis::TProjection::XYRangeCheck(), Isis::RingPlaneProjection::XYRangeCheck(), and Isis::TProjection::xyRangeOblique().

double Isis::Projection::m_maximumY [protected, inherited]

See minimumX description.

Referenced by Isis::Projection::Projection(), Isis::TransverseMercator::XYRange(), Isis::Sinusoidal::XYRange(), Isis::SimpleCylindrical::XYRange(), Isis::Robinson::XYRange(), XYRange(), Isis::PolarStereographic::XYRange(), Isis::PointPerspective::XYRange(), Isis::Planar::XYRange(), Isis::Orthographic::XYRange(), Isis::Mercator::XYRange(), Isis::LunarAzimuthalEqualArea::XYRange(), Isis::LambertConformal::XYRange(), Isis::Equirectangular::XYRange(), Isis::TProjection::XYRangeCheck(), Isis::RingPlaneProjection::XYRangeCheck(), and Isis::TProjection::xyRangeOblique().

double Isis::RingPlaneProjection::m_minimumRingLongitude [protected, inherited]

Contains the minimum longitude for the entire ground range.

Only usable if m_groundRangeGood is true.

Referenced by Isis::RingPlaneProjection::MinimumRingLongitude(), Isis::Planar::Planar(), RingCylindrical(), Isis::RingPlaneProjection::RingPlaneProjection(), Isis::RingPlaneProjection::XYRange(), XYRange(), and Isis::Planar::XYRange().

double Isis::RingPlaneProjection::m_minimumRingRadius [protected, inherited]

Contains the minimum ring radius for the entire ground range.

Only usable if m_groundRangeGood is true.

Referenced by Isis::RingPlaneProjection::MinimumRingRadius(), Isis::Planar::Planar(), RingCylindrical(), Isis::RingPlaneProjection::RingPlaneProjection(), Isis::RingPlaneProjection::XYRange(), XYRange(), and Isis::Planar::XYRange().

double Isis::Projection::m_minimumX [protected, inherited]

The data elements m_minimumX, m_minimumY, m_maximumX, and m_maximumY are convience data elements when you write the XYRange virtual function.

They are used in conjuction with the XYRangeCheck convience method. After utilizing XYRangeCheck to test boundary conditions in the XYRange method these values will contain the projection x/y coverage for the ground range specified by min/max lat/lon.

Referenced by Isis::Projection::Projection(), Isis::TransverseMercator::XYRange(), Isis::Sinusoidal::XYRange(), Isis::SimpleCylindrical::XYRange(), Isis::Robinson::XYRange(), XYRange(), Isis::PolarStereographic::XYRange(), Isis::PointPerspective::XYRange(), Isis::Planar::XYRange(), Isis::Orthographic::XYRange(), Isis::Mercator::XYRange(), Isis::LunarAzimuthalEqualArea::XYRange(), Isis::LambertConformal::XYRange(), Isis::Equirectangular::XYRange(), Isis::TProjection::XYRangeCheck(), Isis::RingPlaneProjection::XYRangeCheck(), and Isis::TProjection::xyRangeOblique().