Content-type: text/html Manpage of VOTSTAT

VOTSTAT

Section: User Commands (1)
Updated: Feb 2013
Index Return to Main Contents

NAME

votstat - Compute statistics for numeric columns of a VOTable.

SYNOPSIS

votstat [-opts] votable.xml

OPTIONS

The votstat task accepts the following options:

-h, --help

Print a help summary to the terminal and exit. No processing is done following this flag.

-a,--all

Print all columns, but only compute statistics for the numeric columns.

-o NAME,--output NAME

Output name of sorted file, if not specified results are written to stdout.

-n,--noheader

Suppress header information for formats other than XML and FITS.

DESCRIPTION

The votstat task is used to compute statistics for columns of a table. Output is written to the stdout unless the -o flag is used to name a specific output file. If the -a 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 -o (or --output) 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.

RETURN STATUS

On exit the votstat task will return a zero indicating success, or a one indicating an error.

EXAMPLES

1) Print statistics for a VOTable

  % votstat test.xml

2) Print statistics for all column in a VOTable and save results to a file.

  % votsort -a -o stats test.xml

BUGS

The task should have a way to select specific columns or request specific values.

Revision History

Feb 2013 - First public release

Author

Michael Fitzpatrick (fitz@noao.edu), Feb 2013

This document was created by man2html, using the manual pages.
Time: 05:13:28 GMT, April 14, 2013