/usr/share/doc/stilts/sun256/sec1.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 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Introduction</title>
</head>
<body>
<hr>
<a href="debian.html">Next</a> <a href="abstract.html">Previous</a> <a href="index.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="debian.html">Debian specific changes</a><br>
<b>Up: </b><a href="index.html">Top</a><br>
<b>Previous: </b><a href="abstract.html">Abstract</a><br>
<hr>
<hr>
<h2><a name="sec1">1 Introduction</a></h2>
<p>STILTS provides a number of command-line applications which can
be used for manipulating tabular data.
Conceptually it sits between, and uses many of the same classes as,
the packages
<a href="http://www.starlink.ac.uk/stil/">STIL</a>,
which is a set of Java APIs providing table-related functionality, and
<a href="http://www.starlink.ac.uk/topcat">TOPCAT</a>,
which is a graphical application providing the user with
an interactive platform for exploring one or more tables.
This document is mostly self-contained - it covers some of the
same ground as the STIL and TOPCAT user documents
(<a href="http://www.starlink.ac.uk/stil/sun252/">SUN/252</a> and <a href="http://www.starlink.ac.uk/topcat/sun253/">SUN/253</a> respectively).
</p>
<p>Currently, this package consists of commands in the following categories:
<dl>
<dt><strong>Generic table manipulation</strong></dt>
<dd>
<a href="tcopy.html"><code>tcopy</code></a>,
<a href="tpipe.html"><code>tpipe</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> and
<a href="tcube.html"><code>tcube</code></a>
(see <a href="pipes.html">Section 6</a>).
</dd>
<dt><strong>Crossmatching</strong></dt>
<dd>
<a href="tmatch1.html"><code>tmatch1</code></a>,
<a href="tmatch2.html"><code>tmatch2</code></a>,
<a href="tmatchn.html"><code>tmatchn</code></a> and
<a href="tskymatch2.html"><code>tskymatch2</code></a>
(see <a href="match.html">Section 7</a>).
</dd>
<dt><strong>Plotting</strong></dt>
<dd>
<a href="plot2plane.html"><code>plot2plane</code></a>,
<a href="plot2sky.html"><code>plot2sky</code></a>,
<a href="plot2cube.html"><code>plot2cube</code></a>,
<a href="plot2sphere.html"><code>plot2sphere</code></a> and
<a href="plot2time.html"><code>plot2time</code></a>
(also deprecated old-style plot commands
<a href="plot2d.html"><code>plot2d</code></a>,
<a href="plot3d.html"><code>plot3d</code></a> and
<a href="plothist.html"><code>plothist</code></a>)
(see <a href="plot2.html">Section 8</a>).
</dd>
<dt><strong>Sky Pixel Operations</strong></dt>
<dd>
<a href="tskymap.html"><code>tskymap</code></a>,
<a href="pixfoot.html"><code>pixfoot</code></a> and
<a href="pixsample.html"><code>pixsample</code></a>.
</dd>
<dt><strong>VOTable</strong></dt>
<dd>
<a href="votcopy.html"><code>votcopy</code></a> and
<a href="votlint.html"><code>votlint</code></a>.
</dd>
<dt><strong>Virtual Observatory access</strong></dt>
<dd>
<a href="cdsskymatch.html"><code>cdsskymatch</code></a>,
<a href="coneskymatch.html"><code>coneskymatch</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>,
<a href="taplint.html"><code>taplint</code></a> and
<a href="regquery.html"><code>regquery</code></a>.
</dd>
<dt><strong>SQL databases</strong></dt>
<dd>
<a href="sqlclient.html"><code>sqlclient</code></a>,
<a href="sqlupdate.html"><code>sqlupdate</code></a> and
<a href="sqlskymatch.html"><code>sqlskymatch</code></a>.
</dd>
<dt><strong>Miscellaneous</strong></dt>
<dd>
<a href="calc.html"><code>calc</code></a>,
<a href="funcs.html"><code>funcs</code></a> and
</dd>
</dl>
See <a href="classified.html">Appendix A</a> for an expanded version of this list.
</p>
<p>There are many ways you might want to use these tools;
here are a few possibilities:
<dl>
<dt><strong>In conjunction with TOPCAT</strong></dt>
<dd>you can identify a set of processing steps using TOPCAT's interactive
graphical facilities, and construct a script using the commands
provided here which can perform the same steps on many
similar tables without further user intervention.
</dd>
<dt><strong>Format conversion</strong></dt>
<dd>If you have a separate table processing engine and you want to
be able to output the results in a somewhat different form,
for instance converting it from FITS to VOTable or from
TABLEDATA-encoded to BINARY-encoded VOTable, or to perform
some more scientifically substantial operation such as
changing units or coordinate systems, substituting bad values etc,
you can pass the results through one of the tools here.
Since on the whole operation is streaming, such conversion can
easily and efficiently be done on the fly.
</dd>
<dt><strong>Server-side operations</strong></dt>
<dd>The tools provided here are suitable for use on servers, either
to generate files as part of a web service (perhaps along the
lines of the <b>Format conversion</b> item above)
or as configurable components in a server-based workflow system.
The <a href="server.html"><code>server</code></a> command may help,
but is not required, for use in these situations.
</dd>
<dt><strong>Quick look</strong></dt>
<dd>You might want to examine the metadata, or a few rows,
or a statistical summary of a table
without having to load the whole thing into TOPCAT or some other
table viewer application.
</dd>
</dl>
</p>
<ul>
<li><a href="debian.html">1.1 Debian specific changes</a></li>
</ul>
<hr><a href="debian.html">Next</a> <a href="abstract.html">Previous</a> <a href="index.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="debian.html">Debian specific changes</a><br>
<b>Up: </b><a href="index.html">Top</a><br>
<b>Previous: </b><a href="abstract.html">Abstract</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>
|