radecbox - Search an starbase data table catalog for targets in an ra dec specified box.
SYNOPSYS
radecbox file ra dec width
PARAMETERS
- file
- Input catalog to search, this file must have ra and dec columns.
If the search parameter not set to "row" the input file must be
be a real file (not a pipe) and be numericly indexed on the ra
column. The ra column should be in units
of hours and the dec column should be in units of degrees.
- ra
- Right Ascension of the center of the search box in hours.
- dec
- Declination of the center of the search box in degrees.
- width
- Width of the search box in degrees.
- height
- Height of the search box in hours. This parameter is optional and the
height is computed from the width for create a square box on the sky if
the height is omitted.
- rcol
- The column name of the ra column defaults to "ra".
- dcol
- The column name of the dec column defaults to "dec".
- search
- The search method to use. Three search methods are
implemented. The default method is "fast"
- row
- The search is done sequentially with a single "row" command.
- fast
- The an initial search command is executed for the range of
ras. The ra column of the input file must be indexed. The
results of this search are passed to row and filtered on the
dec range. This method is excellent when retrieving a small
number of rows (<1000) from large datasets.
- debug
- Control debug output. The default is debug=0. When debug=1
the commands that will be executec are printed out on the
standard error instead. When debug=2 the commands are printed
and executed.
SEE ALSO
- radecbox.src
- Source text of radecbox.
- radeccirc
- Search an starbase data table catalog for targets in an ra dec specified circle.
- slalink.1
- programs available with the slalink extensions to tawk.
- starbase.1
- starbase data tables introduction.
- tablefun.3
- starbase data table included functions.