1GNUPLOT(1)                  General Commands Manual                 GNUPLOT(1)
2
3
4

NAME

6       gnuplot - an interactive plotting program
7

SYNOPSIS

9       gnuplot [ X11 options ] [file ...]
10

DESCRIPTION

12       Gnuplot is a command-driven interactive function plotting program.
13
14       If  files  are given, gnuplot loads each file with the load command, in
15       the order specified.  Gnuplot exits after the last file is processed.
16
17       Here are some of its features:
18
19       Plots any number of functions, built up of C operators, C library func‐
20       tions,  and  some things C doesn't have like **, sgn(), etc.  Also sup‐
21       port for plotting data files, to compare  actual  data  to  theoretical
22       curves.
23
24       User-defined  X  and Y ranges (optional auto-ranging), smart axes scal‐
25       ing, smart tic marks.
26
27       Labelling of X and Y axes.
28
29       User-defined constants and functions.
30
31       Support for many output devices and file formats
32
33       Shell escapes and command line substitution.
34
35       Load and save capability.
36
37       Output redirection.
38
39       All computations performed in the complex domain.  Just the  real  part
40       is  plotted  by  default, but functions like imag() and abs() and arg()
41       are available to override this.
42

X11 OPTIONS

44       Gnuplot provides the x11 terminal type for use  with  X  servers.  This
45       terminal  type  is set automatically at startup if the DISPLAY environ‐
46       ment variable is set, if the TERM environment variable is set to xterm,
47       or if the -display command line option is used.  For terminal type x11,
48       gnuplot accepts the standard X Toolkit options and  resources  such  as
49       geometry, font, and background. See the X(1) man page for a description
50       of the options.  In addition to the X Toolkit options:
51
52       -clear requests that the window be cleared  momentarily  before  a  new
53       plot is displayed.
54
55       -gray  requests  grayscale  rendering  on  grayscale or color displays.
56       (Grayscale displays receive monochrome rendering by default.)
57
58       -mono forces monochrome rendering on color displays.
59
60       -persist lets plot windows survive after main gnuplot program exits.
61
62       -raise raises the plot window after each plot.
63
64       -noraise does not raise the plot window after each plot.
65
66       -tvtwm requests that geometry specifications for position of the window
67       be  made  relative  to  the  currently displayed portion of the virtual
68       root.
69
70       These options may also be controlled with resources in your  .Xdefaults
71       file.  For example: gnuplot*gray: on .
72
73       Gnuplot  provides  a  command line option (-pointsize v) and a resource
74       (gnuplot*pointsize: v) to control the size of points plotted  with  the
75       "points"  plotting  style. The value v is a real number (greater than 0
76       and less than or equal to ten) used  as  a  scaling  factor  for  point
77       sizes.  For  example,  -pointsize 2 uses points twice the default size,
78       and -pointsize 0.5 uses points half the normal size.
79
80       For monochrome displays, gnuplot does not  honor  foreground  or  back‐
81       ground  colors. The default is black-on-white. -rv or gnuplot*reverseV‐
82       ideo: on requests white-on-black.
83
84       For color displays gnuplot honors the following resources  (shown  here
85       with  default values). The values may be color names in the X11 rgb.txt
86       file on your system, hexadecimal RGB color specifications (see X11 doc‐
87       umentation), or a color name followed by a comma and an intensity value
88       from 0 to 1. For example, blue,.5 means a half intensity blue.
89
90       gnuplot*background: white
91       gnuplot*textColor: black
92       gnuplot*borderColor: black
93       gnuplot*axisColor: black
94       gnuplot*line1Color: red
95       gnuplot*line2Color: green
96       gnuplot*line3Color: blue
97       gnuplot*line4Color: magenta
98       gnuplot*line5Color: cyan
99       gnuplot*line6Color: sienna
100       gnuplot*line7Color: orange
101       gnuplot*line8Color: coral
102
103       When -gray is selected, gnuplot  honors  the  following  resources  for
104       grayscale or color displays (shown here with default values). Note that
105       the default background is black.
106
107       gnuplot*background: black
108       gnuplot*textGray: white
109       gnuplot*borderGray: gray50
110       gnuplot*axisGray: gray50
111       gnuplot*line1Gray: gray100
112       gnuplot*line2Gray: gray60
113       gnuplot*line3Gray: gray80
114       gnuplot*line4Gray: gray40
115       gnuplot*line5Gray: gray90
116       gnuplot*line6Gray: gray50
117       gnuplot*line7Gray: gray70
118       gnuplot*line8Gray: gray30
119
120       Gnuplot honors the following resources for setting the width in  pixels
121       of  plot lines (shown here with default values.) 0 or 1 means a minimal
122       width line of 1 pixel width. A value of 2 or 3 may improve the  appear‐
123       ance of some plots.
124
125       gnuplot*borderWidth: 2
126       gnuplot*axisWidth: 0
127       gnuplot*line1Width: 0
128       gnuplot*line2Width: 0
129       gnuplot*line3Width: 0
130       gnuplot*line4Width: 0
131       gnuplot*line5Width: 0
132       gnuplot*line6Width: 0
133       gnuplot*line7Width: 0
134       gnuplot*line8Width: 0
135
136       Gnuplot  honors the following resources for setting the dash style used
137       for plotting lines.  0 means a solid line. A 2 digit number jk (j and k
138       are  >=  1   and <= 9) means a dashed line with a repeated pattern of j
139       pixels on followed by k pixels off.  For example, '16'  is  a  "dotted"
140       line  with  1 pixel on followed by 6 pixels off.  More elaborate on/off
141       patterns can be specified with a 4 digit value.  For example, '4441' is
142       4  on, 4 off, 4 on, 1 off. The default values shown below are for mono‐
143       chrome displays or monochrome rendering on color or grayscale displays.
144       For  color displays, the defaults for all are 0 (solid line) except for
145       axisDashes which defaults to a '16' dotted line.
146
147       gnuplot*borderDashes: 0
148       gnuplot*axisDashes: 16
149       gnuplot*line1Dashes: 0
150       gnuplot*line2Dashes: 42
151       gnuplot*line3Dashes: 13
152       gnuplot*line4Dashes: 44
153       gnuplot*line5Dashes: 15
154       gnuplot*line6Dashes: 4441
155       gnuplot*line7Dashes: 42
156       gnuplot*line8Dashes: 13
157
158       The size or aspect ratio of a plot may be changed by resizing the  gnu‐
159       plot window.
160

AUTHORS

162       Thomas Williams, Pixar Corporation,
163       (gnuplot-info@lists.sourceforge.net)
164       and Colin Kelley.
165
166       Additions for labelling by Russell Lang, Monash University, Australia.
167       (rjl@monu1.cc.monash.edu.au)
168       Further  additions by David Kotz, Dartmouth College, New Hampshire, USA
169       (formerly of Duke University, North Carolina, USA).
170       (David.Kotz@Dartmouth.edu)
171

BUGS

173       See the help bugs command in gnuplot.
174

SEE ALSO

176       See the printed manual or the on-line help for details on specific com‐
177       mands.
178       X(1).
179
180
181
1824th Berkeley Distribution       03 January 2001                     GNUPLOT(1)
Impressum