ISIS 3 Application Documentation
Trims pixels outside of phase, incidence, and emission angles
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:
History
Tammy Becker | 1999-02-11 |
Original version
|
Stuart Sides | 2003-06-04 |
Converted trimandle to Isis 3.0, and made it trim only on phase, incidence
and emission angles.
|
Stuart Sides | 2003-07-29 |
Modified filename parameters to be cube parameters where necessary
|
Steven Lambright | 2008-05-13 |
Removed references to CubeInfo
|
|
Parameter Groups
Files
Name
|
Description
|
FROM |
Input cube to trim
|
TO |
Output cube
|
Photometry
|
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
|
Files:
TO
Description
This file will contain the results of the trim.
Type
| cube |
File Mode
| output |
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
|
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
|
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
|
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
|
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
|
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
|