Isis 3 Application Documentation
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:
History
| Jeff Anderson | 2002-06-17 |
Original version written as "histo"
|
| Stuart Sides | 2002-07-24 |
Changed name to "stats" and added logging mechanism
|
| Jeff Anderson | 2002-12-30 |
Added TO parameter which allows the user to create an output file that can
be read using the getkey program
|
| Jeff Anderson | 2002-12-30 |
Tested for bands which contain only special pixels in order to prevent
divide by zero errors.
|
| Jeff Anderson | 2002-12-31 |
Added the name of the input cube to the log and label file
|
| Kim Sides | 2003-05-13 |
Added application test
|
| Stuart Sides | 2003-05-16 |
Modified schema location from astogeology... to isis.astrogeology..."
|
| Stuart Sides | 2003-05-30 |
Made changes to application test truth files to reflect -O1 optimization
|
| Stuart Sides | 2003-05-30 |
Added modifications to apptest by Kim
|
| Stuart Sides | 2003-07-29 |
Modified filename parameters to be cube parameters where necessary
|
| Stuart Sides | 2003-11-07 |
Modified results pvl to not include the results group
|
| Jacob Danton | 2006-01-23 |
Fixed appTest to comply to changes in iString
|
| Steven Lambright | 2008-05-06 |
Added Above Range, Below Range reports
|
| Steven Lambright | 2008-05-13 |
Removed references to CubeInfo
|
| Steven Lambright | 2008-08-15 |
A bug where the VALIDMIN,VALIDMAX were ignored was fixed;
these should always be used.
|
| Stacy Alley | 2009-01-16 |
Added the Format option for the output file.
|
|
Parameter Groups
Files
|
Name
|
Description
|
| FROM |
Single band of a cube to get statistics from
|
| TO |
Output file to contain statistics
|
| FORMAT |
Output Format
|
| APPEND |
Append Output to File
|
Settings
|
Name
|
Description
|
| VALIDMIN |
Minimum DN valid to count as valid
|
| VALIDMAX |
Maximum DN valid to count as valid
|
|
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
|
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
|
Files:
APPEND
Description
If this option is selected, the output from the application will be appended to the file.
If it is not selected, any information in the TO file will be overwritten.
|
Type
| boolean |
|
Default
| TRUE |
Settings:
VALIDMIN
Description
The statistics will exclude any DN values below this value
|
Type
| double |
|
Internal Default
|
No minimum DN value
|
Settings:
VALIDMAX
Description
The statistics will exclude any DN values above this value
|
Type
| double |
|
Internal Default
|
No maximum DN value
|
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.
|
|