/usr/share/doc/stilts/sun256/plot.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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Old-Style Plotting</title>
</head>
<body>
<hr>
<a href="plotSuffixes.html">Next</a> <a href="graphicExporter.html">Previous</a> <a href="index.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="plotSuffixes.html">Parameter Suffixes</a><br>
<b>Up: </b><a href="index.html">Top</a><br>
<b>Previous: </b><a href="graphicExporter.html">Export Formats</a><br>
<hr>
<hr>
<h2><a name="plot">9 Old-Style Plotting</a></h2>
<p><em>This section describes deprecated commands.
For recommended plotting commands, see <a href="plot2.html">Section 8</a>.
</em></p>
<p>From version 2.0 (October 2008), STILTS incorporated three table
plotting commands:
<ul>
<li><a href="plot2d.html"><code>plot2d</code></a>: Old-style 3D Scatter Plot
</li>
<li><a href="plot3d.html"><code>plot3d</code></a>: Old-style 3D Scatter Plot
</li>
<li><a href="plothist.html"><code>plothist</code></a>: Old-style Histogram
</li>
</ul>
These provided command-line access to some, though not all,
of the plotting capabilities offered by TOPCAT.
</p>
<p>Since version 3.0 (October 2014), these commands are deprecated
in favour of the more powerful ones described in <a href="plot2.html">Section 8</a>.
The rest of this section describes some aspects of the deprecated
commands for the benefit of legacy code.
The output modes and formats are the same in old- and new-style plots,
and are discussed in <a href="paintMode.html">Section 8.5</a> and <a href="graphicExporter.html">Section 8.6</a>.
The handling of parameters and suffixes for these commands
is not quite the same as for new-style plots,
and is documented in the next subsection.
</p>
<p>As a simple example,
if a file "cat.fits" contains the columns RMAG and BMAG for red and
blue magnitudes,
you can draw a two-dimensional colour-magnitude scatter plot with
the command:
<pre>
stilts plot2d in=cat.fits xdata=BMAG-RMAG ydata=BMAG
</pre>
Since an output file is not specified, the plot is shown on the screen for
convenience. To send the output to a PNG file, do instead:
<pre>
stilts plot2d in=cat.fits xdata=BMAG-RMAG ydata=BMAG out=plot.png ofmt=png
</pre>
in some cases (including the above), the <code>ofmt</code> parameter is not
required since STILTS may be able to guess the format from the output
file name.
Various other options for output and graphics formats are described in
<a href="paintMode.html">Section 8.5</a> and <a href="graphicExporter.html">Section 8.6</a>
</p>
<p>Some of the parameters use suffixes to define data sets and
therefore behave a bit differently
from the parameters elsewhere in STILTS - a discussion of these
is given in <a href="plotSuffixes.html">the following subsection</a>.
Some other plotting-specific topics are also discussed below.
</p>
<ul>
<li><a href="plotSuffixes.html">9.1 Parameter Suffixes</a></li>
</ul>
<hr><a href="plotSuffixes.html">Next</a> <a href="graphicExporter.html">Previous</a> <a href="index.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="plotSuffixes.html">Parameter Suffixes</a><br>
<b>Up: </b><a href="index.html">Top</a><br>
<b>Previous: </b><a href="graphicExporter.html">Export Formats</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>
|