Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search

USGS

Isis 3 Application Documentation


phoempglobal

Printer Friendly View | TOC | Home

Fit empirical photometric functions to Hapke

Overview Parameters

Description

    This program finds lunar-Lambert or Minnaert photometric functions to 
    approximate a more realistic but more complex Hapke (1981; 1984; 1986) 
    model.  At each of a range of phase angles, the simpler model is fit to 
    the Hapke model by adjusting its one parameter and its overall brightness 
    so that the sum-squared-residual between the two is minimized. Both the 
    parameter (which, for both types of simple model, mainly controls limb 
    darkening) and the brightness (normalized as an empirical phase curve) 
    are reported in a table against phase angle. 

    In this program, the fit is over a portion of the visible hemisphere of
    an idealized spherical and uniform planet, and a table of results vs phase 
    angle is output.  This type of fit is useful for building an empirical
    photometric function to be used in program photomet for normalizing
    images for mosaicking.  The companion program phoemplocal can be used
    to perform a single fit at fixed incidence/emission/phase geometry
    to determine the photometric parameter for photoclinometry with a 
    particular image. This program, phoempglobal, can also be used to
    support photoclinometry, by producing a table of fits at multiple phase
    angles that can be interpolated to give the parameters for use with
    any given image. In this application, the parameter EMAMAX should be
    set to a relatively small value that represents the typical range of
    surface slopes, and the fit will apply to images with vertical viewing.

    Because the program photomet (used to make photometric corrections to
    images) incorporates all the same atmospheric scattering models as
    phoempglobal, one would normally set ATMNAME=NONE and ADDOFFSET=NO to 
    obtain an empirical model for the surface alone, then apply the 
    atmospheric scattering parameters in photomet. Fitting with an 
    atmospheric model and ADDOFFSET=YES in phoempglobal is more useful for 
    application to photoclinometry where images are normally corrected by 
    subtracting a uniform haze estimate rather than by applying a full 
    atmospheric scattering model.

    For the original description of the fitting process and a useful 
    compilation of Hapke parameters from the scientific literature, see McEwen 
    (1991). The atmospheric model used in the fits is discussed by Kirk et al. 
    (2000, 2001).

    Example:  Mars

    The following Hapke parameters for Mars are from Johnson
    et al. (1999) for IMP data of Photometry Flats (soil) and may be 
    reasonably representative of Mars as a whole. Note that
    (HG1, HG2=1.0) is equivalent to (-HG1, HG2=0.0) 

    Band    WH     B0     HH    HG1    HG2 
    Red    0.52  0.025  0.170  0.213 1.000 
    Green  0.29  0.290  0.170  0.190 1.000 
    Blue   0.16  0.995  0.170  0.145 1.000 

    Kirk et al. (2000) found that Mars whole-disk limb-darkening data of 
    Thorpe (1973) are consistent with THETA=30, but results of Tanaka and 
    Davis (1988) based on matching photoclinometry of local areas to shadow 
    data are more consistent with THETA=20 when the domain of the fit is 
    restricted to small emission angles (=< 20 degrees).

    Values of the photometric parameters for the martian atmosphere, adopted 
    from Tomasko et al. (1999) are:
 
    Band  WHA     HGA 
    Red    0.95     0.68 
    Blue   0.76     0.78 

    Hapke, B. W., 1981. Bidirectional reflectance spectroscopy 
    1: Theory. J. Geophys. Res., pp. 86,3039-3054.

    Hapke, B., 1984. Bidirectional reflectance spectroscopy 
    3: Corrections for macroscopic roughness. Icarus, 59, pp. 41-59.

    Hapke, B., 1986. Bidirectional reflectance spectroscopy 
    4: The extinction coefficient and the opposition effect. 
    Icarus, 67, pp. 264-280.

    Johnson, J. R., et al., 1999, Preliminary Results on Photometric 
    Properties of Materials at the Sagan Memorial Station, Mars, 
    J. Geophys. Res., 104, 8809. 

    Kirk, R. L., Thompson, K. T., Becker, T. L., and Lee, E. M., 
    2000. Photometric modelling for planetary cartography. 
    Lunar Planet. Sci., XXXI, Abstract #2025, Lunar 
    and Planetary Institute, Houston (CD-ROM).

    Kirk, R. L., Thompson, K. T., and Lee, E. M., 2001. 
    Photometry of the martian atmosphere:  An improved 
    practical model for cartography and photoclinometry. 
    Lunar Planet. Sci., XXXII, Abstract #1874, Lunar 
    and Planetary Institute, Houston (CD-ROM). 

    McEwen, A. S., 1991. Photometric functions for photo-
    clinometry and other applications.  Icarus, 92, pp. 298-311.

    Tanaka, K. L., and and Davis, P. A., 1988, Tectonic History of 
    the Syria Planum Provice of Mars, J. Geophys. Res., 93, 14,893. 

    Thorpe, T. E., 1973, Mariner 9 Photometric Observations of Mars 
    from November 1971 through March 1972, Icarus, 20, 482.

    Tomasko, M. G., et al., 1999, Properties of Dust in the Martian 
    Atmosphere from the Imager on Mars Pathfinder, J. Geophys. Res., 
    104, 8987

    Programmer: Randolph Kirk, U.S.G.S., Flagstaff, AZ
    

Categories


History

Randy Kirk1999-11-16 USGS Flagstaff Original Version
Janet Barrett2003-01-13 Ported pho_fit_global from the VAX and renamed it pho_emp_global in isis2
Sharmila Prasad2011-08-24 Isis3 Original version, pho_emp_global ported from isis2 to isis3 phoempglobal
Randy Kirk2011-09-25 Updated documentation for the phoempglobal program.

Parameter Groups

Files

Name Description
TO Output text file contain fitted parameters

User Note

Name Description
NOTE User note to be added to the output file

HAPKE

Name Description
PHTNAMESurface Photometric Model
WH Single Scattering Albedo
HH Opposition Surge Width
B0 Opposition Surge Strength
THETA Surface roughness in degrees
HG1 Henyey-Greenstein coefficient 1
HG2 Henyey-Greenstein coefficient 2
BH Legendre coefficient 1
CH Legendre coefficient 2

Empirical

Name Description
MODEL Type of empirical photometric function fitted to the Hapke model.

Atmospheric Scattering Model

Name Description
ATMNAME Type of atmospheric scattering model (if any) modifying the surface scattering
TAU Normal atmospheric optical depth
WHA Single-scattering albedo
HGA Henyey-Greenstein coefficient for atmospheric particles
BHA Atmospheric particle Legendre coefficient
HNORM Atmospheric shell thickness
ADDOFFSET Allow additive offset in fit

Fit Range of Angles

Name Description
EMAMIN Minimum Emission Angle
EMAMAX Maximum Emission Angle
EMAMAX_PCOEFF Fraction of phase angle to add to maximum emission angle
INCMIN Minimum Incidence Angle
INCMAX Maximum Incidence Angle
PHMIN Minimum Phase Angle
PHMAX Maximum Phase Angle
NPH Number of phase angles
X

Files: TO


Description

This output is a PVL file containing lists of the phase angle, best fit limb darkening parameter, and brightness, formatted so that it can be used as a photometric template by the programs photemplate (used to edit the parameters) and photomet (used to apply photometric normalization to an image). The file also contains an optional user supplied note.

Type filename
File Mode output
Filter *.txt
Close Window
X

User Note: NOTE


Description

The user can specify a note to be added to the output file using this parameter.

Type string
Internal Default None Specified
Close Window
X

HAPKE: PHTNAME


Description

A Hapke (1981; 1984; 1966) photometric model is always used as the model to which empirical functions are fitted. The options correspond to variants of the Hapke model with different types of model for the single particle phase (scattering) function.

Type combo
Default HAPKEHEN
Option List:
Option Brief Description
HAPKEHEN Use Henyey-Greenstein scattering function in Hapke photometric model This is the two-parameter version of the Henyey-Greenstein single particle phase function, with parameters HG1 and HG2.

Exclusions

  • BH
  • CH
HAPKELEG Use Legendre-Polynomial in Hapke photometric model This is a two-term Legendre Polynomial expansion of the single particle phase function, with parameters BH and CH.

Exclusions

  • HG1
  • HG2
Close Window
X

HAPKE: WH


Description

Single-scattering albedo of surface particles. See Hapke (1981). Not to be confused with albedo WHA of the atmospheric particles.

Type double
Internal Default None Specified
Close Window
X

HAPKE: HH


Description

Opposition Surge Width. ZEROs are strongly advised as the simple models do not fit the opposition effect well. See Hapke (1984).

Type double
Internal Default None Specified
Close Window
X

HAPKE: B0


Description

Opposition Surge Strength. Magnitude of the opposition effect for the surface. ZEROs are strongly advised as the simple models do not fit the opposition effect well. See Hapke (1984).

Type double
Internal Default None Specified
Close Window
X

HAPKE: THETA


Description

Small scale surface roughness in degrees. "Macroscopic roughness" of the surface as it affects the photometric behavior. This is the root mean squared (RMS) slope at scales larger than the distance photons penetrate the surface but smaller than a pixel. See Hapke (1986).

Type double
Internal Default None Specified
Close Window
X

HAPKE: HG1


Description

Asymmetry parameter used in the Henyey-Greenstein model for the scattering phase function of single particles in the surface, used if PHTNAME=HAPKEHEN. See Hapke (1981). The two-parameter Henyey-Greenstein function is P(phase) = (1-HG2) * (1-HG1**2)/(1+HG1**2+2*HG1*COS(PHASE))**1.5 + HG2 * (1-HG1**2)/(1+HG1**2-2*HG1*COS(PHASE))**1.5

Type double
Internal Default None Specified
Close Window
X

HAPKE: HG2


Description

Second parameter of the two-parameter Henyey-Greenstein model for the scattering phase function of single particles in the surface, used if PHTNAME=HAPKEHEN. This parameter controls the proportions in a linear mixture of ordinary Heneyey-Greenstein phase functions with asymmetry parameters equal to +HG1 and -HG1. See HG1 for the full formula.

Type double
Internal Default None Specified
Close Window
X

HAPKE: BH


Description

Coefficient of the first order Legendre polynomial in the single particle phase function. When PHTNAME=HAPKELEG, a two-term Legendre polynomial expansion is used to represent the scattering phase function of single particles in the surface: P(PHASE) = 1 + BH * P1(COS(PHASE)) + CH * P2(COS(PHASE)) where P1 and P2 are the first and second order Legendre polynomials.

Type double
Internal Default None Specified
Close Window
X

HAPKE: CH


Description

Coefficient of the second order Legendre polynomial in the single particle phase function. When PHTNAME=HAPKELEG, a two-term Legendre polynomial expansion is used to represent the scattering phase function of single particles in the surface: P(PHASE) = 1 + BH * P1(COS(PHASE)) + CH * P2(COS(PHASE)) where P1 and P2 are the first and second order Legendre polynomials.

Type double
Internal Default None Specified
Close Window
X

Empirical: MODEL


Description

Determines which empirical photometric function will be fitted to the Hapke model. The lists of brightness and limb darkening values can be used with the lunar-Lambert empirical or Minnaert empirical photometric functions in the photometric normalization program photomet.

Type combo
Internal Default LunarLambert
Option List:
Option Brief Description
LUNARLAMBERT Lunar-Lambert Empirical Photometric Function Fit the Lunar-Lambert Empirical Photometric Function to the Hapke Model. The empirical lunar-Lambert model as defined by McEwen (1991) and used by the program photomet is: Lunar-Lambert FUNC=B(PHASE) * ((1-L(PHASE))*u0 + 2*L(PHASE)*u0/(u0+u))
MINNAERT Minnaert Empirical Photometric Function Fit the Minnaert Empirical Photometric Function to the Hapke Model. The empirical Minnaert model as defined by McEwen (1991) and used by the program photomet is: Minnaert FUNC=B(PHASE) * u0**K(PHASE) * u**(K(PHASE)-1)
Close Window
X

Atmospheric Scattering Model: ATMNAME


Description

If an option other than NONE is selected, an atmospheric scattering model will be included in addition to the surface Hapke model as part of the physical model to which the empirical model is fitted. Six atmospheric models are currently provided, falling into three classes that differ in their treatment of the single particle scattering function for atmospheric particles. Each of these classes of model can be evaluated to a first order (faster) or second order (more accurate) approximation. Atmospheric scattering in all these models both attenuates the surface signal and adds its own (uniform) contribution to the image radiance. Therefore, unless NONE is selected, it makes sense to also set ADDOFFSET=YES so that the additive contribution of the atmosphere will be modeled by an additive constant in the fit. Because the program photomet (used to make photometric corrections to images) incorporates all the same atmospheric scattering models as phoempglobal, one would normally set ATMNAME=NONE and ADDOFFSET=NO to obtain an empirical model for the surface alone, then apply the atmospheric scattering parameters in photomet. Fitting with an atmospheric model and ADDOFFSET=YES in phoempglobal is more useful for application to photoclinometry where images are normally corrected by subtracting a uniform haze estimate rather than by applying a full atmospheric scattering model.

Type combo
Default NONE
Internal Default NONE
Option List:
Option Brief Description
NONE No Atmospheric Scattering Model The radiance from the Hapke surface is not modified by atmospheric scattering.

Exclusions

  • TAU
  • WHA
  • HGA
  • HNORM
  • ADDOFFSET
  • BHA
ISOTROPIC1 First Order Isotropic Atmospheric particles are assumed to scatter light isotropically. The effects of this scattering are calculated exactly to first order.

Exclusions

  • HGA
  • BHA

Inclusions

  • TAU
  • WHA
  • HNORM
  • ADDOFFSET
ISOTROPIC2 Second Order Isotropic Atmospheric particles are assumed to scatter light isotropically. The effects of this scattering are calculated exactly to second order.

Exclusions

  • HGA
  • BHA

Inclusions

  • TAU
  • WHA
  • HNORM
  • ADDOFFSET
ANISOTROPIC1 First Order Anisotropic Atmospheric particles are assumed to scatter light according to a Legendre polynomial model with a single term. The effects of this scattering are calculated exactly to first order.

Exclusions

  • HGA

Inclusions

  • TAU
  • WHA
  • BHA
  • HNORM
  • ADDOFFSET
ANISOTROPIC2 Second Order Anisotropic Atmospheric particles are assumed to scatter light according to a Legendre polynomial model with a single term. The effects of this scattering are calculated exactly to second order.

Exclusions

  • HGA

Inclusions

  • TAU
  • WHA
  • BHA
  • HNORM
  • ADDOFFSET
HAPKEATM1 First Order Henyey-Greenstein Atmospheric particles are assumed to scatter light according to a single parameter Henyey-Greenstein function (see the description of the surface scattering parameter HG1 for the equation that combines two such functions for surface particles). The effects of this scattering are approximated by using a first order solution for multiple scattering by isotropic particles and making a correction to the distribution of singly scattered radiation. The model is called HAPKEATM1 because this correction for the single particle phase function is similar to the one developed by Hapke (1981) for surface scattering.

Exclusions

  • BHA

Inclusions

  • TAU
  • WHA
  • HGA
  • HNORM
  • ADDOFFSET
HAPKEATM2 Second Order Henyey-Greenstein Atmospheric particles are assumed to scatter light according to a single parameter Henyey-Greenstein function (see the description of the surface scattering parameter HG1 for the equation that combines two such functions for surface particles). The effects of this scattering are approximated by using a second order solution for multiple scattering by isotropic particles and making a correction to the distribution of singly scattered radiation. The model is called HAPKEATM2 because this correction for the single particle phase function is similar to the one developed by Hapke (1981) for surface scattering.

Exclusions

  • BHA

Inclusions

  • TAU
  • WHA
  • HGA
  • HNORM
  • ADDOFFSET
Close Window
X

Atmospheric Scattering Model: TAU


Description

Normal atmospheric optical depth

Type double
Internal Default None Specified
Close Window
X

Atmospheric Scattering Model: WHA


Description

Single-scattering albedo of atmospheric particles, not to be confused with the albedo WH of surface particles.

Type double
Internal Default None Specified
Close Window
X

Atmospheric Scattering Model: HGA


Description

Parameter used in the Henyey-Greenstein single particle phase function for atmospheric particles when ATMNAME=HAPKEATM1 or ATMNAME=HAPKEATM2. This is the asymmetry parameter for a single term Henyey-Greenstein model P(PHASE) = (1-HGA**2)/ (1+HGA**2+2*HGA*COS(PHASE))**1.5 Not to be confused with corresponding parameter HG1 for the surface particles.

Type double
Internal Default None Specified
Close Window
X

Atmospheric Scattering Model: BHA


Description

Coefficient of the first order Legendre polynomial in the single particle phase function for atmospheric scattering. When ATMNAME=ANISOTROPIC1 or ATMNAME=ANISOTROPIC2, a two-term Legendre polynomial expansion is used to represent the scattering phase function of single particles in the atmosphere: P(PHASE) = 1 + BHA * P1(COS(PHASE)) where P1 is the first order Legendre polynomial. Not to be confused with the corresponding parameter BH for the surface.

Type double
Internal Default None Specified
Close Window
X

Atmospheric Scattering Model: HNORM


Description

Atmospheric shell thickness normalized to planet radius, used to correct the path lengths of atmospheric transmission for the spherical geometry of the planet. Default 0.003 is for Mars.

Type double
Internal Default None Specified
Close Window
X

Atmospheric Scattering Model: ADDOFFSET


Description

If true, the additive contribution of the atmosphere will be modeled by an additive constant in the fit of the empirical function at each phase angle.

Type boolean
Default false
Close Window
X

Fit Range of Angles: EMAMIN


Description

Minimum emission angle included in the fit. The empirical photometric function will be fitted to the Hapke model over a portion of the visible hemisphere of an idealized planet, with INCMIN =< incidence angle =< INCMAX and EMAMIN =< emission angle =< EMAMAX + EMAMAX_PCOEFF * phase INCMIN and EMAMIN are normally set to 0 and INCMAX and EMAMAX set to values approaching 90 to exclude only limited regions near the limb and terminator from the fit.

Type double
Internal Default None Specified
Close Window
X

Fit Range of Angles: EMAMAX


Description

Maximum emission angle included in the fit. The empirical photometric function will be fitted to the Hapke model over a portion of the visible hemisphere of an idealized planet, with INCMIN =< incidence angle =< INCMAX and EMAMIN =< emission angle =< EMAMAX + EMAMAX_PCOEFF * phase INCMIN and EMAMIN are normally set to 0 and INCMAX and EMAMAX set to values approaching 90 to exclude only limited regions near the limb and terminator from the fit.

Type double
Internal Default None Specified
Close Window
X

Fit Range of Angles: EMAMAX_PCOEFF


Description

EMAMAX_PCOEFF allows the range of emission angles included in the fit to increase slightly at high phase angles, because otherwise the region of fit becomes very small. The empirical photometric function will be fitted to the Hapke model over a portion of the visible hemisphere of an idealized planet, with INCMIN =< incidence angle =< INCMAX and EMAMIN =< emission angle =< EMAMAX + EMAMAX_PCOEFF * phase

Type double
Internal Default None Specified
Close Window
X

Fit Range of Angles: INCMIN


Description

Minimum incidence angle included in the fit. The empirical photometric function will be fitted to the Hapke model over a portion of the visible hemisphere of an idealized planet, with INCMIN =< incidence angle =< INCMAX and EMAMIN =< emission angle =< EMAMAX + EMAMAX_PCOEFF * phase INCMIN and EMAMIN are normally set to 0 and INCMAX and EMAMAX to values approaching 90 to exclude only limited regions near the limb and terminator from the fit.

Type double
Internal Default None Specified
Close Window
X

Fit Range of Angles: INCMAX


Description

Maximum incidence angle included in the fit. The empirical photometric function will be fitted to the Hapke model over a portion of the visible hemisphere of an idealized planet, with INCMIN =< incidence angle =< INCMAX and EMAMIN =< emission angle =< EMAMAX + EMAMAX_PCOEFF * phase INCMIN and EMAMIN are normally set to 0 and INCMAX and EMAMAX to values approaching 90 to exclude only limited regions near the limb and terminator from the fit.

Type double
Internal Default None Specified
Close Window
X

Fit Range of Angles: PHMIN


Description

Minimum phase angle at which a fit will be performed, corresponding to the first value in the output table.

Type double
Internal Default None Specified
Close Window
X

Fit Range of Angles: PHMAX


Description

Maximum phase angle at which a fit will be performed, corresponding to the last value in the output table.

Type double
Internal Default None Specified
Close Window
X

Fit Range of Angles: NPH


Description

Number of phase angles at which a fit will be performed, equal to the number of values in the output table.

Type integer
Internal Default None Specified
Close Window