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. More...

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

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. More...

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

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. More...

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

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

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

Private Attributes
double	p_normPharef

double	p_normIncref

double	p_normEmaref

double	p_normAlbedo

double	p_normAout

double	p_normBout

double	p_normRhobar

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 90 of file TopoAtm.h.

Member Function Documentation

◆ AlgorithmName()

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

inlineinherited

Return normalization algorithm name.

Definition at line 59 of file NormModel.h.

◆ CalcNrmAlbedo() [1/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 58 of file NormModel.cpp.

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

◆ CalcNrmAlbedo() [2/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 83 of file NormModel.cpp.

◆ 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 219 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 202 of file TopoAtm.cpp.

References _FILEINFO_, and Isis::IException::User.

◆ 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 184 of file TopoAtm.cpp.

References _FILEINFO_, and Isis::IException::User.

◆ 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 166 of file TopoAtm.cpp.

References _FILEINFO_, and Isis::IException::User.

◆ 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 45 of file NormModel.cpp.

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

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

Member Function Documentation

◆ AlgorithmName()

◆ CalcNrmAlbedo() [1/2]

◆ CalcNrmAlbedo() [2/2]

◆ SetNormAlbedo()

◆ SetNormEmaref()

◆ SetNormIncref()

◆ SetNormPharef()

◆ SetNormWavelength()