This class is used to rewrite the "alpha" keywords out of the AlphaCube group or Instrument group. More...

#include <AlphaCube.h>

Collaboration diagram for Isis::AlphaCube:

Public Member Functions
	AlphaCube (Cube &cube)
	Constructs an AlphaCube object using a PVL object.

	AlphaCube (int alphaSamples, int alphaLines, int betaSamples, int betaLines)
	Constructs an AlphaCube object given alphaSamples, alphaLines, betaSamples and betaLines.

	AlphaCube (int alphaSamples, int alphaLines, int betaSamples, int betaLines, double alphaSs, double alphaSl, double alphaEs, double alphaEl)
	Constructs an AlphaCube object with a basic mapping from corner-to-corner, beta 0.5,0.5 maps to alpha 0.5,0.5 and beta ns+0.5,nl+0.5 maps to alpha ns+0.5, nl+0.5.

	~AlphaCube ()
	Destroys the AlphaCube object.

int	AlphaLines () const
	Returns the number of lines in the alpha cube.

int	AlphaSamples () const
	Returns the number of samples in the alpha cube.

int	BetaLines () const
	Returns the number of lines in the beta cube.

int	BetaSamples () const
	Returns the number of samples in the beta cube.

double	AlphaLine (double betaLine)
	Returns an alpha line given a beta line.

double	AlphaSample (double betaSample)
	Returns an alpha sample given a beta sample.

double	BetaLine (double alphaLine)
	Returns a beta line given an alpha line.

double	BetaSample (double alphaSample)
	Returns a beta sample given an alpha sample.

void	UpdateGroup (Cube &cube)
	Writes or update the Alpha keywords (AlphaLines, AlphaSamples, AlphaStartingSamples, etc) in the proper group in a PVL object.

void	Rehash (AlphaCube &alphaCube)
	Merges two AlphaCube objects.

Private Member Functions
void	ComputeSlope ()
	Computes the line and sample slopes.

Private Attributes
int	p_alphaLines
	The number of alpha lines in the cube.

int	p_alphaSamples
	The number of alpha samples in the cube.

int	p_betaLines
	The number of beta lines in the cube.

int	p_betaSamples
	The number of beta samples in the cube.

double	p_alphaStartingLine
	The starting alpha line.

double	p_alphaStartingSample
	The starting alpha sample.

double	p_alphaEndingLine
	The ending alpha line.

double	p_alphaEndingSample
	The ending alpha sample.

double	p_lineSlope
	The slope of the line.

double	p_sampSlope
	The slope of the sample set.

Detailed Description

This class is used to rewrite the "alpha" keywords out of the AlphaCube group or Instrument group.

This class allows programmers to map cube pixel positions back to the first cube they came from.This is critical for camera models or radiometric models in order to map input cube pixels to camera detector position. The alpha keywords are automatically generated in programs like crop, pad, reduce, and enlarge.

Author: 2004-02-13 Jeff Anderson

History:

2004-02-13 Jeff Anderson - Added another constructor and refactored UpdateGroup method.

2004-06-03 Jeff Anderson - Fixed bug in UpdateGroup which occured when a cube label did not already have a AlphaCube group.

2005-02-14 Leah Dahmer - Modified file to support Doxygen documentation.

2012-09-06 Steven Lambright - Changed the Pvl constructor to take a Cube instead. This was to prevent duplicating complicated label parsing code. This should eventually be refactored into a CubeLabel or similar object so that an actual cube isn't required in the future, but for now this enables the control net GUI to create a camera from a cube with no dimensions in the label.

Todo:: 2005-04-06 Add coded example.

Definition at line 61 of file AlphaCube.h.

Constructor & Destructor Documentation

Isis::AlphaCube::AlphaCube ( Cube & cube )

Constructs an AlphaCube object using a PVL object.

Definition at line 31 of file AlphaCube.cpp.

References Isis::PvlObject::findGroup(), Isis::PvlObject::findObject(), Isis::PvlObject::hasGroup(), Isis::Cube::label(), Isis::Cube::lineCount(), and Isis::Cube::sampleCount().

Isis::AlphaCube::AlphaCube	(	int	alphaSamples,
		int	alphaLines,
		int	betaSamples,
		int	betaLines
	)

Constructs an AlphaCube object given alphaSamples, alphaLines, betaSamples and betaLines.

Definition at line 82 of file AlphaCube.cpp.

Isis::AlphaCube::AlphaCube	(	int	alphaSamples,
		int	alphaLines,
		int	betaSamples,
		int	betaLines,
		double	alphaSs,
		double	alphaSl,
		double	alphaEs,
		double	alphaEl
	)

Constructs an AlphaCube object with a basic mapping from corner-to-corner, beta 0.5,0.5 maps to alpha 0.5,0.5 and beta ns+0.5,nl+0.5 maps to alpha ns+0.5, nl+0.5.

Definition at line 62 of file AlphaCube.cpp.

Isis::AlphaCube::~AlphaCube ( )

inline

Destroys the AlphaCube object.

Definition at line 71 of file AlphaCube.h.

Member Function Documentation

double Isis::AlphaCube::AlphaLine ( double betaLine )

inline

Returns an alpha line given a beta line.

Definition at line 90 of file AlphaCube.h.

References p_alphaStartingLine, and p_lineSlope.

Referenced by Rehash(), and Isis::Camera::SetImage().

int Isis::AlphaCube::AlphaLines ( ) const

inline

Returns the number of lines in the alpha cube.

Definition at line 74 of file AlphaCube.h.

References p_alphaLines.

Referenced by Isis::Camera::ParentLines(), and Isis::MocLabels::ReadLabels().

double Isis::AlphaCube::AlphaSample ( double betaSample )

inline

Returns an alpha sample given a beta sample.

Definition at line 94 of file AlphaCube.h.

References p_alphaStartingSample, and p_sampSlope.

Referenced by Rehash(), and Isis::Camera::SetImage().

int Isis::AlphaCube::AlphaSamples ( ) const

inline

Returns the number of samples in the alpha cube.

Definition at line 78 of file AlphaCube.h.

References p_alphaSamples.

Referenced by Isis::Camera::ParentSamples(), and Isis::MocLabels::ReadLabels().

double Isis::AlphaCube::BetaLine ( double alphaLine )

inline

Returns a beta line given an alpha line.

Definition at line 98 of file AlphaCube.h.

References p_alphaStartingLine, and p_lineSlope.

Referenced by Isis::Camera::RawFocalPlanetoImage(), and Isis::Camera::SetRightAscensionDeclination().

int Isis::AlphaCube::BetaLines ( ) const

inline

Returns the number of lines in the beta cube.

Definition at line 82 of file AlphaCube.h.

References p_betaLines.

Referenced by Isis::Camera::CacheSize(), Isis::Camera::LoadCache(), Rehash(), and Isis::Camera::StartEndEphemerisTimes().

double Isis::AlphaCube::BetaSample ( double alphaSample )

inline

Returns a beta sample given an alpha sample.

Definition at line 102 of file AlphaCube.h.

References p_alphaStartingSample, and p_sampSlope.

Referenced by Isis::Camera::RawFocalPlanetoImage(), and Isis::Camera::SetRightAscensionDeclination().

int Isis::AlphaCube::BetaSamples ( ) const

inline

Returns the number of samples in the beta cube.

Definition at line 86 of file AlphaCube.h.

References p_betaSamples.

Referenced by Isis::Camera::LoadCache(), Rehash(), and Isis::Camera::StartEndEphemerisTimes().

void Isis::AlphaCube::ComputeSlope ( )

private

Computes the line and sample slopes.

(Starting and ending alpha lines/samples divided by the number of beta lines/samples).

Todo:: Why the +0.5 and -0.5?

Definition at line 173 of file AlphaCube.cpp.

void Isis::AlphaCube::Rehash ( AlphaCube & add )

Merges two AlphaCube objects.

This facilities combinations of programs crop-enlarge, crop-crop, reduce-pad, etc.

Parameters

add	The AlphaCube object to be merged.

Definition at line 103 of file AlphaCube.cpp.

References AlphaLine(), AlphaSample(), BetaLines(), and BetaSamples().

Referenced by UpdateGroup().

void Isis::AlphaCube::UpdateGroup ( Isis::Cube & cube )

Writes or update the Alpha keywords (AlphaLines, AlphaSamples, AlphaStartingSamples, etc) in the proper group in a PVL object.

It chooses first to write and AlphaGroup if the Mapping group exists. If not then is will write the keywords in the Instrument group if it exists. Otherwise it will write to the AlphaCube group.

Parameters

&pvl	The PVL object to write to.

Definition at line 129 of file AlphaCube.cpp.

References Isis::PvlObject::addGroup(), Isis::PvlObject::findGroup(), Isis::PvlObject::findObject(), Isis::PvlObject::hasGroup(), Isis::Cube::label(), Rehash(), and Isis::toString().

Referenced by Isis::SubArea::UpdateLabel().

Member Data Documentation

double Isis::AlphaCube::p_alphaEndingLine

private

The ending alpha line.

Definition at line 118 of file AlphaCube.h.

double Isis::AlphaCube::p_alphaEndingSample

private

The ending alpha sample.

Definition at line 119 of file AlphaCube.h.

int Isis::AlphaCube::p_alphaLines

private

The number of alpha lines in the cube.

Definition at line 112 of file AlphaCube.h.

Referenced by AlphaLines().

int Isis::AlphaCube::p_alphaSamples

private

The number of alpha samples in the cube.

Definition at line 113 of file AlphaCube.h.

Referenced by AlphaSamples().

double Isis::AlphaCube::p_alphaStartingLine

private

The starting alpha line.

Definition at line 116 of file AlphaCube.h.

Referenced by AlphaLine(), and BetaLine().

double Isis::AlphaCube::p_alphaStartingSample

private

The starting alpha sample.

Definition at line 117 of file AlphaCube.h.

Referenced by AlphaSample(), and BetaSample().

int Isis::AlphaCube::p_betaLines

private

The number of beta lines in the cube.

Definition at line 114 of file AlphaCube.h.

Referenced by BetaLines().

int Isis::AlphaCube::p_betaSamples

private

The number of beta samples in the cube.

Definition at line 115 of file AlphaCube.h.

Referenced by BetaSamples().

double Isis::AlphaCube::p_lineSlope

private

The slope of the line.

Definition at line 120 of file AlphaCube.h.

Referenced by AlphaLine(), and BetaLine().

double Isis::AlphaCube::p_sampSlope

private

The slope of the sample set.

Definition at line 121 of file AlphaCube.h.

Referenced by AlphaSample(), and BetaSample().

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

src/base/objs/AlphaCube/AlphaCube.h
src/base/objs/AlphaCube/AlphaCube.cpp

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation