Hapke-Henyey-Greenstein photometric model. More...

#include <Hapke.h>

Inheritance diagram for Isis::Hapke:

Collaboration diagram for Isis::Hapke:

Public Member Functions
	Hapke (Pvl &pvl)

void	SetPhotoHg1 (const double hg1)
	Set the Hapke Henyey Greenstein coefficient for the single particle phase function.

void	SetPhotoHg2 (const double hg2)
	Return photometric Hg1 value.

void	SetPhotoBh (const double bh)
	Return photometric Hg2 value.

void	SetPhotoCh (const double ch)
	Return photometric Bh value.

void	SetPhotoWh (const double wh)
	Return photometric Ch value.

void	SetPhotoHh (const double hh)
	Return photometric Wh value.

void	SetPhotoB0 (const double b0)
	Return photometric Hh value.

void	SetPhotoTheta (const double theta)
	Return photometric B0 value.

void	SetOldTheta (double theta)
	Return photometric Theta value.

void	SetPhoto0B0Standard (const QString &b0standard)
	Determine if the Hapke opposition surge component is initialized to zero during the SetStandardConditions phase.

void	SetStandardConditions (bool standard)
	Sets whether standard conditions will be used.

virtual double	PhotoModelAlgorithm (double phase, double incidence, double emission)

QString	AlgorithmName () const
	Return algorithm name found in Pvl file from constructor.

bool	StandardConditions () const
	Returns true if standard conditions are used, i.e., if SetStandardConditions(true) has been called. This is initialized to false in the constructor.

double	PhtTopder (double phase, double incidence, double emission)
	Obtain topographic derivative of an arbitrary photometric function.

double	CalcSurfAlbedo (double pha, double inc, double ema)
	Calculate the surface brightness using photometric angle information.

virtual void	SetPhotoL (const double l)

double	PhotoL () const
	Return photometric L value.

virtual void	SetPhotoK (const double k)

double	PhotoK () const
	Return photometric K value.

double	PhotoHg1 () const
	Return photometric Hg1 value.

double	PhotoHg2 () const
	Return photometric Hg2 value.

double	PhotoBh () const
	Return photometric Bh value.

double	PhotoCh () const
	Return photometric Ch value.

double	PhotoWh () const
	Return photometric Wh value.

double	PhotoHh () const
	Return photometric Hh value.

double	PhotoB0 () const
	Return photometric B0 value.

double	PhotoTheta () const
	Return photometric Theta value.

QString	Photo0B0Standard () const
	Return photometric B0 standardization value.

double	Hfunc (double u, double gamma)
	Hapke's approximation to Chandra's H function.

virtual void	SetPhotoPhaseList (const QString)

virtual void	SetPhotoKList (const QString)

virtual void	SetPhotoLList (const QString)

virtual void	SetPhotoPhaseCurveList (const QString)

std::vector< double >	PhotoPhaseList () const
	Return photometric phase angle list.

std::vector< double >	PhotoKList () const
	Return photometric k value list.

std::vector< double >	PhotoLList () const
	Return photometric l value list.

std::vector< double >	PhotoPhaseCurveList () const
	Return photometric phase curve value list.

Static Public Member Functions
static double	PhtAcos (double cosang)
	Obtain arccosine of input value.

Protected Attributes
double	p_photoL

double	p_photoK

double	p_photoHg1

double	p_photoHg2

double	p_photoBh

double	p_photoCh

double	p_photoCott

double	p_photoCot2t

double	p_photoTant

double	p_photoSr

double	p_photoOsr

QString	p_algName

QString	p_photo0B0Standard

double	p_photoWh

double	p_photoHh

double	p_photoB0

double	p_photoB0save

double	p_photoTheta

double	p_photoThetaold

std::vector< double >	p_photoPhaseList

std::vector< double >	p_photoKList

std::vector< double >	p_photoLList

std::vector< double >	p_photoPhaseCurveList

int	p_photoPhaseAngleCount

NumericalApproximation	p_photoKSpline

NumericalApproximation	p_photoLSpline

NumericalApproximation	p_photoBSpline

Private Attributes
QString	p_photoAlgorithmName
	Unique name of the photometric model.

bool	p_standardConditions
	Indicates whether standard conditions are used.

Detailed Description

Hapke-Henyey-Greenstein photometric model.

Derive model albedo using complete Hapke model with Henyey-Greenstein single-particle phase function whose coefficients are hg1 and hg2, plus single scattering albedo wh, opposition surge parameters hh and b0, and macroscopic roughness theta.

Author: 1989-08-02 Unknown

History

2008-01-14 Janet Barret - Imported into ISIS from Isis2.

2008-03-07 Janet Barrett - Moved variables and related methods that pertain to Hapke specific parameters to the PhotoModel class.

2008-06-18 Stuart Sides - Fixed doc error

2008-10-17 Steven Lambright - Changed inheritance, moved HapkeHen specific methods into this class from the base class.

2008-11-05 Jeannie Walldren - Added documentation from Isis2 files

2012-10-15 Janet Barrett - Shortened the ZEROB0STANDARD parameter name to ZEROB0ST. This was done so that the GUI interface does not have to be resized every time it is opened. The shortened name helps to keep the parameters within the default GUI size when it is first opened. References #453. Fixes #1288.

2016-08-28 Kelvin Rodriguez - SetPhoto0B0Standard now uses QString. Part of porting to OS X 10.11

Definition at line 47 of file Hapke.h.

Constructor & Destructor Documentation

◆ Hapke()

Isis::Hapke::Hapke ( Pvl & pvl )

Definition at line 19 of file Hapke.cpp.

◆ ~Hapke()

virtual Isis::Hapke::~Hapke ( )

inlinevirtual

Definition at line 50 of file Hapke.h.

Member Function Documentation

◆ AlgorithmName()

QString Isis::PhotoModel::AlgorithmName ( ) const

inlineinherited

Return algorithm name found in Pvl file from constructor.

Definition at line 47 of file PhotoModel.h.

References Isis::PhotoModel::p_photoAlgorithmName.

Referenced by Isis::AtmosModel::GenerateAhTable().

◆ CalcSurfAlbedo()

double Isis::PhotoModel::CalcSurfAlbedo	(	double	pha,
		double	inc,
		double	ema )

inherited

Calculate the surface brightness using photometric angle information.

Parameters

pha	Phase angle
inc	Incidence angle
ema	Emission angle

Returns: double Surface brightness calculated by the photometric function

Definition at line 177 of file PhotoModel.cpp.

Referenced by Isis::Albedo::Albedo(), Isis::AlbedoAtm::AlbedoAtm(), Isis::Albedo::NormModelAlgorithm(), Isis::AlbedoAtm::NormModelAlgorithm(), and Isis::PhotoModel::PhtTopder().

◆ Hfunc()

double Isis::PhotoModel::Hfunc	(	double	u,
		double	gamma )

inlineinherited

Hapke's approximation to Chandra's H function.

Definition at line 168 of file PhotoModel.h.

◆ Photo0B0Standard()

QString Isis::PhotoModel::Photo0B0Standard ( ) const

inlineinherited

Return photometric B0 standardization value.

Definition at line 163 of file PhotoModel.h.

◆ PhotoB0()

double Isis::PhotoModel::PhotoB0 ( ) const

inlineinherited

Return photometric B0 value.

Definition at line 143 of file PhotoModel.h.

◆ PhotoBh()

double Isis::PhotoModel::PhotoBh ( ) const

inlineinherited

Return photometric Bh value.

Definition at line 107 of file PhotoModel.h.

◆ PhotoCh()

double Isis::PhotoModel::PhotoCh ( ) const

inlineinherited

Return photometric Ch value.

Definition at line 116 of file PhotoModel.h.

◆ PhotoHg1()

double Isis::PhotoModel::PhotoHg1 ( ) const

inlineinherited

Return photometric Hg1 value.

Definition at line 89 of file PhotoModel.h.

◆ PhotoHg2()

double Isis::PhotoModel::PhotoHg2 ( ) const

inlineinherited

Return photometric Hg2 value.

Definition at line 98 of file PhotoModel.h.

◆ PhotoHh()

double Isis::PhotoModel::PhotoHh ( ) const

inlineinherited

Return photometric Hh value.

Definition at line 134 of file PhotoModel.h.

◆ PhotoK()

double Isis::PhotoModel::PhotoK ( ) const

inlineinherited

Return photometric K value.

Definition at line 80 of file PhotoModel.h.

◆ PhotoKList()

std::vector< double > Isis::PhotoModel::PhotoKList ( ) const

inlineinherited

Return photometric k value list.

Definition at line 183 of file PhotoModel.h.

◆ PhotoL()

double Isis::PhotoModel::PhotoL ( ) const

inlineinherited

Return photometric L value.

Definition at line 71 of file PhotoModel.h.

◆ PhotoLList()

std::vector< double > Isis::PhotoModel::PhotoLList ( ) const

inlineinherited

Return photometric l value list.

Definition at line 188 of file PhotoModel.h.

◆ PhotoModelAlgorithm()

double Isis::Hapke::PhotoModelAlgorithm	(	double	phase,
		double	incidence,
		double	emission )

virtual

Implements Isis::PhotoModel.

Definition at line 109 of file Hapke.cpp.

◆ PhotoPhaseCurveList()

std::vector< double > Isis::PhotoModel::PhotoPhaseCurveList ( ) const

inlineinherited

Return photometric phase curve value list.

Definition at line 193 of file PhotoModel.h.

◆ PhotoPhaseList()

std::vector< double > Isis::PhotoModel::PhotoPhaseList ( ) const

inlineinherited

Return photometric phase angle list.

Definition at line 178 of file PhotoModel.h.

◆ PhotoTheta()

double Isis::PhotoModel::PhotoTheta ( ) const

inlineinherited

Return photometric Theta value.

Definition at line 152 of file PhotoModel.h.

◆ PhotoWh()

double Isis::PhotoModel::PhotoWh ( ) const

inlineinherited

Return photometric Wh value.

Definition at line 125 of file PhotoModel.h.

◆ PhtAcos()

double Isis::PhotoModel::PhtAcos ( double cosang )

staticinherited

Obtain arccosine of input value.

If the input value is outside of the valid range (-1 to 1), then obtain the arccosine of the closest valid value.

Parameters

cosang input value to obtain arccosine of (in radians)

Returns: double Arccosine of cosang, if valid.

History: 2008-11-05 Jeannie Walldren - This method was moved from NumericalMethods class.

Definition at line 150 of file PhotoModel.cpp.

Referenced by Isis::PhotoModel::PhtTopder().

◆ PhtTopder()

double Isis::PhotoModel::PhtTopder	(	double	phase,
		double	incidence,
		double	emission )

inherited

Obtain topographic derivative of an arbitrary photometric function.

Parameters

phase	Input phase angle
incidence	Input incidence angle
emission	Input emission angle

Returns: double Gradient

Definition at line 64 of file PhotoModel.cpp.

References Isis::PhotoModel::CalcSurfAlbedo(), Isis::PhotoModel::PhtAcos(), and Isis::PI.

◆ SetOldTheta()

void Isis::Hapke::SetOldTheta ( double theta )

inline

Return photometric Theta value.

Definition at line 100 of file Hapke.h.

◆ SetPhoto0B0Standard()

void Isis::Hapke::SetPhoto0B0Standard ( const QString & b0standard )

virtual

Determine if the Hapke opposition surge component is initialized to zero during the SetStandardConditions phase.

This parameter is limited to values that are true or false.

Parameters

b0standard Hapke opposition surge initialization, default is true

Reimplemented from Isis::PhotoModel.

Definition at line 423 of file Hapke.cpp.

◆ SetPhotoB0()

void Isis::Hapke::SetPhotoB0 ( const double b0 )

virtual

Return photometric Hh value.

Set the Hapke opposition surge component.

This is one of two opposition surge components needed for the Hapke model. This parameter is limited to values that are >=0.

Parameters

b0	Hapke opposition surge component, default is 0.0

Reimplemented from Isis::PhotoModel.

Definition at line 406 of file Hapke.cpp.

◆ SetPhotoBh()

void Isis::Hapke::SetPhotoBh ( const double bh )

virtual

Return photometric Hg2 value.

Set the Hapke Legendre coefficient for the single particle phase function.

This is one of two coefficients needed for the single particle phase function. This parameter is limited to values that are >=-1 and <=1.

Parameters

bh	Hapke Legendre coefficient, default is 0.0

Reimplemented from Isis::PhotoModel.

Definition at line 341 of file Hapke.cpp.

◆ SetPhotoCh()

void Isis::Hapke::SetPhotoCh ( const double ch )

virtual

Return photometric Bh value.

Set the Hapke Legendre coefficient for the single particle phase function.

This is one of two coefficients needed for the single particle phase function. This parameter is limited to values that are >=-1 and <=1.

Parameters

ch	Hapke Legendre coefficient, default is 0.0

Reimplemented from Isis::PhotoModel.

Definition at line 358 of file Hapke.cpp.

◆ SetPhotoHg1()

void Isis::Hapke::SetPhotoHg1 ( const double hg1 )

virtual

Set the Hapke Henyey Greenstein coefficient for the single particle phase function.

This is one of two coefficients needed for the single particle phase function. This parameter is limited to values that are >-1 and <1.

Parameters

hg1	Hapke Henyey Greenstein coefficient, default is 0.0

Reimplemented from Isis::PhotoModel.

Definition at line 307 of file Hapke.cpp.

◆ SetPhotoHg2()

void Isis::Hapke::SetPhotoHg2 ( const double hg2 )

virtual

Return photometric Hg1 value.

Set the Hapke Henyey Greenstein coefficient for the single particle phase function.

This is one of two coefficients needed for the single particle phase function. This parameter is limited to values that are >=0 and <=1.

Parameters

hg2	Hapke Henyey Greenstein coefficient, default is 0.0

Reimplemented from Isis::PhotoModel.

Definition at line 324 of file Hapke.cpp.

◆ SetPhotoHh()

void Isis::Hapke::SetPhotoHh ( const double hh )

virtual

Return photometric Wh value.

Set the Hapke opposition surge component.

This is one of two opposition surge components needed for the Hapke model. This parameter is limited to values that are >=0.

Parameters

hh	Hapke opposition surge component, default is 0.0

Reimplemented from Isis::PhotoModel.

Definition at line 390 of file Hapke.cpp.

◆ SetPhotoK()

virtual void Isis::PhotoModel::SetPhotoK ( const double k )

inlinevirtualinherited

Reimplemented in Isis::Minnaert.

Definition at line 75 of file PhotoModel.h.

◆ SetPhotoKList()

virtual void Isis::PhotoModel::SetPhotoKList ( const QString )

inlinevirtualinherited

Reimplemented in Isis::MinnaertEmpirical.

Definition at line 173 of file PhotoModel.h.

◆ SetPhotoL()

virtual void Isis::PhotoModel::SetPhotoL ( const double l )

inlinevirtualinherited

Reimplemented in Isis::LunarLambert.

Definition at line 66 of file PhotoModel.h.

◆ SetPhotoLList()

virtual void Isis::PhotoModel::SetPhotoLList ( const QString )

inlinevirtualinherited

Reimplemented in Isis::LunarLambertEmpirical.

Definition at line 174 of file PhotoModel.h.

◆ SetPhotoPhaseCurveList()

virtual void Isis::PhotoModel::SetPhotoPhaseCurveList ( const QString )

inlinevirtualinherited

Reimplemented in Isis::LunarLambertEmpirical, and Isis::MinnaertEmpirical.

Definition at line 175 of file PhotoModel.h.

◆ SetPhotoPhaseList()

virtual void Isis::PhotoModel::SetPhotoPhaseList ( const QString )

inlinevirtualinherited

Reimplemented in Isis::LunarLambertEmpirical, and Isis::MinnaertEmpirical.

Definition at line 172 of file PhotoModel.h.

◆ SetPhotoTheta()

void Isis::Hapke::SetPhotoTheta ( const double theta )

virtual

Return photometric B0 value.

Set the Hapke macroscopic roughness component.

This parameter is limited to values that are >=0 and <=90.

Parameters

theta Hapke macroscopic roughness component, default is 0.0

Reimplemented from Isis::PhotoModel.

Definition at line 444 of file Hapke.cpp.

◆ SetPhotoWh()

void Isis::Hapke::SetPhotoWh ( const double wh )

virtual

Return photometric Ch value.

Set the Hapke single scattering albedo component.

This parameter is limited to values that are >0 and <=1.

Parameters

wh	Hapke single scattering albedo component, default is 0.5

Reimplemented from Isis::PhotoModel.

Definition at line 374 of file Hapke.cpp.

◆ SetStandardConditions()

void Isis::Hapke::SetStandardConditions ( bool standard )

virtual

Sets whether standard conditions will be used.

Parameters

standard True if standard conditions are used.

Reimplemented from Isis::PhotoModel.

Definition at line 454 of file Hapke.cpp.

◆ StandardConditions()

bool Isis::PhotoModel::StandardConditions ( ) const

inlineinherited

Returns true if standard conditions are used, i.e., if SetStandardConditions(true) has been called. This is initialized to false in the constructor.

Definition at line 53 of file PhotoModel.h.

References Isis::PhotoModel::p_standardConditions.

Member Data Documentation

◆ p_algName

QString Isis::PhotoModel::p_algName

protectedinherited

Definition at line 212 of file PhotoModel.h.

◆ p_photo0B0Standard

QString Isis::PhotoModel::p_photo0B0Standard

protectedinherited

Definition at line 213 of file PhotoModel.h.

◆ p_photoAlgorithmName

QString Isis::PhotoModel::p_photoAlgorithmName

privateinherited

Unique name of the photometric model.

Definition at line 232 of file PhotoModel.h.

Referenced by Isis::PhotoModel::AlgorithmName(), and Isis::PhotoModel::PhotoModel().

◆ p_photoB0

double Isis::PhotoModel::p_photoB0

protectedinherited

Definition at line 216 of file PhotoModel.h.

◆ p_photoB0save

double Isis::PhotoModel::p_photoB0save

protectedinherited

Definition at line 217 of file PhotoModel.h.

◆ p_photoBh

double Isis::PhotoModel::p_photoBh

protectedinherited

Definition at line 205 of file PhotoModel.h.

◆ p_photoBSpline

NumericalApproximation Isis::PhotoModel::p_photoBSpline

protectedinherited

Definition at line 228 of file PhotoModel.h.

◆ p_photoCh

double Isis::PhotoModel::p_photoCh

protectedinherited

Definition at line 206 of file PhotoModel.h.

◆ p_photoCot2t

double Isis::PhotoModel::p_photoCot2t

protectedinherited

Definition at line 208 of file PhotoModel.h.

◆ p_photoCott

double Isis::PhotoModel::p_photoCott

protectedinherited

Definition at line 207 of file PhotoModel.h.

◆ p_photoHg1

double Isis::PhotoModel::p_photoHg1

protectedinherited

Definition at line 203 of file PhotoModel.h.

◆ p_photoHg2

double Isis::PhotoModel::p_photoHg2

protectedinherited

Definition at line 204 of file PhotoModel.h.

◆ p_photoHh

double Isis::PhotoModel::p_photoHh

protectedinherited

Definition at line 215 of file PhotoModel.h.

◆ p_photoK

double Isis::PhotoModel::p_photoK

protectedinherited

Definition at line 202 of file PhotoModel.h.

◆ p_photoKList

std::vector<double> Isis::PhotoModel::p_photoKList

protectedinherited

Definition at line 222 of file PhotoModel.h.

◆ p_photoKSpline

NumericalApproximation Isis::PhotoModel::p_photoKSpline

protectedinherited

Definition at line 226 of file PhotoModel.h.

◆ p_photoL

double Isis::PhotoModel::p_photoL

protectedinherited

Definition at line 201 of file PhotoModel.h.

◆ p_photoLList

std::vector<double> Isis::PhotoModel::p_photoLList

protectedinherited

Definition at line 223 of file PhotoModel.h.

◆ p_photoLSpline

NumericalApproximation Isis::PhotoModel::p_photoLSpline

protectedinherited

Definition at line 227 of file PhotoModel.h.

◆ p_photoOsr

double Isis::PhotoModel::p_photoOsr

protectedinherited

Definition at line 211 of file PhotoModel.h.

◆ p_photoPhaseAngleCount

int Isis::PhotoModel::p_photoPhaseAngleCount

protectedinherited

Definition at line 225 of file PhotoModel.h.

◆ p_photoPhaseCurveList

std::vector<double> Isis::PhotoModel::p_photoPhaseCurveList

protectedinherited

Definition at line 224 of file PhotoModel.h.

◆ p_photoPhaseList

std::vector<double> Isis::PhotoModel::p_photoPhaseList

protectedinherited

Definition at line 221 of file PhotoModel.h.

◆ p_photoSr

double Isis::PhotoModel::p_photoSr

protectedinherited

Definition at line 210 of file PhotoModel.h.

◆ p_photoTant

double Isis::PhotoModel::p_photoTant

protectedinherited

Definition at line 209 of file PhotoModel.h.

◆ p_photoTheta

double Isis::PhotoModel::p_photoTheta

protectedinherited

Definition at line 218 of file PhotoModel.h.

◆ p_photoThetaold

double Isis::PhotoModel::p_photoThetaold

protectedinherited

Definition at line 219 of file PhotoModel.h.

◆ p_photoWh

double Isis::PhotoModel::p_photoWh

protectedinherited

Definition at line 214 of file PhotoModel.h.

◆ p_standardConditions

bool Isis::PhotoModel::p_standardConditions

privateinherited

Indicates whether standard conditions are used.

Definition at line 234 of file PhotoModel.h.

Referenced by Isis::PhotoModel::PhotoModel(), Isis::PhotoModel::SetStandardConditions(), and Isis::PhotoModel::StandardConditions().

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

src/base/objs/Hapke/Hapke.h
src/base/objs/Hapke/Hapke.cpp

Public Member Functions

Static Public Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Hapke()

◆ ~Hapke()

Member Function Documentation

◆ AlgorithmName()

◆ CalcSurfAlbedo()

◆ Hfunc()

◆ Photo0B0Standard()

◆ PhotoB0()

◆ PhotoBh()

◆ PhotoCh()

◆ PhotoHg1()

◆ PhotoHg2()

◆ PhotoHh()

◆ PhotoK()

◆ PhotoKList()

◆ PhotoL()

◆ PhotoLList()

◆ PhotoModelAlgorithm()

◆ PhotoPhaseCurveList()

◆ PhotoPhaseList()

◆ PhotoTheta()

◆ PhotoWh()

◆ PhtAcos()

◆ PhtTopder()

◆ SetOldTheta()

◆ SetPhoto0B0Standard()

◆ SetPhotoB0()

◆ SetPhotoBh()

◆ SetPhotoCh()

◆ SetPhotoHg1()

◆ SetPhotoHg2()

◆ SetPhotoHh()

◆ SetPhotoK()

◆ SetPhotoKList()

◆ SetPhotoL()

◆ SetPhotoLList()

◆ SetPhotoPhaseCurveList()

◆ SetPhotoPhaseList()

◆ SetPhotoTheta()

◆ SetPhotoWh()

◆ SetStandardConditions()

◆ StandardConditions()

Member Data Documentation

◆ p_algName

◆ p_photo0B0Standard

◆ p_photoAlgorithmName

◆ p_photoB0

◆ p_photoB0save

◆ p_photoBh

◆ p_photoBSpline

◆ p_photoCh

◆ p_photoCot2t

◆ p_photoCott

◆ p_photoHg1

◆ p_photoHg2

◆ p_photoHh

◆ p_photoK

◆ p_photoKList

◆ p_photoKSpline

◆ p_photoL

◆ p_photoLList

◆ p_photoLSpline

◆ p_photoOsr

◆ p_photoPhaseAngleCount

◆ p_photoPhaseCurveList

◆ p_photoPhaseList

◆ p_photoSr

◆ p_photoTant

◆ p_photoTheta

◆ p_photoThetaold

◆ p_photoWh

◆ p_standardConditions