Isis::UniversalGroundMap Class Reference
[Geometry]

Universal Ground Map. More...

#include <UniversalGroundMap.h>

Public Types
enum	CameraPriority { CameraFirst, ProjectionFirst }
	This enum is used to define whether to use a camera or projection primarily, and which to fall back on. More...
Public Member Functions
	UniversalGroundMap (Pvl &pvl, CameraPriority priority=CameraFirst)
	Constructs a UniversalGroundMap object from a pvl.
	UniversalGroundMap (Cube &cube, CameraPriority priority=CameraFirst)
	Constructs a UniversalGroundMap object from a cube.
	~UniversalGroundMap ()
	Destroys the UniversalGroundMap object.
void	SetBand (const int band)
	Set the image band number.
bool	SetUniversalGround (double lat, double lon)
	Returns whether the lat/lon position was set successfully in the camera model or projection.
bool	SetGround (Latitude lat, Longitude lon)
	Returns whether the lat/lon position was set successfully in the camera model or projection.
bool	SetGround (const SurfacePoint &)
	Returns whether the SurfacePoint was set successfully in the camera model or projection.
double	Sample () const
	Returns the current line value of the camera model or projection.
double	Line () const
	Returns the current line value of the camera model or projection.
bool	SetImage (double sample, double line)
	Returns whether the sample/line postion was set successfully in the camera model or projection.
double	UniversalLatitude () const
	Returns the universal latitude of the camera model or projection.
double	UniversalLongitude () const
	Returns the universal longitude of the camera model or projection.
double	Resolution () const
	Returns the resolution of the camera model or projection.
bool	GroundRange (Cube *cube, Latitude &minLat, Latitude &maxLat, Longitude &minLon, Longitude &maxLon, bool allowEstimation=true)
	Find the lat/lon range of the image.
bool	HasProjection ()
	Returns whether the ground map has a projection or not.
bool	HasCamera ()
	Returns whether the ground map has a camera or not.
Isis::Projection *	Projection () const
	Return the projection associated with the ground map (NULL implies none).
Isis::Camera *	Camera () const
	Return the camera associated with the ground map (NULL implies none).

Detailed Description

Universal Ground Map.

???

Author:: 2005-08-09 Jeff Anderson

Member Enumeration Documentation

enum Isis::UniversalGroundMap::CameraPriority

This enum is used to define whether to use a camera or projection primarily, and which to fall back on.

Enumerator:

CameraFirst

This is the default because cameras are projection-aware.

Use the camera for additional power if available, and fall back to projection

ProjectionFirst

Use the projection for functionality well outside the original image if available, and fall back to camera.

Constructor & Destructor Documentation

Isis::UniversalGroundMap::UniversalGroundMap	(	Pvl &	pvl,
		CameraPriority	priority = `CameraFirst`
	)

Constructs a UniversalGroundMap object from a pvl.

Parameters:

	pvl	The Pvl file to create the UniversalGroundMap from
	priority	Try to make a camera or projection first

Isis::UniversalGroundMap::UniversalGroundMap	(	Cube &	cube,
		CameraPriority	priority = `CameraFirst`
	)

Constructs a UniversalGroundMap object from a cube.

Parameters:

	cube	The Cube to create the UniversalGroundMap from
	priority	Try to make a camera or projection first

References Isis::Cube::label().

Isis::UniversalGroundMap::~UniversalGroundMap ( )

Destroys the UniversalGroundMap object.

Member Function Documentation

Isis::Camera* Isis::UniversalGroundMap::Camera ( ) const [inline]

Return the camera associated with the ground map (NULL implies none).

Referenced by Isis::ImagePolygon::Create(), Isis::CubeViewport::CubeViewport(), Isis::GroundGrid::GroundGrid(), and Isis::ImagePolygon::initCube().

bool Isis::UniversalGroundMap::GroundRange	(	Cube *	cube,
		Latitude &	minLat,
		Latitude &	maxLat,
		Longitude &	minLon,
		Longitude &	maxLon,
		bool	allowEstimation = `true`
	)

Find the lat/lon range of the image.

This will use the image footprint, camera, or projection in order to find a good result.

Parameters:

	Cube*	This is required for estimation. You can pass in NULL (it will disable estimation).
	minLat	This is an output: minimum latitude
	maxLat	This is an output: maximum latitude
	minLon	This is an output: minimum longitude
	maxLon	This is an output: maximum longitude
	allowEstimation	If this is true then extra efforts will be made to guess the ground range of the input. This can still fail.

Returns:: True if a ground range was found, false if no ground range could be determined. Some lat/lon results may still be populated; their values are undefined.

References Isis::Angle::Degrees, Isis::Camera::GroundRange(), HasCamera(), Isis::PvlContainer::HasKeyword(), HasProjection(), Isis::Angle::isValid(), Isis::Cube::lineCount(), Isis::PolygonTools::MakeMultiPolygon(), Isis::Projection::Mapping(), poly(), Isis::ImagePolygon::Polys(), Isis::Cube::read(), Isis::Cube::sampleCount(), Isis::Projection::SetWorld(), Isis::Projection::UniversalLatitude(), and Isis::Projection::UniversalLongitude().

bool Isis::UniversalGroundMap::HasCamera ( ) [inline]

Returns whether the ground map has a camera or not.

Returns:: bool Returns true if the ground map has a camera, and false if it does not

Referenced by Isis::GroundGrid::GroundGrid(), GroundRange(), and Isis::InterestOperator::Operate().

bool Isis::UniversalGroundMap::HasProjection ( ) [inline]

Returns whether the ground map has a projection or not.

Returns:: bool Returns true if the ground map has a projection, and false if it does not

Referenced by GroundRange().

double Isis::UniversalGroundMap::Line ( ) const

Returns the current line value of the camera model or projection.

Returns:: Line value

References Isis::Camera::Line(), and Isis::Projection::WorldY().

Referenced by Isis::StereoTool::createPoint(), Isis::GroundGrid::GetXY(), Isis::PolygonTools::LatLonToSampleLine(), Isis::FindTool::paintViewport(), and Isis::FindTool::updateTool().

Isis::Projection* Isis::UniversalGroundMap::Projection ( ) const [inline]

Return the projection associated with the ground map (NULL implies none).

Referenced by Isis::CubeViewport::CubeViewport(), and Isis::GroundGrid::GroundGrid().

double Isis::UniversalGroundMap::Resolution ( ) const

Returns the resolution of the camera model or projection.

Returns:: Resolution

References Isis::Camera::PixelResolution(), and Isis::Projection::Resolution().

Referenced by Isis::GroundGrid::GroundGrid().

double Isis::UniversalGroundMap::Sample ( ) const

Returns the current line value of the camera model or projection.

Returns:: Sample value

References Isis::Camera::Sample(), and Isis::Projection::WorldX().

Referenced by Isis::StereoTool::createPoint(), Isis::GroundGrid::GetXY(), Isis::PolygonTools::LatLonToSampleLine(), Isis::FindTool::paintViewport(), and Isis::FindTool::updateTool().

void Isis::UniversalGroundMap::SetBand ( const int band )

Set the image band number.

Parameters:

[in] band (int) Image band number

References Isis::Camera::SetBand().

Referenced by Isis::ImagePolygon::initCube().

bool Isis::UniversalGroundMap::SetGround ( const SurfacePoint & sp )

Returns whether the SurfacePoint was set successfully in the camera model or projection.

Parameters:

sp

The Surface Point to set ground with

Returns:: Returns true if the Surface Point was set successfully, and false otherwise

References Isis::Angle::degrees(), Isis::SurfacePoint::GetLatitude(), Isis::SurfacePoint::GetLongitude(), Isis::Camera::InCube(), Isis::Camera::SetGround(), and Isis::Projection::SetUniversalGround().

bool Isis::UniversalGroundMap::SetGround	(	Latitude	lat,
		Longitude	lon
	)

Returns whether the lat/lon position was set successfully in the camera model or projection.

Parameters:

	lat	The latitude
	lon	The longitude

Returns:: Returns true if the lat/lon position was set successfully, and false if it was not

References Isis::Angle::degrees(), Isis::Camera::InCube(), Isis::Camera::SetGround(), and Isis::Projection::SetUniversalGround().

bool Isis::UniversalGroundMap::SetImage	(	double	sample,
		double	line
	)

Returns whether the sample/line postion was set successfully in the camera model or projection.

Parameters:

	sample	The sample position
	line	The line position

Returns:: Returns true if the sample/line position was set successfully, and false if it was not

References Isis::Camera::SetImage(), and Isis::Projection::SetWorld().

Referenced by Isis::FindTool::mouseButtonRelease(), Isis::InterestOperator::Operate(), Isis::StereoTool::rubberBandComplete(), and Isis::FindTool::updateTool().

bool Isis::UniversalGroundMap::SetUniversalGround	(	double	lat,
		double	lon
	)

Returns whether the lat/lon position was set successfully in the camera model or projection.

Parameters:

	lat	The universal latitude
	lon	The universal longitude

Returns:: Returns true if the lat/lon position was set successfully, and false if it was not

References Isis::Camera::InCube(), Isis::Projection::SetUniversalGround(), and Isis::Camera::SetUniversalGround().

Referenced by Isis::StereoTool::createPoint(), Isis::PolygonTools::LatLonToSampleLine(), Isis::FindTool::paintViewport(), and Isis::FindTool::updateTool().

double Isis::UniversalGroundMap::UniversalLatitude ( ) const

Returns the universal latitude of the camera model or projection.

Returns:: Universal Latitude

References Isis::Projection::UniversalLatitude(), and Isis::Sensor::UniversalLatitude().

Referenced by Isis::FindTool::mouseButtonRelease(), Isis::StereoTool::rubberBandComplete(), and Isis::FindTool::updateTool().

double Isis::UniversalGroundMap::UniversalLongitude ( ) const

Returns the universal longitude of the camera model or projection.

Returns:: Universal Longitude

References Isis::Projection::UniversalLongitude(), and Isis::Sensor::UniversalLongitude().

Referenced by Isis::FindTool::mouseButtonRelease(), Isis::StereoTool::rubberBandComplete(), and Isis::FindTool::updateTool().

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

src/base/objs/UniversalGroundMap/UniversalGroundMap.h
src/base/objs/UniversalGroundMap/UniversalGroundMap.cpp

Isis::UniversalGroundMap Class Reference [Geometry]

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Isis::UniversalGroundMap Class Reference
[Geometry]