FreeBSD Manual Pages
STATISTICS(1) User Commands STATISTICS(1) NAME Statistics - calculate statistics of a dataset SYNOPSIS aststatistics [OPTION...] ASTRdata DESCRIPTION Statistics is part of GNU Astronomy Utilities 0.24. Statistics will do statistical analysis on the input dataset (table column or image). All blank pixels or pixels outside of the given range are ignored. You can ei- ther directly ask for certain statistics in one line/row as shown below with the same order as requested, or get tables of different statistical measures like the histogram, cumulative frequency style and etc. If no par- ticular statistic is requested, some basic information about the dataset is printed on the command-line. For more information, please run any of the following commands. In particu- lar the second contains a very comprehensive explanation of Statistics's invocation: expected input(s), output(s), and a full description of all the options. All options and their values: $ aststatistics -P Inputs/Outputs and options: $ info aststatistics Full section in manual/book: $ info Statistics Full Gnuastro manual/book: $ 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 Statistics options: Input: -c, --column=STR Column number (counting from 1) or search string. --greaterequal2=FLT Upper range of 2nd dim in 2D histograms. -g, --greaterequal=FLT Only use values greater-equal than this. -h, --hdu=STR/INT Extension name or number of input data. -I, --ignorecase Ignore case in matching/searching columns. --lessthan2=FLT Lower range of 2nd dim in 2D histograms. -l, --lessthan=FLT Only use values less than this. -Q, --qrange=FLT[,FLT] Quantile range: one (from Q to 1-Q) or two. --searchin=STR Select column(s): 'name', 'unit', 'comment'. --stdintimeout=INT Micro-seconds to wait for standard input. Tessellation (tile grid): --checktiles Tile IDs in an image, the size of input. -F, --remainderfrac=FLT Fraction of remainder to split last tile. --interpmetric=STR Interpolation metric (radial, manhattan). --interpnumngb=INT No. of neighbors to use for interpolation. --interponlyblank Only interpolate over the blank tiles. -i, --interpolate Interpolate over blank tiles to fill them. -M, --numchannels=INT[,..] No. of channels in dim.s (FITS order). --oneelempertile Display 1 element/tile, not full input res. --workoverch Work (not tile) over channel edges. -Z, --tilesize=INT[,INT] Regular tile size on dim.s (FITS order). Output: -D, --dontdelete Don't delete output if it exists. -K, --keepinputdir Keep input directory for automatic output. --outfitsnocommit No Git commit in 0-th HDU of output FITS. --outfitsnoconfig No metadata in 0-th HDU of output FITS. --outfitsnodate No 'DATE' in 0-th HDU of output FITS. --outfitsnoversions No versions in 0-th HDU of output FITS. -o, --output=STR Output file name. --tableformat=STR Table fmt: 'fits-ascii', 'fits-binary', 'txt'. --wcslinearmatrix=STR WCS linear matrix of output ('pc' or 'cd'). Single value measurements --concentration=FLT[,...] Uniform dist: 1.0; higher: concentrated. -d, --std Standad deviation. -E, --median Median. --mad Median absolute deviation. --madclip-mad MAD-clipped Median Absolute Deviation. --madclip-mean MAD-clipped mean. --madclip-median MAD-clipped median. --madclip-number Number of elements after MAD-clipping. --madclip-std MAD-clipped standard deviation. --maximum Maximum. --minimum Minimum. --modequant Mode quantile (see --mode) --modesym Mode symmetricity (see --mode). --modesymvalue Value at mode symmetricity (see --mode). -m, --mean Mean. --number Number (non-blank). -O, --mode Mode (Appendix C of arXiv:1505.01664). --quantfunc=FLT[,...] Quantile function (multiple values acceptable). --quantofmean Quantile of the mean. --sigclip-mad Sigma-clipped Median Absolute Deviation. --sigclip-mean Sigma-clipped mean. --sigclip-median Sigma-clipped median. --sigclip-number Number of elements after sigma-clipping. --sigclip-std Sigma-clipped standard deviation. --sum Sum. -u, --quantile=FLT[,...] Quantile (multiple values acceptable). Particular calculation --asciicfp Print an ASCII cumulative frequency plot. -A, --asciihist Print an ASCII histogram. -C, --cumulative Save the cumulative frequency plot in output. --histogram2d=STR 2D histogram (as 'table' or 'image'). -H, --histogram Save the histogram in output. --madclip Overall MAD-clipping (see '--mclipparams') --mirror=FLT Save the histogram and CFP of the mirror dist. -R, --contour=STR Contour levels, save in PGFPlots format. -s, --sigmaclip Overall sigma-clipping (see '--sclipparams') -t, --ontile Single values on separate tiles, not full input. -y, --sky Find the Sky and its STD over the tessellation. Sky and Sky STD settings -a, --outliernumngb=INT Num neighboring tiles to look for outlier. --checksky Store steps in '_sky_steps.fits' file. --checkskynointerp Similar to --checksky, stops at interpolation. --ignoreblankintiles Don't write input's blanks in the tiled output. --khdu=STR HDU/extension name or number of kernel. -k, --kernel=FITS File name of kernel to convolve input. --mclipparams=FLT,FLT MAD clip: Multiple, and tolerance/number. --meanmedqdiff=FLT Max. mode and median quantile diff. per tile. --mirrordist=FLT Max. distance (error multip.) to find mode. --outliersclip=FLT,FLT Sigma-clip params for qthresh outliers. --outliersigma=FLT Multiple of sigma to define outliers. --sclipparams=FLT,FLT Sigma clip: Multiple, and tolerance/number. --smoothwidth=INT Sky: flat kernel width to smooth interpolated. Histogram and CFP settings --asciiheight=INT Height of ASCII histogram or CFP plots. --manualbinrange Set min/max of bins manually, not from data. --maxbinone Scale such that the maximum bin has value of one. --numasciibins=INT No. of bins in ASCII histogram or CFP plots. --numbins=INT No. of bins in histogram or CFP tables. --numbins2=INT No. of bins in second-dim of 2D histogram. -n, --normalize Set sum of all bins to 1. --onebinstart=FLT Shift bins so one bin starts on this value. --onebinstart2=FLT Similar to --onebinstart, for 2D histogram Fitting (1 and 2 dimensional) --fitestimate=STR/FLT Estimate fitted func. (number, file or 'self'). --fitestimatecol=STR/INT Column containing the --fitestimate values. --fitestimatehdu=STR/INT HDU containing the --fitestimate values. --fitrobust=STR The robust function name to use. --fitweight=STR Input weight: 'std', 'var' or 'inv-variance'. -f, --fit=STR Type of fitting: 'linear', 'linear-weighted', 'linear-no-constant', 'linear-no-constant-weighted', 'polynomial', 'polynomial-weighted', 'polynomial-robust'. -p, --fitmaxpower=INT Maximum power in polynomial to fit. Operating modes: -?, --help give this help list --checkconfig List all config files and variables read. --cite BibTeX citation for this program. --config=STR Read configuration file STR immediately. --config-prefix=STR Custom prefix of option names config files. --lastconfig Do not parse any more configuration files. --minmapsize=INT Min. bytes to avoid RAM automatically. -N, --numthreads=INT Number of CPU threads to use. --onlyversion=STR Only run if the program version is STR. -P, --printparams Print parameter values to be used and abort. --quietmmap Don't print mmap'd file's name and size. -q, --quiet Only report errors, remain quiet about steps. -S, --setdirconf Set default values for this directory and abort. --usage give a short usage message -U, --setusrconf Set default values for this user and abort. -V, --version print program version Mandatory or optional arguments to long options are also mandatory or op- tional for any corresponding short options. GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/ REPORTING BUGS Report bugs to bug-gnuastro@gnu.org. COPYRIGHT Copyright (C) 2015-2025 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. Written/developed by Mohammad Akhlaghi SEE ALSO The full documentation for Statistics is maintained as a Texinfo manual. If the info and Statistics programs are properly installed at your site, the command info Statistics should give you access to the complete manual. GNU Astronomy Utilities 0.24 November 2025 STATISTICS(1)
NAME | SYNOPSIS | DESCRIPTION | REPORTING BUGS | COPYRIGHT | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=aststatistics&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>