.\" @(#)votstat.1 1.0 Feb-2013 MJF .TH VOTSTAT 1 "Feb 2013" "VOClient Package" .SH NAME votstat \- Compute statistics for numeric columns of a VOTable. .SH SYNOPSIS \fBvotstat\fP [\fI-opts\fP] votable.xml .SH OPTIONS The \fIvotstat\fP task accepts the following options: .TP 6 .B \-h, --help Print a help summary to the terminal and exit. No processing is done following this flag. .TP 6 .B \-a,--all Print all columns, but only compute statistics for the numeric columns. .TP 6 .B \-o \fINAME\fP,--output \fINAME\fP Output name of sorted file, if not specified results are written to stdout. .TP 6 .B \-n,--noheader Suppress header information for formats other than XML and FITS. .SH DESCRIPTION The \fIvotstat\fP task is used to compute statistics for columns of a table. Output is written to the stdout unless the \fI-o\fP flag is used to name a specific output file. If the \fI-a\fP flag is used, all columns are printed but only the statistics of numeric columns is computed. If no input file is specified the VOTable will be read from the stdin, results will be written to stdout unless the \fI\-o\fP (or \fI\--output\fP) names an output file. The task will only process a single VOTable and may not be used to convert multiple files in a single call. .SH RETURN STATUS On exit the \fBvotstat\fP task will return a zero indicating success, or a one indicating an error. .SH EXAMPLES .TP 4 1) Print statistics for a VOTable .nf % votstat test.xml .fi .TP 4 2) Print statistics for all column in a VOTable and save results to a file. .nf % votsort -a -o stats test.xml .fi .SH BUGS The task should have a way to select specific columns or request specific values. .SH Revision History Feb 2013 - First public release .SH Author Michael Fitzpatrick (fitz@noao.edu), Feb 2013 .SH "SEE ALSO" votget, votinfo, votcnv, votpos, votstat