MAN page from Mandrake Other gnuplot-3.5-9.i386.rpm

GNUPLOT

Section: User Commands (1)
Updated: 31 August 1990
Index

NAME

gnuplot - an interactive plotting program

SYNOPSIS

gnuplot[ X11 options ] [file ...]

DESCRIPTION

Gnuplotis a command-driven interactive function plotting program.

If files are given,gnuplotloads each file with theloadcommand, in the order specified.Gnuplotexits after the last file is processed.

Here are some of its features:

Plots any number of functions, built up of C operators, C libraryfunctions, and some things C doesn't have like **, sgn(), etc. Alsosupport for plotting data files, to compare actualdata to theoretical curves.

User-defined X and Y ranges (optional auto-ranging), smart axes scaling,smart tic marks.

Labelling of X and Y axes.

User-defined constants and functions.

Support through a generalized graphics driver forAED 512,AED 767,BBN BitGraph,Commodore Amiga,Roland DXY800A,EEPIC,TeXDraw,EmTeX,Epson 60dpi printers,Epson LX-800,Fig,HP2623,HP2648,HP75xx,HPGL,HP LaserJet II,Imagen,Iris 4D,MS-DOS Kermit,Kyocera laser printer,LaTeX,NEC CP6 pinwriter,PostScript,QMS QUIC,ReGis (VT125 and VT2xx),SCO Xenix CGI,Selanar,Star color printer,Tandy DMP-130 printer,Tek 401x,Tek 410x,Vectrix 384,VT like Tektronix emulator,Unix PC (ATT 3b1 or ATT 7300),unixplot,and X11.The PC version compiled by Microsoft Csupports IBM CGA, EGA, VGA, Hercules, ATT 6300,and Corona 325 graphics.The PC version compiled by Borland C++supports IBM CGA, EGA, MCGA, VGA, Hercules and ATT 6300 graphics.Other devices can be added simply, but will require recompiling.

Shell escapes and command line substitution.

Load and save capability.

Output redirection.

All computations performed in the complex domain. Just the real part isplotted by default, but functions like imag() and abs() and arg() areavailable to override this.

X11 OPTIONS

Gnuplotprovides the x11 terminal type for usewith X servers. This terminal type is set automatically at startup ifthe DISPLAY environment variable is set, if the TERM environmentvariable is set to xterm, or if the -display command lineoption is used.For terminal type x11, gnuplotaccepts the standard X Toolkit options and resources such as geometry, font,and background. See the X(1) man page for a description ofthe options.In addition to the X Toolkit options:

-mono forces monochrome rendering on color displays.

-gray requests grayscale rendering on grayscale or color displays.(Grayscale displays receive monochrome rendering by default.)

-clear requests that the window be cleared momentarily before anew plot is displayed.

-tvtwm requests that geometry specificationsfor position of the window be made relative to the currently displayedportion of the virtual root.

These options may also be controlled with resources in your .Xdefaultsfile.For example: gnuplot*gray: on .

Gnuplot provides a command line option (-pointsize v) anda resource (gnuplot*pointsize: v) to control the size of pointsplotted with the "points" plotting style. The value v is a realnumber (greater than 0 and less than or equal to ten) used as ascaling factor for point sizes. For example, -pointsize 2 usespoints twice the default size, and -pointsize 0.5 uses pointshalf the normal size.

For monochrome displays, gnuplot does not honor foreground orbackground colors. The default is black-on-white. -rv orgnuplot*reverseVideo: on requests white-on-black.

For color displays gnuplot honorsthe following resources (shown here with default values). The valuesmay be color names in the X11 rgb.txt file on your system, hexadecimalRGB color specifications (see X11 documentation), or a color namefollowed by a comma and an intensity value from 0 to 1. For example,blue,.5 means a half intensity blue.

gnuplot*background: white
gnuplot*textColor: black
gnuplot*borderColor: black
gnuplot*axisColor: black
gnuplot*line1Color: red
gnuplot*line2Color: green
gnuplot*line3Color: blue
gnuplot*line4Color: magenta
gnuplot*line5Color: cyan
gnuplot*line6Color: sienna
gnuplot*line7Color: orange
gnuplot*line8Color: coral

When -gray is selected, gnuplot honorsthe following resources for grayscale or color displays (shown here withdefault values). Note that the default background is black.

gnuplot*background: black
gnuplot*textGray: white
gnuplot*borderGray: gray50
gnuplot*axisGray: gray50
gnuplot*line1Gray: gray100
gnuplot*line2Gray: gray60
gnuplot*line3Gray: gray80
gnuplot*line4Gray: gray40
gnuplot*line5Gray: gray90
gnuplot*line6Gray: gray50
gnuplot*line7Gray: gray70
gnuplot*line8Gray: gray30

Gnuplot honors the following resources for setting the width inpixels of plot lines (shown here with default values.) 0 or 1 meansa minimal width line of 1 pixel width. A value of 2 or 3 mayimprove the appearance of some plots.

gnuplot*borderWidth: 2
gnuplot*axisWidth: 0
gnuplot*line1Width: 0
gnuplot*line2Width: 0
gnuplot*line3Width: 0
gnuplot*line4Width: 0
gnuplot*line5Width: 0
gnuplot*line6Width: 0
gnuplot*line7Width: 0
gnuplot*line8Width: 0

Gnuplot honors the following resources for setting the dash styleused for plotting lines. 0 means a solid line. A 2 digit number jk(j and k are >= 1 and <= 9) means a dashed line with arepeated pattern of j pixels on followed by k pixels off.For example, '16' is a "dotted" line with 1 pixel on followed by 6 pixelsoff. More elaborate on/off patterns can be specified with a 4 digit value.For example, '4441' is 4 on, 4 off, 4 on, 1 off. The default values shownbelow are for monochrome displays or monochrome rendering on color orgrayscale displays. For color displays, the defaults for all are 0(solid line) except for axisDashes which defaults to a '16' dottedline.

gnuplot*borderDashes: 0
gnuplot*axisDashes: 16
gnuplot*line1Dashes: 0
gnuplot*line2Dashes: 42
gnuplot*line3Dashes: 13
gnuplot*line4Dashes: 44
gnuplot*line5Dashes: 15
gnuplot*line6Dashes: 4441
gnuplot*line7Dashes: 42
gnuplot*line8Dashes: 13

The size or aspect ratio of a plot may be changed by resizing thegnuplotwindow.

AUTHORS

Thomas Williams, Pixar Corporation,
(info-gnuplotAATTdartmouth.edu)
and Colin Kelley.

Additions for labelling by Russell Lang, Monash University, Australia.
(rjlAATTmonu1.cc.monash.edu.au)
Further additions by David Kotz, Dartmouth College, New Hampshire, USA(formerly of Duke University, North Carolina, USA).
(David.KotzAATTDartmouth.edu)

BUGS

The atan() function does not work correctly for complex arguments.
The bessel functions do not work for complex arguments.
See thehelp bugscommand in gnuplot.

This document was created byman2html,using the manual pages.