blob: abe52cbcf41012e6a226b54b9ee69b4dbeef8f5d (
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
.help colbyucd Mar12 votools
.ih
NAME
colbyucd -- Identify VOTable column by UCD attribute
.ih
USAGE
colbyucd input ucd
.ih
PARAMETERS
.ls input
The input VOTable.
.le
.ls ucd
The UCD attribute name
.le
.ls column = 0
Found column number (1-indexed, or -1 if not found)
.le
.ls id = ""
Value of the ID attribute for the found column.
.le
.ls name = ""
Value of the NAME attribute for the found column.
.le
.ls print = no
Print column field number?
.le
.ls found = no
Was column found in table?
.le
.ih
DESCRIPTION
The \fICOLBYUCD\fR task is used to find the column in a VOTable with the
named \fIUCD\fR attribute value of a table column. This attribute is not
generally guaranteed to be unique within a table and so the task will print
a warning if multiple values are found, but only the first value found will
be saved.
If a column with the specified attribute is found, the \fIcolumn\fR parameter
will be the one-indexed column number and the \fIfound\fR parameter will
be set, otherwise the \fIcolumn\fR value will be '-1'. If the column is
found, the \fIid\fR and \fIname\fR values will be filled in with the
corresponding attributes for that column or the null string.
If the \fIprint\fR parameter is set, the column number will be printed to the
standard output.
.ih
EXAMPLES
1. Find the column in the table where the 'ucd' attribute is 'RA' in a
VOTable document:
.nf
votools> colbyucd vodata$usno-b.xml POS_EQ_RA_MAIN print+
2
votools> colbyucd http://iraf.noao.edu/votest/usno-b.xml POS_EQ_RA_MAIN print+
2
votools> colbyucd file:///<path>/usno-b.xml POS_EQ_RA_MAIN print+
2
votools> colbyucd file:///localhost/<path>/usno-b.xml POS_EQ_RA_MAIN print+
2
.fi
Or when a parameter is not found:
.nf
votools> colbyucd vodata$usno-b.xml FOO print+
-1
.fi
If a matching column is found in the table, the task parameters may be
queried for additional information:
.nf
votools> =colbyucd.column
2
votools> =colbyucd.found
yes
votools> =colbyid.ucd
POS_EQ_RA_MAIN
votools> =colbyucd.name
RA
.fi
.ih
REVISIONS
.le
.ih
SEE ALSO
colbyid, colbyname
.endhelp
|
