/usr/share/doc/stilts/sun256/col-id.html is in stilts-doc 3.1.2-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Specifying a Single Column</title>
</head>
<body>
<hr>
<a href="colid-list.html">Next</a> <a href="uniq.html">Previous</a> <a href="pipes.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="colid-list.html">Specifying a List of Columns</a><br>
<b>Up: </b><a href="pipes.html">Table Pipelines</a><br>
<b>Previous: </b><a href="uniq.html">uniq</a><br>
<hr>
<h3><a name="col-id">6.2 Specifying a Single Column</a></h3>
<p>If an argument is specified in the help text for a
command with the symbol <code><col-id></code>
it means you must give a string which identifies one of the
existing columns in a table.
</p>
<p>There are three ways you can specify a column in this context:
<dl>
<dt><strong>Column Name</strong></dt>
<dd>The name of the column may be used if it contains no spaces
and doesn't start with a minus character ('<code>-</code>').
It is usually matched case insensitively. If multiple columns
have the same name, the first one that matches is selected.
</dd>
<dt><strong>Column Index or $ID</strong></dt>
<dd>The index of the column may always be used; this is a useful
fallback if the column name isn't suitable for some reason.
The first column is '1', the second is '2' and so on.
You may alternatively use the forms
'$1', '$2' etc.
<p>Tip: if counting which column has which index is giving you a
headache, running <code>tpipe</code> with <code>omode=meta</code> or
<code>omode=stats</code> on the table may help.
</p>
</dd>
<dt><strong>Column ucd$ specifier</strong></dt>
<dd>If the column has a
<a href="http://www.ivoa.net/Documents/latest/UCD.html">Unified Content Descriptor</a>
(this will usually only be the case for VOTable or possibly FITS format
tables) you can refer to it using an identifier of the form
"<code>ucd$<ucd-spec></code>". Depending on the version of
UCD scheme used, UCDs can contain various punctuation marks such
as underscores, semicolons and dots; for the purpose of this syntax
these should all be represented as underscores ("<code>_</code>").
So to identify a column which has the UCD "<code>phot.mag;em.opt.R</code>",
you should use the identifier "<code>ucd$phot_mag_em_opt_r</code>".
Matching is not case-sensitive. Futhermore, a trailing underscore
acts as a wildcard, so that the above column could also be referenced
using the identifier "<code>ucd$phot_mag_</code>". If multiple
columns have UCDs which match the given identifer, the first one
will be used.
</dd>
<dt><strong>Column utype$ specifier</strong></dt>
<dd>If the column has a <b>Utype</b>
(this will usually only be the case for VOTable or possibly FITS format
tables) you can refer to it using an identifier of the form
"<code>utype$<utype-spec></code>".
Utypes may contain various punctuation marks such as colons and dots;
for the purpose of this syntax these should all be represented as
underscores ("<code>_</code>").
So to identify a column which has the Utype
"<code>ssa:Access.Format</code>",
you should use the identifier
"<code>utype$ssa_Access_format</code>".
Matching is not case-sensitive.
If multiple columns have Utypes which match the given identifier,
the first one will be used.
</dd>
</dl>
</p>
<hr><a href="colid-list.html">Next</a> <a href="uniq.html">Previous</a> <a href="pipes.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="colid-list.html">Specifying a List of Columns</a><br>
<b>Up: </b><a href="pipes.html">Table Pipelines</a><br>
<b>Previous: </b><a href="uniq.html">uniq</a><br>
<hr><i>STILTS - Starlink Tables Infrastructure Library Tool Set<br>Starlink User Note256<br>STILTS web page:
<a href="http://www.starlink.ac.uk/stilts/">http://www.starlink.ac.uk/stilts/</a><br>Author email:
<a href="mailto:m.b.taylor@bristol.ac.uk">m.b.taylor@bristol.ac.uk</a><br>Mailing list:
<a href="mailto:topcat-user@jiscmail.ac.uk">topcat-user@jiscmail.ac.uk</a><br></i></body>
</html>
|