Home
About ISIS
Support
Download

ISIS 3

Documentation
Tutorials
Technical Documents

ISIS 2

Documentation
Tutorials
Technical Documents

Search

USGS

ISIS 3 Application Documentation


photrim

Printer Friendly View | TOC | Home

Trims pixels outside of phase, incidence, and emission angles

Overview Parameters

Description

Given a camera based cube and minimum and maximum ranges for the phase, incidence, and emission angles, this program sets any pixels outside these ranges to NULL. Photrim uses angles calculated from the spheroid; it does not use local slopes.

Angle Definitions:

Phase Angle - The angle between the sun vector to a point on the spheroid and the instrument vector to the same point.
Incidence Angle - The angle between the sun vector to a point on the spheroid and the normal at that point.
Emission Angle - The angle between the instrument vector to a point on the spheroid and the normal at that point.

Examples of special cases:

1) If the instrument is directly between the point and the sun, then the phase angle is 0; if both the sun and the instrument are both along the normal to the point, then the phase, incidence and emission angles are all zero.

2) If the instrument is looking along the normal and the sun is illuminating the point, then the emission angle is 0 and the incidence and phase angles will be in the range of 0 to 90 and equal to each other.

3) A point on the surface of a spherical body cannot be illuminated if the incidence angle is greater than 90 degrees.

4) A point on the surface of spherical body cannot be visible if the emission angle is greater than 90 degrees.

5) If a point is both illuminated and visible, then the phase angle ranges from 0 to less than 180.

Categories


Related Applications to Previous Versions of ISIS

This program replaces the following application existing in previous versions of ISIS:
  • trimangle

History

Tammy Becker1999-02-11 Original version
Stuart Sides2003-06-04 Converted trimandle to Isis 3.0, and made it trim only on phase, incidence and emission angles.
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Steven Lambright2008-05-13 Removed references to CubeInfo

Parameter Groups

Files

Name Description
FROM Input cube to trim
TO Output cube

Photometry

Name Description
MINPHASEMinimum phase angle to trim
MAXPHASEMaximum phase angle to trim
MINEMISSIONMinimum emission angle to trim
MAXEMISSIONMaximum emission angle to trim
MININCIDENCEMinimum incidence angle to trim
MAXINCIDENCEMaximum incidence angle to trim
X

Files: FROM


Description

Use this parameter to select the filename. All bands within the file will be trimmed.

Type cube
File Mode input
Filter *.cub
Close Window
X

Files: TO


Description

This file will contain the results of the trim.

Type cube
File Mode output
Close Window
X

Photometry: MINPHASE


Description

Pixels which have a phase angle less than this value will be trimmed.

Type double
Default 0.0
Minimum 0.0 (inclusive)
Maximum 180.0 (inclusive)
Less Than or Equal MAXPHASE
Close Window
X

Photometry: MAXPHASE


Description

Pixels which have a phase angle greater than this value will be trimmed.

Type double
Default 180.0
Minimum 0.0 (inclusive)
Maximum 180.0 (inclusive)
Greater Than or Equal MINPHASE
Close Window
X

Photometry: MINEMISSION


Description

Pixels which have an emission angle less than this value will be trimmed.

Type double
Default 0.0
Minimum 0.0 (inclusive)
Maximum 90.0 (inclusive)
Less Than or Equal MAXEMISSION
Close Window
X

Photometry: MAXEMISSION


Description

Pixels which have a emission angle greater than this value will be trimmed.

Type double
Default 90.0
Minimum 0.0 (inclusive)
Maximum 90.0 (inclusive)
Greater Than or Equal MINEMISSION
Close Window
X

Photometry: MININCIDENCE


Description

Pixels which have an incidence angle less than this value will be trimmed.

Type double
Default 0.0
Minimum 0.0 (inclusive)
Maximum 180.0 (inclusive)
Less Than or Equal MAXINCIDENCE
Close Window
X

Photometry: MAXINCIDENCE


Description

Pixels which have a incidence angle greater than this value will be trimmed.

Type double
Default 90.0
Minimum 0.0 (inclusive)
Maximum 180.0 (inclusive)
Greater Than or Equal MININCIDENCE
Close Window