Isis::ImagePolygon Class Reference

Create cube polygons, read/write polygons to blobs. More...

#include <ImagePolygon.h>

Collaboration diagram for Isis::ImagePolygon:

Public Member Functions
	ImagePolygon ()
	Constructs a Polygon object, setting the polygon name. More...
	ImagePolygon (Blob &blob)
	Constructs a Polygon object from a Blob. More...
	~ImagePolygon ()
	Destroys the Polygon object. More...
void	Create (Cube &cube, int sinc=1, int linc=1, int ss=1, int sl=1, int ns=0, int nl=0, int band=1, bool increasePrecision=false)
	Create a Polygon from given cube. More...
void	Create (std::vector< std::vector< double >> polyCoordinates)
Camera *	initCube (Cube &cube, int ss=1, int sl=1, int ns=0, int nl=0, int band=1)
	Create a Polygon from given cube. More...
void	Emission (double emission)
	Set the maximum emission angle ( light refleted to camera ) More...
void	Incidence (double incidence)
	Set the maximum incidence angle ( light contacting the planet ) More...
void	EllipsoidLimb (bool ellip)
	If a limb is detected, use un ellipsoid shape model if true. More...
void	SubpixelAccuracy (int div)
	The subpixel accuracy to use. More...
geos::geom::MultiPolygon *	Polys ()
	Return a geos Multipolygon. More...
std::string	polyStr () const
	Return a geos Multipolygon. More...
double	validSampleDim ()
	Retuns the maximum valid sample width of the cube set with either initCube() or Create() More...
double	validLineDim ()
	Retuns the maximum valid line width of the cube set with either initCube() or Create() More...
int	getSinc () const
	Return the sample increment used the create this polygon. More...
int	getLinc () const
	Return the line increment used the create this polygon. More...
int	numVertices () const
Blob	toBlob () const
	Serialize the ImagePolygon to a Blob. More...

Detailed Description

Create cube polygons, read/write polygons to blobs.

This class creates polygons defining an image boundary, reads the polygon from a cube blob, and writes a polygon to a cube blob. The GEOS (Geometry Engine Open Source) package is used to create and manipulate the polygons. See http://geos.refractions.net for information about this package.

Author

2005-11-22 Tracie Sucharski

Constructor & Destructor Documentation

ImagePolygon() [1/2]

Isis::ImagePolygon::ImagePolygon

(

)

Constructs a Polygon object, setting the polygon name.

ImagePolygon() [2/2]

Isis::ImagePolygon::ImagePolygon

(

Blob &

blob

)

Constructs a Polygon object from a Blob.

References Isis::Blob::getBuffer(), Isis::globalFactory, Isis::PolygonTools::MakeMultiPolygon(), and Isis::Blob::Size().

~ImagePolygon()

Isis::ImagePolygon::~ImagePolygon

(

)

Destroys the Polygon object.

Member Function Documentation

Create() [1/2]

void Isis::ImagePolygon::Create	(	Cube &	cube,
		int	sinc = 1,
		int	linc = 1,
		int	ss = 1,
		int	sl = 1,
		int	ns = 0,
		int	nl = 0,
		int	band = 1,
		bool	increasePrecision = false
	)

Create a Polygon from given cube.

Parameters

[in]	cube	(Cube &) Cube used to create polygon
[in]	sinc	(Default=1) (in) Pixel increment to define the granularity of the resulting polygon in the sample direction
[in]	linc	(Default=1) (in) Pixel increment to define the granularity of the resulting polygon in the line direction
[in]	ss	(Default=1) (in) Starting sample number
[in]	sl	(Default=1) (in) Starting Line number
[in]	ns	(Default=0) (in) Number of samples used to create the polygon. Default of 0 will cause ns to be set to the number of samples in the cube.
[in]	nl	(Default=0) (in) Number of lines used to create the polygon. Default of 0 will cause nl to be set to the number of lines in the cube.
[in]	band	(Default=1) (in) Image band number
	increasePrecision	Iteratively refine sinc and linc (defaults to false)

History:

2008-04-28 Tracie Sucharski, When calculating p_pixInc, set to 1 if values calculated is 0.

History:

2008-12-30 Tracie Sucharski - If ground map returns pole make sure it is actually on the image.

History:

2009-05-28 Stuart Sides - Added the quality argument.

References _FILEINFO_, Isis::Camera::BasicMapping(), Isis::UniversalGroundMap::Camera(), Isis::Cube::fileName(), Isis::Sensor::IgnoreElevationModel(), initCube(), Isis::IException::print(), and Isis::IException::User.

Create() [2/2]

void Isis::ImagePolygon::Create

(

std::vector< std::vector< double >>

polyCoordinates

)

References Isis::globalFactory.

EllipsoidLimb()

void Isis::ImagePolygon::EllipsoidLimb ( bool  ellip )

inline

If a limb is detected, use un ellipsoid shape model if true.

If false, use the default (spiceinit defined) shape model.

Parameters

ellip

True to use ellipsoid on limb images

Emission()

void Isis::ImagePolygon::Emission ( double  emission )

inline

Set the maximum emission angle ( light refleted to camera )

Parameters

emission

The maximum valid emission angle

getLinc()

int Isis::ImagePolygon::getLinc ( ) const

inline

Return the line increment used the create this polygon.

getSinc()

int Isis::ImagePolygon::getSinc ( ) const

inline

Return the sample increment used the create this polygon.

Incidence()

void Isis::ImagePolygon::Incidence ( double  incidence )

inline

Set the maximum incidence angle ( light contacting the planet )

Parameters

incidence

The maximum valid incidence angle

initCube()

Camera * Isis::ImagePolygon::initCube	(	Cube &	cube,
		int	ss = 1,
		int	sl = 1,
		int	ns = 0,
		int	nl = 0,
		int	band = 1
	)

Create a Polygon from given cube.

Parameters

[in]	cube	(Cube &) Cube used to create polygon
[in]	ss	(Default=1) (in) Starting sample number
[in]	sl	(Default=1) (in) Starting Line number
[in]	ns	(Default=0) (in) Number of samples used to create the polygon. Default of 0 will cause ns to be set to the number of samples in the cube.
[in]	nl	(Default=0) (in) Number of lines used to create the polygon. Default of 0 will cause nl to be set to the number of lines in the cube.
[in]	band	(Default=1) (in) Image band number

References _FILEINFO_, Isis::IException::append(), Isis::Cube::camera(), Isis::UniversalGroundMap::Camera(), Isis::Cube::fileName(), Isis::Camera::HasProjection(), Isis::Sensor::IgnoreElevationModel(), Isis::Cube::lineCount(), Isis::Cube::pixelType(), Isis::Cube::projection(), Isis::Cube::sampleCount(), Isis::UniversalGroundMap::SetBand(), and Isis::IException::User.

Referenced by Create().

numVertices()

int Isis::ImagePolygon::numVertices ( ) const

inline

Polys()

geos::geom::MultiPolygon* Isis::ImagePolygon::Polys ( )

inline

Return a geos Multipolygon.

Referenced by Isis::ImageOverlapSet::FindImageOverlaps(), and Isis::UniversalGroundMap::GroundRange().

polyStr()

std::string Isis::ImagePolygon::polyStr ( ) const

inline

Return a geos Multipolygon.

Referenced by toBlob().

SubpixelAccuracy()

void Isis::ImagePolygon::SubpixelAccuracy ( int  div )

inline

The subpixel accuracy to use.

This accuracy is the number of binary steps to take to find the subpixel accuracy. A higher number provided gives more accurate results at the cost of runtime.

ImagePolygon's constructor sets a default value of 50

Parameters

div	The subpixel accuracy to use

toBlob()

Blob Isis::ImagePolygon::toBlob

(

)

const

Serialize the ImagePolygon to a Blob.

The polygon will be serialized as a WKT srtring.

Returns

Blob

References _FILEINFO_, polyStr(), Isis::IException::Programmer, and Isis::Blob::setData().

Referenced by Isis::Image::isFootprintable(), Isis::Shape::isFootprintable(), and Isis::Cube::write().

validLineDim()

double Isis::ImagePolygon::validLineDim

(

)

Retuns the maximum valid line width of the cube set with either initCube() or Create()

validSampleDim()

double Isis::ImagePolygon::validSampleDim

(

)

Retuns the maximum valid sample width of the cube set with either initCube() or Create()

---

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

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