Isis 3 Application Documentation
Fit empirical photometric functions to Hapke
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 Kirk | 1999-11-16 |
USGS Flagstaff Original Version
|
Janet Barrett | 2003-01-13 |
Ported pho_fit_global from the VAX and renamed it
pho_emp_global in isis2
|
Sharmila Prasad | 2011-08-24 |
Isis3 Original version, pho_emp_global ported from isis2 to isis3
phoempglobal
|
Randy Kirk | 2011-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
|
PHTNAME | Surface 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
|
|
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
|
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 |
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
|
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
|
|
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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)
|
|
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
Inclusions
|
ISOTROPIC2 |
Second Order Isotropic
|
Atmospheric particles are assumed to scatter light isotropically.
The effects of this scattering are calculated exactly to second
order.
Exclusions
Inclusions
|
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
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
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
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
Inclusions
- TAU
- WHA
- HGA
- HNORM
- ADDOFFSET
|
|
Atmospheric Scattering Model:
TAU
Description
Normal atmospheric optical depth
Type
| double |
Internal Default
| None Specified |
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 |
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 |
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 |
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 |
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
|
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |