Scroll to navigation

IMAGESTATISTICS(1) User Commands IMAGESTATISTICS(1)

NAME

ImageStatistics - get image statistics

SYNOPSIS

astimgstat [OPTION...] ASTRdata

DESCRIPTION

ImageStatistics is part of GNU Astronomy Utilities 0.2.33-8a3b. ImageStatistics will print the basic statistics of the input image pixel flux distribution. All blank pixels or pixels specified by a mask image will be ignored.

For more information, please run any of the following commands. They will respectively show you the `Invoking ImageStatistics' subsection, the complete `ImageStatistics' section, or the full GNU Astronomy Utilities manual. In particular the first contains a very complete explanation of each option.

info astimgstat
info ImageStatistics
info gnuastro

If you couldn't find your answer in the manual, you can get direct help from experienced Gnuastro users and developers. For more information, please run:

info help-gnuastro

ImageStatistics options:

Input:
Distance beyond mirror point. Multiple of std.
Extension name or number of input data.
Mask image header name.
Mask image file name.
Ignore data with values equal to minimum.
Output:
Do not show an ASCII histogram of the data.
Shift bins so one bin starts on this value.
Mode mirror plot. `_modehist.txt', `_modecfp.txt'
Don't delete output if it exists.
Use input histogram range for mirror plots.
Do not remove input's dir info for output.
Interval lower limit for column 1.
Distance beyond mode to display.
Mirror quantile. `_mirhist.txt', `_mircfp.txt'.
Output file or directory name.
Histogram (suffix: `_hist.txt'):
The minimum value for the histogram.
Scale such that the maximum bin has value of one.
Do not calculate histogram.
Normalize the histogram (sum of all bins 1).
Number of bins in the histogram.
Quantile (Q) range. Histogram from Q to 1-Q.
The maximum value for the histogram.
Cumulative Frequency Plot (suffix: `_cfp.txt'):
Minimum value to use in the CFP.
Maximum value to use in the CFP.
Set CFP range and bins similar to histogram.
Set maximum of CFP to maximum of histogram.
No Cumulative Frequency Plot.
Normalize the CFP (sum of all bins 1).
Number of data points to find CFP.
Quantile of range: from U to 1-U.
Sigma clipping:
Number of times to do sigma clipping.
Do not preform sigma clipping.

-t, --sigcliptolerance=FLT Difference in STD tolerance to halt iteration.

Multiple of standard deviation in sigma-clipping.
Operating modes:
-?, --help
give this help list
BibTeX citation for ImageStatistics.
No log file for programs which make one.
Number of CPU threads to use.
Only read current directory configuration file.
Only run if the program version is this.
Print parameter values to be used and abort.
Only report errors, remain quiet about steps.
Set default values for this user and abort.
Set default values for this directory and abort.
give a short usage message
print program version

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/

AUTHOR

Written by Mohammad Akhlaghi

REPORTING BUGS

Report bugs to bug-gnuastro@gnu.org.

COPYRIGHT

Copyright © 2015-2016, Free Software Foundation, Inc. License GPLv3+: GNU General public license version 3 or later.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

The full documentation for ImageStatistics is maintained as a Texinfo manual. If the info and ImageStatistics programs are properly installed at your site, the command

info ImageStatistics

should give you access to the complete manual.

October 2016 GNU Astronomy Utilities 0.2.33-8a3b