Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search

USGS

Isis 3 Application Documentation


stats

Printer Friendly View | TOC | Home

Generates statistics about a cube

Overview Parameters Example 1

Description

This program computes statistics for the pixels in a single band. If the band specification (e.g., file.cub:3) is not given the program will default to the first band. The statistics calculated include:
        Average
        Standard deviation
        Variance
        Median
        Mode
        Skew
        Minimum
        Maximum
        Total pixels
        Valid pixels
        Null pixels
        Low instrument saturation pixels
        Low representation saturation pixels
        High instrument saturation pixels
        High representation saturation pixels
The statistics will be output to the logging device. Additionally, if the user specifies a file using the TO parameter, the statistics be written to the file in a standard label format which can then be read using the getkey proram.

Categories


Related Applications in Previous Versions of Isis

This application replaces the following applications existing in previous versions of Isis, which have been deprecated from the current version of Isis:
  • average
  • avg_sd
  • bandstats

History

Jeff Anderson2002-06-17 Original version written as "histo"
Stuart Sides2002-07-24 Changed name to "stats" and added logging mechanism
Jeff Anderson2002-12-30 Added TO parameter which allows the user to create an output file that can be read using the getkey program
Jeff Anderson2002-12-30 Tested for bands which contain only special pixels in order to prevent divide by zero errors.
Jeff Anderson2002-12-31 Added the name of the input cube to the log and label file
Kim Sides2003-05-13 Added application test
Stuart Sides2003-05-16 Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides2003-05-30 Made changes to application test truth files to reflect -O1 optimization
Stuart Sides2003-05-30 Added modifications to apptest by Kim
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Stuart Sides2003-11-07 Modified results pvl to not include the results group
Jacob Danton2006-01-23 Fixed appTest to comply to changes in iString
Steven Lambright2008-05-06 Added Above Range, Below Range reports
Steven Lambright2008-05-13 Removed references to CubeInfo
Steven Lambright2008-08-15 A bug where the VALIDMIN,VALIDMAX were ignored was fixed; these should always be used.

Parameter Groups

Files

Name Description
FROM Single band of a cube to get statistics from
TO Output file to contain statistics

Settings

Name Description
VALIDMIN Minimum DN valid to count as valid
VALIDMAX Maximum DN valid to count as valid
X

Files: FROM


Description

The file specification for the input cube. The statistics will be calculated for one band only. The default band is one but can be overridden using the band specifier (e.g., file.cub:3).

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

Files: TO


Description

This ascii file will contain the statistics of the individual band. It is written in such a format that the values can be read using the getkey program. This is useful for when developing scripts.

Type filename
File Mode output
Internal Default No Output file will be created
Filter *.txt
Close Window
X

Settings: VALIDMIN


Description

The statistics will exclude any DN values below this value

Type double
Internal Default No minimum DN value
Close Window
X

Settings: VALIDMAX


Description

The statistics will exclude any DN values above this value

Type double
Internal Default No maximum DN value
Close Window

Example 1

Calculating statistics for a band in a cube

Description

This example shows the statistics gathered from a single band of a cube.

Command Line

stats from=peaks.cub:3 > peaks3_stats.log
Running stats in the command line mode with the only parameter "FROM" set to the third band of the cube peaks.cub.

Data File

Links open in a new window.
Output from stats This is the output captured in "peaks3_stats.log" by the redirection of standard out.