/usr/share/doc/stilts/sun256/secB.33.2.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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Examples</title>
</head>
<body>
<hr>
<a href="tmultin.html">Next</a> <a href="tmulti-usage.html">Previous</a> <a href="tmulti.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmultin.html">tmultin: Writes multiple processed tables to single container file</a><br>
<b>Up: </b><a href="tmulti.html">tmulti: Writes multiple tables to a single container file</a><br>
<b>Previous: </b><a href="tmulti-usage.html">Usage</a><br>
<hr>
<h3><a name="secB.33.2">B.33.2 Examples</a></h3>
<p>Here are some examples of using <code>tmulti</code>:
<dl>
<dt><strong><pre>
stilts tmulti ifmt=ascii in=t1.txt in=t2.txt in=t3.txt
ofmt=fits out=tables.fits
</pre></strong></dt>
<dd>Takes the three named ASCII format tables and writes them into a
multi-extension FITS file, as three separate BINTABLE HDUs.
These tables do not need to be of the same shape or otherwise similar.
</dd>
<dt><strong><pre>
stilts tmulti ifmt=ascii in="t1.txt t2.txt t3.txt"
ofmt=fits out=tables.fits
</pre></strong></dt>
<dd>Does exactly the same as the previous example.
</dd>
<dt><strong><pre>
stilts tmulti ifmt=ascii in=@inlist.lis
ofmt=fits out=tables.fits
</pre></strong></dt>
<dd>This will have the same effect as the previous two examples if a
file name "inlist.lis" in the current directory contains three lines,
"t1.txt", "t2.txt" and "t3.txt".
</dd>
<dt><strong><pre>
stilts tmulti in=extract.fits multi=true out=extract.vot
</pre></strong></dt>
<dd>This takes the table extensions from a multi-extension FITS file
and writes them out as a multi-TABLE VOTable document.
The <code>multi=true</code> setting is required, since this means
that all the tables from the input file are used as input;
if it was set false, only the first table HDU from the input file
would be used.
</dd>
<dt><strong><pre>
stilts tmulti in=extract.fits multi=true out=extract.vot
icmd='badval -999 *MAG'
</pre></strong></dt>
<dd>Does the same as the previous example, but additionally replaces
with a blank value occurrences of the value "-999" in columns
whose name ends with "MAG" in any of the input tables before
copying them.
</dd>
</dl>
</p>
<hr><a href="tmultin.html">Next</a> <a href="tmulti-usage.html">Previous</a> <a href="tmulti.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmultin.html">tmultin: Writes multiple processed tables to single container file</a><br>
<b>Up: </b><a href="tmulti.html">tmulti: Writes multiple tables to a single container file</a><br>
<b>Previous: </b><a href="tmulti-usage.html">Usage</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>
|