01.02.2014 Views

GNUPlot Manual

GNUPlot Manual

GNUPlot Manual

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

72 gnuplot 4.0 36 SET-SHOW<br />

{height }<br />

{{no}autotitles}<br />

{title ""} {{no}enhanced}<br />

{{no}box { {linestyle | ls }<br />

| {linetype | lt }<br />

{linewidth | lw }}}<br />

unset key<br />

show key<br />

By default the key is placed in the upper right corner of the graph. The keywords left, right, top,<br />

bottom, outside and below may be used to place the key in the other corners inside the graph or to<br />

the right (outside) or below the graph. They may be given alone or combined.<br />

Plots may be drawn with no visible key by requesting set key off or unset key.<br />

Justification of the labels within the key is controlled by Left or Right (default is Right). The text<br />

and sample can be reversed (reverse) and a box can be drawn around the key (box {...}) in a specified<br />

linetype and linewidth, or a user-defined linestyle. Note that not all terminal drivers support<br />

linewidth selection, though.<br />

The length of the sample line can be controlled by samplen. The sample length is computed as the sum<br />

of the tic length and times the character width. samplen also affects the positions of<br />

point samples in the key since these are drawn at the midpoint of the sample line, even if the sample<br />

line itself is not drawn.<br />

The vertical spacing between lines is controlled by spacing. The spacing is set equal to the product of<br />

the pointsize, the vertical tic size, and . The program will guarantee that the vertical<br />

spacing is no smaller than the character height.<br />

The is a number of character widths to be added to or subtracted from the length<br />

of the string. This is useful only when you are putting a box around the key and you are using control<br />

characters in the text. gnuplot simply counts the number of characters in the string when computing<br />

the box width; this allows you to correct it.<br />

The is a number of character heights to be added to or subtracted from the height<br />

of the key box. This is useful mainly when you are putting a box around the key, otherwise it can be<br />

used to adjust the vertical shift of automatically chosen key position by /2.<br />

All plotted curves of plots and splots are titled according to the default option autotitles. The<br />

automatic generation of titles can be suppressed by noautotitles; then only those titles explicitly<br />

defined by (s)plot ... title ... will be drawn.<br />

A title can be put on the key (title "") — see also syntax (p. 26) for the distinction between<br />

text in single- or double-quotes. The key title uses the same justification as do the plot titles.<br />

An explicitly given title is typeset using enhanced text properties on terminals supporting this, see<br />

enhanced text (p. 127) for more details. This default behavior can be switched off by the noenhanced<br />

option.<br />

The defaults for set key are on, right, top, Right, noreverse, samplen 4, spacing 1.25, title "",<br />

and nobox. The default is the same as that used for the plot borders. Entering set key<br />

default returns the key to its default configuration.<br />

The can be a simple x,y,z as in previous versions, but these can be preceded by one of four<br />

keywords (first, second, graph, screen) which selects the coordinate system in which the position of<br />

the first sample line is specified. See coordinates (p. 18) for more details.<br />

The key is drawn as a sequence of lines, with one plot described on each line. On the right-hand side<br />

(or the left-hand side, if reverse is selected) of each line is a representation that attempts to mimic the<br />

way the curve is plotted. On the other side of each line is the text description (the line title), obtained<br />

from the plot command. The lines are vertically arranged so that an imaginary straight line divides the<br />

left- and right-hand sides of the key. It is the coordinates of the top of this line that are specified with<br />

the set key command. In a plot, only the x and y coordinates are used to specify the line position. For<br />

a splot, x, y and z are all used as a 3-d location mapped using the same mapping as the graph itself to<br />

form the required 2-d screen position of the imaginary line.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!