Content-type: text/html Manpage of VOTPOS

VOTPOS

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

NAME

votpos - Extract the main positional columns from a VOTable

SYNOPSIS

votpos [-opts] votable.xml

OPTIONS

The votpos task accepts the following options:

-h, --help: Print a help summary to the terminal and exit. No processing is done following this flag.
-n, --number Print the row number before the position.
-o NAME, --output NAME: Write the result to the file NAME.

DESCRIPTION

The votpos task is used to extract the positional information from a VOTable. The columns identified by the UCD POS_EQ_RA_MAIN and POS_EQ_DEC_MAIN (or UCD+ values pos.eq.ra;meta.main and pos.eq.dec;meta.main) are located automatically and will be written as a two-column ascii table to the stdout, or to the file named by the -o flag. An error will be printed if no columns with these specific UCDs are found.

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. In a multi-resource VOTABLE only the first <RESOURCE> table will be processed.

RETURN STATUS

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

EXAMPLES

1) Print the primary (RA,Dec) columns from a table:

  % votpos test.xml             # un-numbered
  % votpos -n test.xml          # numbered
  % cat test.xml | votpos       # un-numbered

2) Print the primary (RA,Dec) columns to a file:

  % votpos -o pos.txt test.xml

BUGS

- No known bugs with this release.

- The task should have options to specify columns to extract when no UCDs are available.

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:27 GMT, April 14, 2013