Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

Public Release
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


bandnorm

Standard View | TOC | Home

Normalize bands in a cube

Description
Categories
Groups
History


Description

The program accomplishes the fairly straightforward task of taking an input cube and outputting normalized values.

Normalization may be done with respect to each band or the entire cube. If the user were to normalize by band, the program would take a pass through the data in order to determine the average of each band. Bandnorm will then pass through each band again and normalize each one based on the average of the given band. If normalizing by the entire cube, the first pass would compute the average of the cube, and the second pass would normalize each band using this average. Bandnorm can use a text file as the input for the average value of each band.


Categories


Related Objects and Documents

Applications


Parameter Groups

Files

Name Description
FROM Input cube
TO Output cube

Normalization option

Name Description
AVERAGEDirection in which statistics and operations operate
SPECTRUMSpectral Pencil
METHODThe mothod used to determine desired column
NUMBERSpecifies column used by number
NAMESpecifies column used by name

Files: FROM

Description

This file will be the input cube that gets normalized.

Type cube
File Mode input
Filter *.cub

Files: TO

Description

Output file that will be created using average values from the input cube to normalize.

Type cube
File Mode output

Normalization option: AVERAGE

Description

This is the the average to be used during normalization. If the user chooses to use band averages, they intend to take in an entire band of data and normalize based on the average of that band for each pixel in that band. If they choose to use the average from the entire cube, they intend to take in an entire cube of data and normalize each pixel in each band based on the average of the entire cube. If they choose pencil, they intend to use a file containing the averages of each band to normalize each pixel in correlating band. This file is best obtained using Qview's plot tool.

Type string
Default BAND
Option List:
Option Brief Description
BANDDivide by Band Average Get the average of each band separately to use in the normalization

Exclusions

  • SPECTRUM
  • METHOD
  • NUMBER
  • NAME
CUBEDivide by Cube Average Get the average of the entire cube to use in the normailization

Exclusions

  • SPECTRUM
  • METHOD
  • NUMBER
  • NAME
PENCILDivide by Spectral Pencil Use the given file as the source of the values used to normalize each band separately.

Inclusions

  • SPECTRUM
  • METHOD
  • NUMBER
  • NAME

Normalization option: SPECTRUM

Description

The file with the spectrum data for each band to be normalized with. It assumes this file was aquired using Qview's plot tool. The first line of the spectrum file MUST be composed of titles, and the following lines MUST be the data desired (in most cases the average) of each band in sequential order, starting with the first band. Extra lines are ignored.

Type filename
File Mode input
Filter *.txt *.lis

Normalization option: METHOD

Description

The method used to determine the correct data column of the spectrum file wished to be used in creating the normalized cube.

Type string
Default BYNAME
Option List:
Option Brief Description
BYNUMBERSpecify the column of the spectrum file to be used by column number Allows one to specify by column number within the given spectrum file, the column data to be used to create the normalized cube.

Exclusions

  • NAME

Inclusions

  • NUMBER
BYNAMESpecify the column of the spectrum file to be used by column name The name of the column within the specified spectrum file, used to create the normalized cube.

Exclusions

  • NUMBER

Inclusions

  • NAME

Normalization option: NUMBER

Description

Allows one to specify by column number within the given spectrum file, the column data to be used to create the normalized cube.

Type integer
Default 1

Normalization option: NAME

Description

Allows one to specify by column name within the given spectrum file, the column data to be used to create the normalized cube.

Type string
Default Average

History

Elizabeth Miller2006-07-18 Original version
Chris Austin2007-12-27 Added Spectral Pencil option.
Chris Austin2008-01-23 Modified Spectral Pencil option to be more flexible with the structure of its Spectral files, namely, allowing for more than one column, and specifying which column to use durring normilization.
Steven Lambright2008-05-12 Removed references to CubeInfo
Kimberly Oyama2013-05-22 Cleaned up memory so bandnorm runs correctly with batchlists. Fixes #754.