geoback Documentation

geoback - Create backplanes with geometric information
GEOBACK will create backplanes on an existing cube that contain
geometric information.  This information can be used by other programs
such as MOSAIC.  The following backplanes will be added:

  Back plane name       Units
  ----------------      -------
  EMISSION_ANGLE        degrees
  INCIDENCE_ANGLE       degrees
  PHASE_ANGLE           degrees
  RESOLUTION            km/pix
  LATITUDE              degrees
  LONGITUDE             degrees

Two of the algorithms in MOSAIC use more than one backplane to make a
decision on which image to keep.  The equations are:

  Albedo=resolution*[1/cos(emission angle)+1/cos(incidence angle)]
  Morph=resolution/cos(emission angle)

PROGRAMMER: Kay Edwards, U.S.G.S. Flagstaff, AZ

Input cube file name
(Default extension is .cub)

NONE

Create emission angle backplane
Used in MORPH and ALBEDO option
for MOSAIC (YES,NO)

YES

Create incidence angle backplane
Used in MORPH and ALBEDO option
for MOSAIC (YES,NO)

YES

Create phase angle backplane
(YES,NO)

NO

Create resolution backplane
Used in ALBEDO option for MOSAIC
(YES,NO)

YES

Create latitude backplane
(YES,NO)

NO

Create longitude backplane
(YES,NO)

NO

Use topography backplane to
calculate ema, inc and phase

NO

Create slope backplane
(only valid when topo=yes
(YES,NO)

NO

Create aspect backplane
(only valid when topo=yes
(YES,NO)

NO

Band number with most valid
pixel value coverage

1

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
EMA	If EMA=YES, a backplane labeled EMISSION_ANGLE will be created of the emission angle values in degrees.
INCIDENCE	If INC=YES, a backplane labeled INCIDENCE_ANGLE will be created of the incidence angle values in degrees.
PHASE	If PHASE=YES, a backplane labeled PHASE_ANGLE will be created of the phase angle values in degrees.
RES	If RES=YES, a backplane labeled RESOLUTION will be created of the resolution values in km/pix.
LAT	If LAT=YES, a backplane labeled LATITUDE will be created of the latitude values in degrees.
LON	If LON=YES, a backplane labeled LONGITUDE will be created of the longitude values in degrees.
TOPO	Use TOPOGRAPHY backplane to calculate ema, inc and phase angles. The elevation of three pixels will be used to determine the local vertical vector: the pixel of interest, the pixel below and the pixel to the right of the pixel of interest. Note: use "bandcopy" to put the topography data in a backplane of a level 2 image. The backplane must be called TOPOGRAPHY.
SLOPE	If SLOPE=YES, a backplane labeled SLOPE will be created of the slope values in degrees. This option is only valid when TOPO=YES.
ASPECT	If ASPECT=YES, a backplane labeled ASPECT will be created of the aspect values in degrees. This option is only valid when TOPO=YES.
BAND	BAND allows the user to specify which band contains the most valid data. This eliminates the problem that is, if the first band contains all nulls and band=1, backplanes will be generated, but they will contain all nulls.