Isis 3 Application Documentation
Create a PVL template with photometric algorithms and parameters to be used
for photometric correction
Description
This program creates a PVL template to be used in photometry-based
applications (such as photomet). There are two types of correction that
can be specified by this program:
1) Photometric
2) Atmospheric
Photometric correction applies to the surface of an image. Atmospheric
correction applies to the atmosphere through which an image was acquired.
This program will allow the user to provide a FROMPVL file that has some
preset parameters for different photometric and atmospheric models. Each
planet has different surface and atmospheric properties that require model
specifications that won't be applicable to other planets. It is important
to set up the models and their parameters that apply to the planetary data
you are working with.
Example output files:
Example 1:
Object = PhotometricModel
Group = Algorithm
PhtName = Lambert
EndGroup
EndObject
Example 2:
Object = PhotometricModel
Group = Algorithm
PhtName = Minnaert
K = .5
EndGroup
EndObject
Example 3:
Object = PhotometricModel
Group = Algorithm
Name = Moonpr
EndGroup
EndObject
Example 4:
Object = PhotometricModel
Group = Algorithm
Name = HapkeHen
Wh = 0.52
Hh = 0.0
B0 = 0.0
Theta = 30.0
Hg1 = .213
Hg2 = 1.0
EndGroup
EndObject
Object = AtmosphericModel
Group = Algorithm
Name = HapkeAtm2
Hnorm = .003
Tau = 0.28
Tauref = 0.0
Wha = .95
Hga = 0.68
EndGroup
EndObject
Categories
Applications
History
Noah Hilt | 2008-11-18 |
Original version
|
Janet Barrett | 2011-09-23 |
1) The entire user interface has been redesigned. The previous version of this
program made use of radio button lists to allow the user to choose a photometric
model or an atmospheric model. In order to make the program more compact, the
radio button lists were replaced with drop down menus. When an option is chosen
from the drop down menu, the parameters that apply to that option are made visible.
Parameters that don't apply to that option remain hidden. This helps to make the
interface look less cluttered than it did when every parameter and every option
were visible all the time.
2) The "NORMALIZATION" option is no longer available in this program. This program's
main use is to create files with preset photometric and atmospheric values for use
with various planets. The normalization models are not specific to individual
planets like the atmospheric and photometric models are. The normalization mode
is only used in the photomet program, so this information now needs to be
provided through photomet.
3) The PVL parameter was replaced with the TOPVL parameter. The PHOTOMETRIC
parameter was replaced with PHTNAME. The ATMOSPHERIC parameter was replaced with
ATMNAME.
4) The BHAREF, HGAREF, and WHAREF parameters were removed because they have
become obsolete.
5) The Hapke Legendre (HAPKELEG), empirical Minnaert (MINNAERTEMPIRICAL), and
empirical Lunar Lambert (LUNARLAMBERTEMPIRICAL) photometric functions have
been added.
6) Documentation describing the parameters is still central to the photomet
program. The documentation will be moved into this program in the next ISIS
release.
7) Helper buttons were added to the FROMPVL to allow you to View a PVL or to Load
a PVL. PLEASE NOTE: When loading a Minnaert Empirical or Lunar Lambert Empirical
model from a PVL, only the first value will be loaded into the GUI. This is
a known problem and will be fixed in the next patch or release to ISIS.
8) ***NOTE*** The Minnaert Empirical and Lunar Lambert Empirical models do not
load properly from a PVL file when using the Load Pvl helper button. This is
a known problem and will be fixed in the next patch or release of ISIS.
|
Sharmila Prasad | 2011-10-27 |
Added API's to display and output PVL info, specifically for arrays and
alphabetically organised the Photometric Model names
|
|
Parameter Groups
Files
Name
|
Description
|
FROMPVL |
Input PVL containing the photometric algorithms to use
|
TOPVL |
Output PVL containing the photometric algorithms to use
|
Photometric Parameters
Name
|
Description
|
PHTNAME |
Photometric model to be used
|
THETA |
Macroscopic Roughness Angle
|
WH |
Single Scattering Albedo
|
HG1 |
Hapke Henyey Greenstein Coefficient
|
HG2 |
Hapke Henyey Greenstein Coefficient
|
BH |
Hapke Legendre Coefficient
|
CH |
Hapke Legendre Coefficient
|
HH |
Hapke Opposition Surge
|
B0 |
Hapke Opposition Surge
|
L |
Lunar-Lambert Function Weight
|
K |
Minnaert Function Exponent
|
PHASELIST |
Minnaert Empirical Function Phase Angle List
|
KLIST |
Minnaert Empirical Function Limb Darkening Parameter List
|
LLIST |
Lunar Lambert Empirical Function Limb Darkening Parameter List
|
PHASECURVELIST |
Minnaert Empirical Function Phase Curve Value List
|
Atmospheric Parameters
Name
|
Description
|
ATMNAME |
Atmospheric model to be used
|
NULNEG |
Determines if negative values will be set to NULL
|
TAU |
Optical Depth of Atmosphere
|
TAUREF |
Reference Value of Tau
|
HGA |
Henyey Greenstein Coefficient
|
WHA |
Single Scattering Albedo
|
BHA |
Legendre Coefficient
|
HNORM |
Atmospheric Shell Thickness
|
|
Files:
FROMPVL
Description
Use this parameter to select an input filename. The information in
this file will be merged with the information that is input through
the user interface to create the output PVL file.
Type
| filename |
File Mode
| input |
Default Path
| $base/templates/photometry |
Internal Default
| None Specified |
Filter
|
*.pvl
|
Files:
TOPVL
Description
Use this parameter to select the output filename. If the file already
exists it will be overwritten. The '.pvl' extension will
automatically be appended to the entered filename if you do not type
in an extension.
Type
| filename |
File Mode
| output |
Filter
|
*.pvl
|
Photometric Parameters:
PHTNAME
Description
This is the name of the surface photometric function model
Type
| combo |
Default
|
NONE
|
Internal Default
| NONE |
Option List:
|
Option |
Brief |
Description |
NONE | No Photometric Model |
Exclusions
- THETA
- WH
- HG1
- HG2
- HH
- B0
- BH
- CH
- L
- K
- PHASELIST
- KLIST
- LLIST
- PHASECURVELIST
|
HAPKEHEN |
Hapke-Henyey-Greenstein Photometric Model
|
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.
Exclusions
- BH
- CH
- L
- K
- PHASELIST
- KLIST
- LLIST
- PHASECURVELIST
Inclusions
|
HAPKELEG |
Hapke-Legendre Photometric Model
|
Hapke-Legendre photometric model. Derive model albedo
using complete Hapke model with Legendre single-particle
phase function whose coefficients are Bh and Ch, plus single
scattering albedo Wh, opposition surge parameters Hh and B0, and
macroscopic roughness Theta.
Exclusions
- HG1
- HG2
- L
- K
- PHASELIST
- KLIST
- LLIST
- PHASECURVELIST
Inclusions
|
LAMBERT |
Lambert Photometric Model
|
Simple photometric model which predicts that light
incident on a surface is scattered uniformly in all directions;
the total amount of reflected light depends on the incidence angle
of the illumination. This function does not depend upon the
outgoing light direction.
Exclusions
- THETA
- WH
- HG1
- HG2
- HH
- B0
- BH
- CH
- L
- K
- PHASELIST
- KLIST
- LLIST
- PHASECURVELIST
|
LOMMELSEELIGER |
Lommel-Seeliger Photometric Model
|
This model takes into account the radiance that results from
single scattering (scattering of collimated incident light) and
does not take into account the radiance that results from multiple
scattering (scattering of diffuse light which has made its way
indirectly to the same position by being scattered one or more
times). This model depends on the incidence and emission angles.
Exclusions
- THETA
- WH
- HG1
- HG2
- BH
- CH
- HH
- B0
- L
- K
- PHASELIST
- KLIST
- LLIST
- PHASECURVELIST
|
LUNARLAMBERT |
Lunar Lambert Photometric Model
|
This model combines a weighted sum of the LommelSeeliger and
Lambert models. Given a suitable value for the LunarLambert
function weight, L, this model fits the true reflectance behavior
of many planetary surfaces equally well as the Hapke model. This
model also depends on the incidence and emission angles.
Exclusions
- THETA
- WH
- HG1
- HG2
- BH
- CH
- HH
- B0
- K
- PHASELIST
- KLIST
- LLIST
- PHASECURVELIST
Inclusions
|
LUNARLAMBERTEMPIRICAL |
Lunar Lambert Empirical Photometric Model
|
This model combines a weighted sum of the LommelSeeliger and
Lambert models. Given a suitable value for the LunarLambert
function weight, L, this model fits the true reflectance behavior
of many planetary surfaces equally well as the Hapke model. This
model also depends on the incidence and emission angles.
Exclusions
- THETA
- WH
- HG1
- HG2
- BH
- CH
- HH
- B0
- K
- L
- KLIST
Inclusions
- PHASELIST
- LLIST
- PHASECURVELIST
|
LUNARLAMBERTMCEWEN |
Lunar Lambert-McEwen Photometric Model
|
This model was developed specifically for use with the Moon. This
model was designed to be used in conjunction with the MoonAlbedo
normalization model.
Exclusions
- THETA
- WH
- HG1
- HG2
- BH
- CH
- HH
- B0
- L
- K
- PHASELIST
- KLIST
- LLIST
- PHASECURVELIST
|
MINNAERT |
Minnaert Photometric Model
|
This model combines a weighted sum of the LommelSeeliger and
Lambert models. Given a suitable value for the LunarLambert
function weight, L, this model fits the true reflectance behavior
of many planetary surfaces equally well as the Hapke model. This
model also depends on the incidence and emission angles.
Exclusions
- THETA
- WH
- HG1
- HG2
- BH
- CH
- HH
- B0
- L
- PHASELIST
- KLIST
- LLIST
- PHASECURVELIST
Inclusions
|
MINNAERTEMPIRICAL |
Minnaert Empirical Photometric Model
|
This model combines a weighted sum of the LommelSeeliger and
Lambert models. Given a suitable value for the LunarLambert
function weight, L, this model fits the true reflectance behavior
of many planetary surfaces equally well as the Hapke model. This
model also depends on the incidence and emission angles.
Exclusions
- THETA
- WH
- HG1
- HG2
- BH
- CH
- HH
- B0
- K
- L
- LLIST
Inclusions
- PHASELIST
- KLIST
- PHASECURVELIST
|
|
Photometric Parameters:
THETA
Description
The Hapke macroscopic roughness component.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(inclusive)
|
Maximum
| 90.0
(inclusive)
|
Photometric Parameters:
WH
Description
The Hapke single scattering albedo component.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(exclusive)
|
Maximum
| 1.0
(inclusive)
|
Photometric Parameters:
HG1
Description
The Hapke Henyey Greenstein coefficient for single particle phase
function.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| -1.0
(exclusive)
|
Maximum
| 1.0
(exclusive)
|
Photometric Parameters:
HG2
Description
The Hapke Henyey Greenstein coefficient for single particle phase
function.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(inclusive)
|
Maximum
| 1.0
(inclusive)
|
Photometric Parameters:
BH
Description
The Hapke Legendre coefficient for single particle phase
function.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| -1.0
(exclusive)
|
Maximum
| 1.0
(exclusive)
|
Photometric Parameters:
CH
Description
The Hapke Legendre coefficient for single particle phase
function.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| -1.0
(exclusive)
|
Maximum
| 1.0
(exclusive)
|
Photometric Parameters:
HH
Description
The Hapke opposition surge component.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(inclusive)
|
Photometric Parameters:
B0
Description
The Hapke opposition surge component.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(inclusive)
|
Photometric Parameters:
L
Description
The Lunar-Lambert function weight.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Photometric Parameters:
K
Description
The Minnaert function exponent.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(inclusive)
|
Photometric Parameters:
PHASELIST
Description
The Minnaert empirical function phase angle list.
Type
| string |
Default
| No List |
Internal Default
|
No List
|
Photometric Parameters:
KLIST
Description
The Minnaert empirical function exponent list.
Type
| string |
Default
| No List |
Internal Default
|
No List
|
Photometric Parameters:
LLIST
Description
The Lunar Lambert empirical function exponent list.
Type
| string |
Default
| No List |
Internal Default
|
No List
|
Photometric Parameters:
PHASECURVELIST
Description
The Minnaert empirical function phase curve value list.
Type
| string |
Default
| No List |
Internal Default
|
No List
|
Atmospheric Parameters:
ATMNAME
Description
This is the name of the atmospheric photometric function model. This
can only be used with the three atmospheric normalization models:
AlbedoAtm, ShadeAtm, and TopoAtm.
Type
| combo |
Default
|
NONE
|
Internal Default
| NONE |
Option List:
|
Option |
Brief |
Description |
NONE | No Atmospheric Model |
Exclusions
- HNORM
- BHA
- TAU
- TAUREF
- WHA
- HGA
- NULNEG
|
ANISOTROPIC1 |
Anisotropic 1 Atmospheric Model
|
Uses Chandrasekhar's solution for anisotropic scattering described
by a one term Legendre polynomial. This model uses first order
scattering approximation.
Exclusions
Inclusions
|
ANISOTROPIC2 |
Anisotropic 2 Atmospheric Model
|
Uses Chandrasekhar's solution for anisotropic scattering described
by a one term Legendre polynomial. This model uses second order
scattering approximation. It is slower but more accurate than
Anisotropic1.
Exclusions
Inclusions
|
HAPKEATM1 |
Hapke 1 Atmospheric Model
|
Provides an approximation for strongly anisotropic scattering that
is similar to Hapke's model for a planetary surface. The
Chandrasekhar solution for isotropic scattering is used for the
multiple scattering terms, and a correction is made to the singly
scattered light for anisotropic particle phase function. A one
term Henyey Greenstein function is used. This model uses a first
order scattering approximation.
Exclusions
Inclusions
|
HAPKEATM2 |
Hapke 2 Atmospheric Model
|
Provides an approximation for strongly anisotropic scattering that
is similar to Hapke's model for a planetary surface. The
Chandrasekhar solution for isotropic scattering is used for the
multiple scattering terms, and a correction is made to the singly
scattered light for anisotropic particle phase function. A one
term Henyey Greenstein function is used. This model uses a second
order scattering approximation. It is slower but more accurate
than HapkeAtm1.
Exclusions
Inclusions
|
ISOTROPIC1 |
Isotropic 1 Atmospheric Model
|
Uses Chandrasekhar's solution for isotropic scattering. This model
uses first order scattering approximation.
Exclusions
Inclusions
|
ISOTROPIC2 |
Isotropic 2 Atmospheric Model
|
Uses Chandrasekhar's solution for isotropic scattering. This model
uses second order scattering approximation. It is slower but more
accurate than Isotropic1.
Exclusions
Inclusions
|
|
Atmospheric Parameters:
NULNEG
Description
This determines if negative values after removal of atmospheric
effects will be set to NULL.
Type
| string |
Default
| READFROMPVL |
Option List:
|
Option |
Brief |
Description |
READFROMPVL |
NULNEG will be set using the value in the FROMPVL file
|
This option specifies that the NULNEG value be retrieved
from the FROMPVL file. If a FROMPVL file was not provided,
then an error will occur.
|
NO |
Negative values will not be set to NULL
|
This option specifies that the negative values will not be set to
NULL after the removal of atmospheric effects.
|
YES |
Negative values will be set to NULL
|
This option specifies that the negative values will be set to
NULL after the removal of atmospheric effects.
|
|
Atmospheric Parameters:
TAU
Description
The normal optical depth of the atmosphere.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(inclusive)
|
Atmospheric Parameters:
TAUREF
Description
The reference value of Tau to which the image will be normalized.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(inclusive)
|
Atmospheric Parameters:
HGA
Description
The coefficient of single particle Henyey Greenstein phase
function.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| -1.0
(exclusive)
|
Maximum
| 1.0
(exclusive)
|
Atmospheric Parameters:
WHA
Description
The single scattering albedo of atmospheric particles.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(exclusive)
|
Maximum
| 1.0
(inclusive)
|
Atmospheric Parameters:
BHA
Description
The coefficient of the single particle Legendre phase function.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| -1.0
(inclusive)
|
Maximum
| 1.0
(inclusive)
|
Atmospheric Parameters:
HNORM
Description
The atmospheric shell thickness normalized to the planet
radius.
Type
| string |
Default
| None Specified |
Internal Default
| None Specified |
Minimum
| 0.0
(inclusive)
|