/usr/share/doc/pyxplot/html/sec-legends.html is in pyxplot-doc 0.8.4-3.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta name="generator" content="plasTeX" />
<meta content="text/html; charset=utf-8" http-equiv="content-type" />
<title>PyXPlot Users' Guide: Graph Legends</title>
<link href="sect0053.html" title="Configuring Axes" rel="next" />
<link href="ex-trefoil.html" title="Two-dimensional parametric surfaces" rel="prev" />
<link href="ch-plotting.html" title="Plotting: A Detailed Survey" rel="up" />
<link rel="stylesheet" href="styles/styles.css" />
</head>
<body>
<div class="navigation">
<table cellspacing="2" cellpadding="0" width="100%">
<tr>
<td><a href="ex-trefoil.html" title="Two-dimensional parametric surfaces"><img alt="Previous: Two-dimensional parametric surfaces" border="0" src="icons/previous.gif" width="32" height="32" /></a></td>
<td><a href="ch-plotting.html" title="Plotting: A Detailed Survey"><img alt="Up: Plotting: A Detailed Survey" border="0" src="icons/up.gif" width="32" height="32" /></a></td>
<td><a href="sect0053.html" title="Configuring Axes"><img alt="Next: Configuring Axes" border="0" src="icons/next.gif" width="32" height="32" /></a></td>
<td class="navtitle" align="center">PyXPlot Users' Guide</td>
<td><a href="index.html" title="Table of Contents"><img border="0" alt="" src="icons/contents.gif" width="32" height="32" /></a></td>
<td><a href="sect0255.html" title="Index"><img border="0" alt="" src="icons/index.gif" width="32" height="32" /></a></td>
<td><img border="0" alt="" src="icons/blank.gif" width="32" height="32" /></td>
</tr>
</table>
</div>
<div class="breadcrumbs">
<span>
<span>
<a href="index.html">PyXPlot Users' Guide</a> <b>:</b>
</span>
</span><span>
<span>
<a href="sect0043.html">Plotting and Vector Graphics</a> <b>:</b>
</span>
</span><span>
<span>
<a href="ch-plotting.html">Plotting: A Detailed Survey</a> <b>:</b>
</span>
</span><span>
<span>
<b class="current">Graph Legends</b>
</span>
</span>
<hr />
</div>
<div><h1 id="sec:legends">1.7 Graph Legends</h1>
<p> <a name="a0000000749" id="a0000000749"></a><a name="a0000000750" id="a0000000750"></a> </p><p>By default, plots are displayed with legends in their top-right corners. The textual description of each dataset is auto-generated from the command used to plot it. Alternatively, the user may specify his own description for each dataset by following the <tt class="tt">plot</tt> command with the <tt class="tt">title</tt><a name="a0000000751" id="a0000000751"></a> modifier, as in the following examples: </p><pre>
plot sin(x) title 'A sine wave'
plot cos(x) title ''
</pre><p>In the latter case a blank title is specified, which indicates to PyXPlot that no entry should be made for the dataset in the legend. This allows for legends which contain only a subset of the datasets on a plot. Alternatively, the production of the legend can be completely turned off for all datasets using the command <tt class="tt">set nokey</tt><a name="a0000000752" id="a0000000752"></a>. Having issued this command, the production of keys can be resumed using the <tt class="tt">set key</tt> command<a name="a0000000753" id="a0000000753"></a>. </p><p>The <tt class="tt">set key</tt> command<a name="a0000000754" id="a0000000754"></a> can also be used to dictate how legends should be positioned on graphs, using a syntax along the lines of: </p><pre>
set key top right
</pre><p>The following recognised positional keywords are self-explanatory: <tt class="tt">top</tt><a name="a0000000755" id="a0000000755"></a>, <tt class="tt">bottom</tt><a name="a0000000756" id="a0000000756"></a>, <tt class="tt">left</tt><a name="a0000000757" id="a0000000757"></a>, <tt class="tt">right</tt><a name="a0000000758" id="a0000000758"></a>, <tt class="tt">xcentre</tt><a name="a0000000759" id="a0000000759"></a> and <tt class="tt">ycentre</tt><a name="a0000000760" id="a0000000760"></a>. Any single instance of the <tt class="tt">set key</tt> command<a name="a0000000761" id="a0000000761"></a> can be followed by one horizontal alignment keyword and one vertical alignment keyword; these keywords also affect the justification of the legend – for example, the keyword <tt class="tt">left</tt><a name="a0000000762" id="a0000000762"></a> aligns the legend with its left edge against the left edge of the plot. </p><p>Alternatively, the position of the legend can be indicated using one of the keywords <tt class="tt">outside</tt><a name="a0000000763" id="a0000000763"></a>, <tt class="tt">below</tt><a name="a0000000764" id="a0000000764"></a> or <tt class="tt">above</tt><a name="a0000000765" id="a0000000765"></a>. These cannot be combined with the horizontal and vertical alignment keywords above, and are used to indicate that the legend should be placed, respectively, outside the plot on its right side, centred beneath the plot, and centred above the plot. </p><p>Two comma-separated positional offset coordinates may be specified following any of the named positions listed above to fine-tune the position of the legend – the first value is assumed to be a horizontal offset and the second a vertical offset. Either may have units of length, or, if they are dimensionless, are assumed to be measured in centimetres, as the following examples demonstrate: </p><pre>
set key bottom left 0.0 -2
set key top xcentre 2*unit(mm),2*unit(mm)
</pre><p>By default, entries in the legend are automatically sorted into an appropriate number of columns. The number of columns to be used, can, instead, be stipulated using the <tt class="tt">set keycolumns</tt> command<a name="a0000000766" id="a0000000766"></a>. This should be followed by either the integer number of desired columns, or by the keyword <tt class="tt">auto</tt> to indicate that the default behaviour of automatic formatting should be resumed: </p><pre>
set keycolumns 2
set keycolumns auto
</pre></div>
<div class="navigation">
<table cellspacing="2" cellpadding="0" width="100%">
<tr>
<td><a href="ex-trefoil.html" title="Two-dimensional parametric surfaces"><img alt="Previous: Two-dimensional parametric surfaces" border="0" src="icons/previous.gif" width="32" height="32" /></a></td>
<td><a href="ch-plotting.html" title="Plotting: A Detailed Survey"><img alt="Up: Plotting: A Detailed Survey" border="0" src="icons/up.gif" width="32" height="32" /></a></td>
<td><a href="sect0053.html" title="Configuring Axes"><img alt="Next: Configuring Axes" border="0" src="icons/next.gif" width="32" height="32" /></a></td>
<td class="navtitle" align="center">PyXPlot Users' Guide</td>
<td><a href="index.html" title="Table of Contents"><img border="0" alt="" src="icons/contents.gif" width="32" height="32" /></a></td>
<td><a href="sect0255.html" title="Index"><img border="0" alt="" src="icons/index.gif" width="32" height="32" /></a></td>
<td><img border="0" alt="" src="icons/blank.gif" width="32" height="32" /></td>
</tr>
</table>
</div>
<script language="javascript" src="icons/imgadjust.js" type="text/javascript"></script>
</body>
</html>
|