Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search

USGS

Isis 3 Application Documentation


photemplate

Printer Friendly View | TOC | Home

Create a PVL template with photometric algorithms and parameters to be used for photometric correction

Overview Parameters

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


Related Objects and Documents

Applications


History

Noah Hilt2008-11-18 Original version
Janet Barrett2011-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 Prasad2011-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
X

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
Close Window
X

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
Close Window
X

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
NONENo 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

  • THETA
  • WH
  • HG1
  • HG2
  • HH
  • B0
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

  • THETA
  • WH
  • BH
  • CH
  • HH
  • B0
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

  • L
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

  • K
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
Close Window
X

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)
Close Window
X

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)
Close Window
X

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)
Close Window
X

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)
Close Window
X

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)
Close Window
X

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)
Close Window
X

Photometric Parameters: HH


Description

The Hapke opposition surge component.

Type string
Default None Specified
Internal Default None Specified
Minimum 0.0 (inclusive)
Close Window
X

Photometric Parameters: B0


Description

The Hapke opposition surge component.

Type string
Default None Specified
Internal Default None Specified
Minimum 0.0 (inclusive)
Close Window
X

Photometric Parameters: L


Description

The Lunar-Lambert function weight.

Type string
Default None Specified
Internal Default None Specified
Close Window
X

Photometric Parameters: K


Description

The Minnaert function exponent.

Type string
Default None Specified
Internal Default None Specified
Minimum 0.0 (inclusive)
Close Window
X

Photometric Parameters: PHASELIST


Description

The Minnaert empirical function phase angle list.

Type string
Default No List
Internal Default No List
Close Window
X

Photometric Parameters: KLIST


Description

The Minnaert empirical function exponent list.

Type string
Default No List
Internal Default No List
Close Window
X

Photometric Parameters: LLIST


Description

The Lunar Lambert empirical function exponent list.

Type string
Default No List
Internal Default No List
Close Window
X

Photometric Parameters: PHASECURVELIST


Description

The Minnaert empirical function phase curve value list.

Type string
Default No List
Internal Default No List
Close Window
X

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
NONENo 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

  • HGA

Inclusions

  • HNORM
  • BHA
  • TAU
  • TAUREF
  • WHA
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

  • HGA

Inclusions

  • HNORM
  • BHA
  • TAU
  • TAUREF
  • WHA
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

  • BHA

Inclusions

  • HNORM
  • HGA
  • TAU
  • TAUREF
  • WHA
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

  • BHA

Inclusions

  • HNORM
  • HGA
  • TAU
  • TAUREF
  • WHA
ISOTROPIC1 Isotropic 1 Atmospheric Model Uses Chandrasekhar's solution for isotropic scattering. This model uses first order scattering approximation.

Exclusions

  • HGA
  • BHA

Inclusions

  • HNORM
  • TAU
  • TAUREF
  • WHA
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

  • HGA
  • BHA

Inclusions

  • HNORM
  • TAU
  • TAUREF
  • WHA
Close Window
X

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.
Close Window
X

Atmospheric Parameters: TAU


Description

The normal optical depth of the atmosphere.

Type string
Default None Specified
Internal Default None Specified
Minimum 0.0 (inclusive)
Close Window
X

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)
Close Window
X

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)
Close Window
X

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)
Close Window
X

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)
Close Window
X

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)
Close Window