/usr/share/doc/stilts/sun256/sec5.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 78 79 80 81 82 83 84 85 86 87 88 89 90 91 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Table Formats</title>
</head>
<body>
<hr>
<a href="inFormats.html">Next</a> <a href="location-syntax.html">Previous</a> <a href="io.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="inFormats.html">Input Formats</a><br>
<b>Up: </b><a href="io.html">Table I/O</a><br>
<b>Previous: </b><a href="location-syntax.html">Table Locations</a><br>
<hr>
<h3><a name="sec5.2">5.2 Table Formats</a></h3>
<p>The generic table commands in STILTS
(currently <a href="tpipe.html"><code>tpipe</code></a>,
<a href="tcopy.html"><code>tcopy</code></a>,
<a href="tmulti.html"><code>tmulti</code></a>,
<a href="tmultin.html"><code>tmultin</code></a>,
<a href="tcat.html"><code>tcat</code></a>,
<a href="tcatn.html"><code>tcatn</code></a>,
<a href="tloop.html"><code>tloop</code></a>,
<a href="tjoin.html"><code>tjoin</code></a>,
<a href="tcube.html"><code>tcube</code></a>,
<a href="tmatch1.html"><code>tmatch1</code></a>,
<a href="tmatch2.html"><code>tmatch2</code></a>,
<a href="tmatchn.html"><code>tmatchn</code></a>,
<a href="tskymap.html"><code>tskymap</code></a>,
<a href="tskymatch2.html"><code>tskymatch2</code></a>,
<a href="pixfoot.html"><code>pixfoot</code></a>,
<a href="pixsample.html"><code>pixsample</code></a>,
<a href="plot2cube.html"><code>plot2cube</code></a>,
<a href="plot2plane.html"><code>plot2plane</code></a>,
<a href="plot2sky.html"><code>plot2sky</code></a>,
<a href="plot2sphere.html"><code>plot2sphere</code></a>,
<a href="plot2time.html"><code>plot2time</code></a>,
<a href="plot2d.html"><code>plot2d</code></a>,
<a href="plot3d.html"><code>plot3d</code></a>,
<a href="plothist.html"><code>plothist</code></a>,
<a href="cdsskymatch.html"><code>cdsskymatch</code></a>,
<a href="coneskymatch.html"><code>coneskymatch</code></a>,
<a href="sqlskymatch.html"><code>sqlskymatch</code></a>,
<a href="tapquery.html"><code>tapquery</code></a>,
<a href="tapresume.html"><code>tapresume</code></a>,
<a href="tapskymatch.html"><code>tapskymatch</code></a> and
<a href="regquery.html"><code>regquery</code></a>)
have no native format for table storage, they can process
data in a number of formats equally well.
STIL has its own model of what a table
consists of, which is basically:
<ul>
<li>Some per-table metadata (parameters)</li>
<li>A number of columns</li>
<li>Some per-column metadata</li>
<li>A number of rows, each containing one entry per column</li>
</ul>
Some table formats have better facilities for storing this sort of
thing than others, and when performing conversions STILTS does
its best to translate between them, but it can't perform the
impossible: for instance there is nowhere in a Comma-Separated Values
file to store descriptions of column units,
so these will be lost when converting from VOTable to CSV formats.
</p>
<p>The formats the package knows about are dependent on the input and
output handlers currently installed. The ones installed by default
are listed in the following subsections. More may be added in the
future, and it is possible to install new ones at runtime - see
the <a href="http://www.starlink.ac.uk/stil/sun252/">STIL documentation</a> for details.
</p>
<p>Some formats can be used to hold multiple tables in a single file,
and others can only hold a single table per file.
</p>
<ul>
<li><a href="inFormats.html">5.2.1 Input Formats</a></li>
<li><a href="outFormats.html">5.2.2 Output Formats</a></li>
</ul>
<hr><a href="inFormats.html">Next</a> <a href="location-syntax.html">Previous</a> <a href="io.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="inFormats.html">Input Formats</a><br>
<b>Up: </b><a href="io.html">Table I/O</a><br>
<b>Previous: </b><a href="location-syntax.html">Table Locations</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>
|