stats

This program computes a set of statistics for the pixels in each selected band of an image cube, and outputs the results of each band. By default, all bands are processed. The stats program generates statistics that will help you find new insights in your data to make more accurate predictions and achieve better outcomes.

Histogram Computation

Stats uses a histogram to compute the mode and median DN values for a given cube. The minimum, maximum, and number of bins depends on the pixel type of the cube. Here are the minimum, maximum, and number of bins associated with supported pixel types:

Output:

The statistics are output to both the screen and the print.prt file in PVL format. Additionally, if the user specifies a file using the TO parameter, the statistics are written to that file in PVL format (default) or as a comma delimited text file (FLAT file), as specified by the FORMAT parameter. For multi-band images, each band has its own statistics information that will be appended to the output file. The contents of the PVL file can be read using the getkey program. The comma delimited text file can be imported into Excel or other applications. The statistics calculated and reported are as follows:

      Average                 Total pixels

      Standard deviation      Valid pixels

      Variance                Over valid maximum pixels

      Median                  Under valid minimum pixels

      Mode                    Null pixels

      Skew                    Low representation saturation (LRS) pixels

      Minimum                 High representation saturation (HRS) pixels

      Maximum                 Low instrument saturation (LIS) pixels

      Sum                     High instrument saturation (HIS) pixels
    

If the output file exists and the APPEND parameter is set to "no," the contents will be overwritten.

How to Specify Bands:

You may process one or a few specific bands if you indicate the band(s) in which you desire to gather statistics. A band may be specified by simply placing a plus sign and the band number after the input filename (e.g., peaks.cub+3). For several bands, commas and hyphens are used to communicate effectively with the program as in the following example: peaks.cub+2,4-6.

Description

This specifies the input cube. The default is to calculate statistics for each band in the input cube, but this can be overridden using the band specifier (e.g., file.cub+3).

Description

This text file will contain the statistics for each individual band. If it is written in PVL format (default), the values can be read using the getkey program. This is useful for developing scripts. If it is written as a comma delimited text file (FLAT) the output can be easily imported into spreadsheet applications like Excel.

Description

This is the format type for the output file. PVL format is the default. The format is ignored unless the TO parameter is specified.

Description

If this option is not selected, the output from the stats application is appended to the output file. If this option is set to "NO" or "FALSE," any information in the TO file is overwritten.

Note: This will append the formatted results to the end of the TO file without regard to the formatting of the current contents.

Description

The statistics will exclude any DN values below this value.

Description

The statistics will exclude any DN values above this value.