Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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.12.  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
       either directly ask for certain statistics in one line/row as shown be-
       low  with  the same order as requested, or get tables of	different sta-
       tistical	measures like the histogram, cumulative	 frequency  style  and
       etc.  If	 no  particular	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 par-
       ticular the second contains a very comprehensive	explanation of Statis-
       tics'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 name or number if input is	a table.

       -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.

       -l, --lessthan=FLT
	      Only use values less than	this.

       -Q, --qrange=FLT[,FLT]
	      Quantile range: one (from	Q to 1-Q) or two.

       -r, --refcol=STR
	      Reference	column name or number.

       --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.

       -i, --interpolate
	      Interpolate over blank tiles to fill them.

       --interpmetric=INT
	      Interpolation metric (radial, manhattan).

       --interpnumngb=INT
	      No. of neighbors to use for interpolation.

       --interponlyblank
	      Only interpolate over the	blank tiles.

       -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.

       -o, --output=STR
	      Output file name.

       --tableformat=STR
	      Table fmt: 'fits-ascii', 'fits-binary', 'txt'.

	      Single value measurements

       -d, --std
	      Standad deviation.

       -E, --median
	      Median.

       --maximum
	      Maximum.

       --minimum
	      Minimum.

       -m, --mean
	      Mean.

       --modequant
	      Mode quantile (see --mode)

       --modesym
	      Mode symmetricity	(see --mode).

       --modesymvalue
	      Value at mode symmetricity (see --mode).

       --number
	      Number (non-blank).

       -O, --mode
	      Mode (Appendix C of arXiv:1505.01664).

       --quantfunc=FLT[,...]
	      Quantile function	(multiple values acceptable).

       --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.

       -H, --histogram
	      Save the histogram in output.

       --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

       --checksky
	      Store steps in '_sky_steps.fits' file.

       --ignoreblankintiles
	      Don't write input's blanks in the	tiled output.

       -k, --kernel=STR
	      File name	of kernel to convolve input.

       --khdu=STR
	      HDU/extension name or number of kernel.

       --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.

       -n, --normalize
	      Set sum of all bins to 1.

       --onebinstart=FLT
	      Shift bins so one	bin starts on this value.

	      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.

       --lastconfig
	      Do not parse any more configuration files.

       --minmapsize=INT
	      Minimum bytes in array to	not use	ram RAM.

       -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.

       -q, --quiet
	      Only report errors, remain quiet about steps.

       --quietmmap
	      Don't print mmap'd file's	name and size.

       -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
       optional	for any	corresponding short options.

       GNU Astronomy Utilities home  page:  http://www.gnu.org/software/gnuas-
       tro/

REPORTING BUGS
       Report bugs to bug-gnuastro@gnu.org.

COPYRIGHT
       Copyright  (C)  2015-2020,  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 man-
       ual.  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.12	   May 2020			 STATISTICS(1)

NAME | SYNOPSIS | DESCRIPTION | REPORTING BUGS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=aststatistics&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help