Isis Developer Reference
Isis::TopoAtm Class Reference

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:
Inheritance graph
Collaboration diagram for Isis::TopoAtm:
Collaboration graph

Public Member Functions

 TopoAtm (Pvl &pvl, PhotoModel &pmodel, AtmosModel &amodel)
 
virtual ~TopoAtm ()
 
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)
 
PhotoModelGetPhotoModel ()
 
AtmosModelGetAtmosModel ()
 

Protected Attributes

double p_normWavelength
 

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

Constructor & Destructor Documentation

◆ TopoAtm()

◆ ~TopoAtm()

virtual Isis::TopoAtm::~TopoAtm ( )
inlinevirtual

Member Function Documentation

◆ AlgorithmName()

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

Return normalization algorithm name.

◆ 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
phainput phase angle
incinput incidence angle for ellipsoid
emainput emission angle for ellipsoid
demincinput incidence angle for dem
dememainput emission angle for dem
dninput albedo value

References Isis::NormModel::NormModelAlgorithm().

◆ 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
phainput phase angle
incinput incidence angle
emainput emission angle
dninput albedo value

References Isis::NormModel::NormModelAlgorithm().

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

◆ GetAtmosModel()

◆ GetPhotoModel()

◆ 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

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

◆ SetAlgorithmName()

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

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

References Isis::NormModel::p_normWavelength.

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

Member Data Documentation

◆ p_normWavelength

double Isis::NormModel::p_normWavelength
protectedinherited

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