aboutsummaryrefslogtreecommitdiff
path: root/vo/votools/doc/taboverlay.hlp
blob: c69722bda08113bdcc75d5432e2491afc6e6219a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
.help taboverlay Mar12 votools
.ih
NAME
taboverlay -- General table overlay in the image display
.ih
USAGE
taboverlay image catalog
.ih
PARAMETERS
.ls image
The input image.
.le
.ls catalog
The input catalog.
.le
.ls labcol = 1
Label column number (one-indexed).
.le
.ls racol = 2
RA column number (one-indexed).
.le
.ls deccol =3INDEF
Dec column number (one-indexed).
.le
.ls mkcolor = 208
Marker color index to use.
.le
.ls status = 0
Status of the service.  A non-zero value indicates no results were found.
.le

.ih
DESCRIPTION

The \fITABOVERLAY\fR task is used to overlay a catalog of positions on 
the image display.  The input catalog file is assumed to be an ascii
table of the form (index,ra,dec) however the \fIracol\fR, \fIdeccol\fR and
\fIlabcol\fR parameters can be used to select columns from tables containing
more information.  Markers will be drawn using the color specified by the
\fImkcolor\fR parameter.

.ih
EXAMPLES
1. Query for catalog positions of NGC188 and extract the (numbered) position
columns to the file 'ngc188.pos'.  Then display an image of the field and
overlay the catalog positions.

.nf
  votools> getcat gsc2.3 ngc188 size=0.1 output="ngc188.xml"
  votools> votpos ngc188.xml number+ out="ngc188.pos"
  votools> dss ngc188
  votools> taboverlay ngc188 ngc188.pos
.fi

.ih
REVISIONS
.
.ih
SEE ALSO
getcat, getimg
.endhelp