Calculates a lat/lon grid over an area. More...

#include <GroundGrid.h>

Public Member Functions
	GroundGrid (UniversalGroundMap *gmap, bool splitLatLon, unsigned int width, unsigned int height)
	This method initializes the class by allocating the grid, calculating the lat/lon range, and getting a default grid resolution. More...

virtual	~GroundGrid ()
	Delete the object. More...

void	CreateGrid (Latitude baseLat, Longitude baseLon, Angle latInc, Angle lonInc, Progress *progress=0)
	This method draws the grid internally, using default resolutions. More...

void	CreateGrid (Latitude baseLat, Longitude baseLon, Angle latInc, Angle lonInc, Progress *progress, Angle latRes, Angle lonRes)
	This method draws the grid internally. More...

void	WalkBoundary ()
	This draws grid lines along the extremes of the lat/lon box of the grid. More...

void	SetGroundLimits (Latitude minLat, Longitude minLon, Latitude maxLat, Longitude maxLon)
	This restricts (or grows) the ground range in which to draw grid lines. More...

bool	PixelOnGrid (int x, int y)
	Returns true if the grid is on this point. More...

bool	PixelOnGrid (int x, int y, bool latGrid)
	Returns true if the grid is on this point. More...

PvlGroup *	GetMappingGroup ()
	Returns a mapping group representation of the projection or camera. More...

Protected Member Functions
virtual bool	GetXY (Latitude lat, Longitude lon, unsigned int &x, unsigned int &y)
	This method converts a lat/lon to an X/Y. More...

UniversalGroundMap *	GroundMap ()
	Returns the ground map for children. More...

Detailed Description

Calculates a lat/lon grid over an area.

This class, given a universal ground map, area width and height, base lat/lon, lat/lon increments, and optionalls a progress and resolutions will calculate where grid lines should lie.

Author: 2010-01-06 Steven Lambright

Constructor & Destructor Documentation

Isis::GroundGrid::GroundGrid	(	UniversalGroundMap *	gmap,
		bool	splitLatLon,
		unsigned int	width,
		unsigned int	height
	)

This method initializes the class by allocating the grid, calculating the lat/lon range, and getting a default grid resolution.

Parameters

gmap	A universal ground map to use for calculating the grid
splitLatLon	Make two grids: one for latitude lines and one for longitude lines
width	The width of the grid; often cube samples
height	The height of the grid; often cube samples

References Isis::PvlObject::findGroup(), Isis::Distance::meters(), and Isis::toDouble().

Isis::GroundGrid::~GroundGrid ( )

virtual

Delete the object.

Member Function Documentation

void Isis::GroundGrid::CreateGrid	(	Latitude	baseLat,
		Longitude	baseLon,
		Angle	latInc,
		Angle	lonInc,
		Progress *	progress = `0`
	)

This method draws the grid internally, using default resolutions.

Parameters

baseLat	Latitude to hit in the grid
baseLon	Longitude to hit in the grid
latInc	Distance between latitude lines
lonInc	Distance between longitude lines
progress	If passed in, this progress will be used

void Isis::GroundGrid::CreateGrid	(	Latitude	baseLat,
		Longitude	baseLon,
		Angle	latInc,
		Angle	lonInc,
		Progress *	progress,
		Angle	latRes,
		Angle	lonRes
	)

This method draws the grid internally.

It is not valid to call PixelOnGrid until this method has been called.

Parameters

baseLat	Latitude to hit in the grid
baseLon	Longitude to hit in the grid
latInc	Distance between latitude lines
lonInc	Distance between longitude lines
progress	If passed in, this progress will be used
latRes	Resolution of latitude lines (in degrees/pixel)
lonRes	Resolution of longitude lines (in degrees/pixel)

References _FILEINFO_, Isis::Progress::CheckStatus(), Isis::Angle::isValid(), and Isis::Progress::SetMaximumSteps().

PvlGroup * Isis::GroundGrid::GetMappingGroup ( )

Returns a mapping group representation of the projection or camera.

This is useful for matching units with lat/lons.

Returns: Returns a mapping group representation of the projection or camera

bool Isis::GroundGrid::GetXY	(	Latitude	lat,
		Longitude	lon,
		unsigned int &	x,
		unsigned int &	y
	)

protectedvirtual

This method converts a lat/lon to an X/Y.

This implementation converts to sample/line.

Parameters

lat	Latitude of Lat/Lon pair to convert to S/L
lon	Longitude of Lat/Lon pair to convert to S/L
x	Output sample (0-based)
y	Output line (0-based)

Returns: bool Successful

UniversalGroundMap * Isis::GroundGrid::GroundMap ( )

protected

Returns the ground map for children.

bool Isis::GroundGrid::PixelOnGrid	(	int	x,
		int	y
	)

Returns true if the grid is on this point.

Parameters

x	X-Coordinate of grid (0-based)
y	Y-Coordinate of grid (0-based)

Returns: bool Pixel lies on grid

bool Isis::GroundGrid::PixelOnGrid	(	int	x,
		int	y,
		bool	latGrid
	)

Returns true if the grid is on this point.

Using this method is recommended if lat/lon grids are separate.

Parameters

x	X-Coordinate of grid (0-based)
y	Y-Coordinate of grid (0-based)
latGrid	True for latitude lines, false for longitude lines

Returns: bool Pixel lies on grid

void Isis::GroundGrid::SetGroundLimits	(	Latitude	minLat,
		Longitude	minLon,
		Latitude	maxLat,
		Longitude	maxLon
	)

This restricts (or grows) the ground range in which to draw grid lines.

Parameters

minLat	The lowest latitude extreme to draw grid lines to
maxLat	The highest latitude extreme to draw grid lines to
minLon	The lowest longitude extreme to draw grid lines to
maxLon	The highest longitude extreme to draw grid lines to

References Isis::Angle::isValid().

void Isis::GroundGrid::WalkBoundary ( )

This draws grid lines along the extremes of the lat/lon box of the grid.

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

src/base/objs/GroundGrid/GroundGrid.h
src/base/objs/GroundGrid/GroundGrid.cpp

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation