NAME

fitsstats - compute statistics ( avg, max, median, min, sum ) on FITS files.


SYNOPSIS

fitsstats [ --range | -r [start]:[end] or [start]/count ] [ --Stats | -S median ] [-- output | -o foo.fits ] [ --sort ] -- @filename | files


OPTIONS

Options may be abbreviated. Options which take values may be separated from their values either by white space or the = character. If some arguments begin with a dash, then a double dash must preceed the file list.

The options are :

@filename | directory
The command line argument, without any option flag, is used to entered the FITS files to perform the statistics on. If the command line argument begins with a '@' symbol followed by a filename, then the content of the file shall be used as the file entries.

For example, if all the FITS file in the directory /pool1/mydir are to be used, then type the following line:

 fitsstats /pool1/mydir/*.fits

The user can select a specific number of files by entering the files, with full pathname, in a file. For example, if the file myfile contains the following entries:

 /pool1/mydir/a.fits
 /pool1/mydir/b.fits
 /pool1/mydir/c.fits
 /pool1/mydir/d.fits

then enter the following command:

 fitsstats @myfile

--usage
Print this help information and exit. For example:
 fitsstats --usage

--help
Print a short information and exit. For example:
 fitsstats --help

or

 fitsstats -h

--memory available memory
The maximum amount of memory available to run the program, in units of MegaBytes, allocated for the program. default setting is 128MB.

--output The output filename
The output filename, default is stdout.

For example to write the output to a file called foobar.fits, type:

 fitsstats --output foobar.fits -- /pool1/mydir/*.fits

or

 fitsstats -o foobar.fits -- /pool1/mydir/*.fits

--range [start]{`:'}[end] or [start]{`/'}count
where start and end are optional limits on the range, and count specifies the number of elements in a range. In the first form, if start or end is missing, 0 or infinity is implied. In the second form, if start is missing, the range starts at 1 if no previous range was specified, or directly follows the end of the previous range.

More than one range may be specified

         r1,r2,r3

--sort
To sort, lexicographically, the files from the command line.

--Stats avg|max|median|min|sum
The statistics perform on the FITS files, default is median.

For example, to calculate the minimum of all the files in the directory /pool1/mydir/, type:

 fitsstats --Stats min -- /pool1/mydir/*.fits

or

 fitsstats -S min -- /pool1/mydir/*.fits

--version
Print the program version and exit. For example:
 fitsstats --version