As in the case without an atmosphere, processing proceeds in three steps, a pass 1 PHOTOM followed by a divide filter to is- olate topography from albedo variations followed by a pass 2 PHOTOM. More...

#include <TopoAtm.h>

Inheritance diagram for Isis::TopoAtm:

Collaboration diagram for Isis::TopoAtm:

Public Member Functions
	TopoAtm (Pvl &pvl, PhotoModel &pmodel, AtmosModel &amodel)

std::string	AlgorithmName () const
	Return normalization algorithm name.

void	CalcNrmAlbedo (double pha, double inc, double ema, double dn, double &albedo, double &mult, double &base)
	Calculate the albedo normalization.

void	CalcNrmAlbedo (double pha, double inc, double ema, double deminc, double demema, double dn, double &albedo, double &mult, double &base)
	Calculate the normalization albedo using photometric angle information.

virtual void	SetNormWavelength (double wavelength)
	Set the wavelength parameter.

Protected Member Functions
virtual void	NormModelAlgorithm (double pha, double inc, double ema, double dn, double &albedo, double &mult, double &base)

virtual void	NormModelAlgorithm (double pha, double inc, double ema, double deminc, double demema, double dn, double &albedo, double &mult, double &base)

void	SetAlgorithmName (std::string name)

PhotoModel *	GetPhotoModel ()

AtmosModel *	GetAtmosModel ()

Protected Attributes
double	p_normWavelength

Private Member Functions
void	SetNormPharef (const double pharef)
	Set the normalization function parameter.

void	SetNormIncref (const double incref)
	Set the normalization function parameter.

void	SetNormEmaref (const double emaref)
	Set the normalization function parameter.

void	SetNormAlbedo (const double albedo)
	Set the normalization function parameter.

Private Attributes
double	p_normPharef

double	p_normIncref

double	p_normEmaref

double	p_normAlbedo

double	p_normAout

double	p_normBout

double	p_normRhobar

std::string	p_normAlgorithmName

PhotoModel *	p_normPM

AtmosModel *	p_normAM

Detailed Description

As in the case without an atmosphere, processing proceeds in three steps, a pass 1 PHOTOM followed by a divide filter to is- olate topography from albedo variations followed by a pass 2 PHOTOM.

The first pass is intended to isolate relative albedo from overall photometric shading so that the filter will work as well as possible. The second pass cleans up whatever funny scaling the first pass did and scales the topographic modulation to desired standard conditions; as before these had best not be normal incidence, or the topography will vanish!

Also as in the no-atmosphere case, the albedo mode (with atmosphere this time) is used for the first pass. The reference geometry for this pass is normal incidence with no atmosphere, i.e., INC=EMA=PHASE=TAU=0 The second pass is going to assume implicitly that these reference values were used the first time, freeing the TAE reference parameters to define the conditions of finite incidence and maybe finite optical depth to which the output will be normalized.

Figuring out the scaling that got applied to the topographic modu- lation in pass 1 turns out to be tricky because of the nonlinearity of the equations and the fact that the original DN (which would be recoverable from the atmosphere model immediately after pass 1) is lost after the divide filter. As an approximation, I will require the user to input ALBEDO, which is the average DN in the image after pass 1, a measure of the average value of RHO and, given the norm- alization, the average of the normal albedo in the area.

Rather than do the calculation analytically as I did in my hand- written notes, I evaluate the contrast of unit slope numerically at given albedo or RHO; the first-order dependence on RHO has been divided out so this is inaccurate to second order same as the other derivation but it is a whole lot easier to follow). If it turns out to be desirable, we can define two values of ALBEDO for this program, one describing the input (i.e., giving the albedo for this one image, at which slope normalization is calculated) and the other describing the output (the albedo to be used in simulating the out- put image).

Author: 1998-12-21 Randy Kirk

History

2007-08-15 Steven Lambright Refactored code

2008-06-18 Steven Lambright Fixed ifndef command

2008-11-05 Jeannie Walldren - Modified references to NumericalMethods class.

2009-05-11 Janet Barrett - Fixed so that the NormModelAlgorithm supporting DEM input is the empty function. DEM input is not yet supported.

2010-11-10 Janet Barrett - Added reference parameters for phase and emission so user can specify normalization conditions in initialization

2010-11-30 Janet Barrett - Added the ability to use the photometric angles from the ellipsoid and the DEM

Definition at line 74 of file TopoAtm.h.

Constructor & Destructor Documentation

◆ TopoAtm()

Isis::TopoAtm::TopoAtm	(	Pvl &	pvl,
		PhotoModel &	pmodel,
		AtmosModel &	amodel )

Definition at line 18 of file TopoAtm.cpp.

◆ ~TopoAtm()

virtual Isis::TopoAtm::~TopoAtm ( )

inlinevirtual

Definition at line 77 of file TopoAtm.h.

Member Function Documentation

◆ AlgorithmName()

std::string Isis::NormModel::AlgorithmName ( ) const

inlineinherited

Return normalization algorithm name.

Definition at line 43 of file NormModel.h.

◆ CalcNrmAlbedo() [1/2]

void Isis::NormModel::CalcNrmAlbedo	(	double	pha,
		double	inc,
		double	ema,
		double	deminc,
		double	demema,
		double	dn,
		double &	albedo,
		double &	mult,
		double &	base )

inherited

Calculate the normalization albedo using photometric angle information.

Parameters

pha	input phase angle
inc	input incidence angle for ellipsoid
ema	input emission angle for ellipsoid
deminc	input incidence angle for dem
demema	input emission angle for dem
dn	input albedo value

Definition at line 89 of file NormModel.cpp.

◆ CalcNrmAlbedo() [2/2]

void Isis::NormModel::CalcNrmAlbedo	(	double	pha,
		double	inc,
		double	ema,
		double	dn,
		double &	albedo,
		double &	mult,
		double &	base )

inherited

Calculate the albedo normalization.

Calculate the normalization albedo using photometric angle information.

Parameters

pha	input phase angle
inc	input incidence angle
ema	input emission angle
dn	input albedo value

Definition at line 64 of file NormModel.cpp.

Referenced by Isis::Photometry::Compute(), and Isis::Photometry::Compute().

◆ GetAtmosModel()

AtmosModel * Isis::NormModel::GetAtmosModel ( )

inlineprotectedinherited

Definition at line 69 of file NormModel.h.

◆ GetPhotoModel()

PhotoModel * Isis::NormModel::GetPhotoModel ( )

inlineprotectedinherited

Definition at line 66 of file NormModel.h.

◆ NormModelAlgorithm() [1/2]

void Isis::TopoAtm::NormModelAlgorithm	(	double	pha,
		double	inc,
		double	ema,
		double	deminc,
		double	demema,
		double	dn,
		double &	albedo,
		double &	mult,
		double &	base )

protectedvirtual

Implements Isis::NormModel.

Definition at line 100 of file TopoAtm.cpp.

◆ NormModelAlgorithm() [2/2]

virtual void Isis::TopoAtm::NormModelAlgorithm	(	double	pha,
		double	inc,
		double	ema,
		double	dn,
		double &	albedo,
		double &	mult,
		double &	base )

inlineprotectedvirtual

Implements Isis::NormModel.

Definition at line 80 of file TopoAtm.h.

◆ SetAlgorithmName()

void Isis::NormModel::SetAlgorithmName ( std::string name )

inlineprotectedinherited

Definition at line 63 of file NormModel.h.

◆ SetNormAlbedo()

void Isis::TopoAtm::SetNormAlbedo ( const double albedo )

private

Set the normalization function parameter.

To construct mosaics, the same value of albedo should be used for all images to achieve a uniform result.

Parameters

albedo Normalization function parameter, default is 0.0690507

Definition at line 225 of file TopoAtm.cpp.

◆ SetNormEmaref()

void Isis::TopoAtm::SetNormEmaref ( const double emaref )

private

Set the normalization function parameter.

This is the reference emission angle to which the image photometry will be normalized. This parameter is limited to values that are >=0 and <90.

Parameters

emaref Normalization function parameter, default is 0.0

Definition at line 208 of file TopoAtm.cpp.

◆ SetNormIncref()

void Isis::TopoAtm::SetNormIncref ( const double incref )

private

Set the normalization function parameter.

This is the reference incidence angle to which the image photometry will be normalized. This parameter is limited to values that are >=0 and <90.

Parameters

incref Normalization function parameter, default is 0.0

Definition at line 190 of file TopoAtm.cpp.

◆ SetNormPharef()

void Isis::TopoAtm::SetNormPharef ( const double pharef )

private

Set the normalization function parameter.

This is the reference phase angle to which the image photometry will be normalized. This parameter is limited to values that are >=0 and <180.

Parameters

pharef Normalization function parameter, default is 0.0

Definition at line 172 of file TopoAtm.cpp.

◆ SetNormWavelength()

void Isis::NormModel::SetNormWavelength ( double wavelength )

virtualinherited

Set the wavelength parameter.

This value is obtained from the BandBin Center keyword of the image. This must be set by the application.

Definition at line 51 of file NormModel.cpp.

Referenced by Isis::Photometry::SetPhotomWl().

Member Data Documentation

◆ p_normAlbedo

double Isis::TopoAtm::p_normAlbedo

private

Definition at line 95 of file TopoAtm.h.

◆ p_normAlgorithmName

std::string Isis::NormModel::p_normAlgorithmName

privateinherited

Definition at line 76 of file NormModel.h.

◆ p_normAM

AtmosModel* Isis::NormModel::p_normAM

privateinherited

Definition at line 78 of file NormModel.h.

◆ p_normAout

double Isis::TopoAtm::p_normAout

private

Definition at line 96 of file TopoAtm.h.

◆ p_normBout

double Isis::TopoAtm::p_normBout

private

Definition at line 97 of file TopoAtm.h.

◆ p_normEmaref

double Isis::TopoAtm::p_normEmaref

private

Definition at line 94 of file TopoAtm.h.

◆ p_normIncref

double Isis::TopoAtm::p_normIncref

private

Definition at line 93 of file TopoAtm.h.

◆ p_normPharef

double Isis::TopoAtm::p_normPharef

private

Definition at line 92 of file TopoAtm.h.

◆ p_normPM

PhotoModel* Isis::NormModel::p_normPM

privateinherited

Definition at line 77 of file NormModel.h.

◆ p_normRhobar

double Isis::TopoAtm::p_normRhobar

private

Definition at line 98 of file TopoAtm.h.

◆ p_normWavelength

double Isis::NormModel::p_normWavelength

protectedinherited

Definition at line 73 of file NormModel.h.

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

src/base/objs/TopoAtm/TopoAtm.h
src/base/objs/TopoAtm/TopoAtm.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ TopoAtm()

◆ ~TopoAtm()

Member Function Documentation

◆ AlgorithmName()

◆ CalcNrmAlbedo() [1/2]

◆ CalcNrmAlbedo() [2/2]

◆ GetAtmosModel()

◆ GetPhotoModel()

◆ NormModelAlgorithm() [1/2]

◆ NormModelAlgorithm() [2/2]

◆ SetAlgorithmName()

◆ SetNormAlbedo()

◆ SetNormEmaref()

◆ SetNormIncref()

◆ SetNormPharef()

◆ SetNormWavelength()

Member Data Documentation

◆ p_normAlbedo

◆ p_normAlgorithmName

◆ p_normAM

◆ p_normAout

◆ p_normBout

◆ p_normEmaref

◆ p_normIncref

◆ p_normPharef

◆ p_normPM

◆ p_normRhobar

◆ p_normWavelength