gnuplot
An Interactive Plotting Program
Thomas Williams & Colin Kelley
Version 4.2 organized by: Hans-Bernhard Br¨oker, Ethan A Merritt, and others
Major contributors (alphabetic order):
Hans-Bernhard Br¨oker
John Campbell
Robert Cunningham
David Denholm
Gershon Elber
Roger Fearick
Carsten Grammes
Lucas Hart
Lars Hecking
Thomas Koenig
David Kotz
Ed Kubaitis
Russell Lang
Timoth´ee Lecomte
Alexander Lehmann
Alexander Mai
Ethan A Merritt
Petr Mikul´ık
Carsten Steger
Tom Tkacik
Jos Van der Woude
Alex Woo
James R. Van Zandt
Johannes Zellner
Copyright
c
1986 - 1993, 1998, 2004 Thomas Williams, Colin Kelley
Copyright
c
2004 - 2007 various authors
Mailing list for comments: gnuplot-info@lists.sourceforge.net
Mailing list for bug reports: gnuplot-bugs@lists.sourceforge.net
Web access (preferred): http://sourceforge.net/projects/gnuplot
This manual was originally prepared by Dick Crawford.
21 September 2008
2 gnuplot 4.2 CONTENTS
Contents
I Gnuplot 14
1 Copyright 14
2 Introduction 14
3 Seeking-assistance 15
4 New features introduced in version 4.2 16
4.1 New plot styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.1.1 Histogram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.1.2 Label plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.1.3 Image data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.1.4 Filled curves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.1.5 Vectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.2 Input from binary data files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.3 New plot elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.3.1 RGB colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.3.2 Arbitrary rectangles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.4 String handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.4.1 String and text data read from datafiles . . . . . . . . . . . . . . . . . . . . . . . 17
4.4.2 User-defined string variables, operators, and functions . . . . . . . . . . . . . . . 17
4.5 Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.6 Auto-layout of multiple plots on a page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.7 Internal variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.8 New or revised terminal drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.8.1 wxt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.8.2 emf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.8.3 gif, jpeg, png . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.8.4 postscript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.8.5 ai . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.8.6 epslatex, pslatex, pstex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.8.7 windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.9 Canvas size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
5 Backwards compatibility 18
6 Features introduced in version 4.0 19
6.1 Mouse and hotkey support in interactive terminals . . . . . . . . . . . . . . . . . . . . . . 19
6.2 New terminals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
6.3 New plot style pm3d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
6.4 Filled boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
CONTENTS gnuplot 4.2 3
6.5 New plot option smooth frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.6 Improved text options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.7 More text encodings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.8 Arrows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.9 Data file format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.10 New commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.11 Other changes and additions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
6.12 Accompanying documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
7 Batch/Interactive Operation 21
8 Command-line-editing 21
9 Comments 22
10 Coordinates 23
11 Datastrings 23
12 Environment 24
13 Expressions 24
13.1 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
13.1.1 Random number generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
13.2 Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
13.2.1 Unary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
13.2.2 Binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
13.2.3 Ternary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
13.3 Gnuplot-defined variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
13.4 User-defined variables and functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
14 Glossary 30
15 Linetype, colors, and styles 30
15.1 Colorspec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
16 Mouse input 32
16.1 Bind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
16.2 Mouse variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
17 Plotting 34
18 Start-up 34
19 String constants and string variables 35
20 Substitution and Command line macros 35
4 gnuplot 4.2 CONTENTS
20.1 Substitution of system commands in backquotes . . . . . . . . . . . . . . . . . . . . . . . 35
20.2 Substitution of string variables as macros . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
20.3 String variables, macros, and command line substitution . . . . . . . . . . . . . . . . . . 36
21 Syntax 37
21.1 Quote Marks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
22 Time/Date data 38
II Commands 39
23 Cd 39
24 Call 39
25 Clear 40
26 Exit 40
27 Fit 41
27.1 Adjustable parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
27.2 Short introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
27.3 Error estimates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
27.3.1 Statistical overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
27.3.2 Practical guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
27.4 Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
27.4.1 Control variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
27.4.2 Environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
27.5 Multi-branch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
27.6 Starting values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
27.7 Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
28 Help 47
29 History 47
30 If 48
31 Load 48
32 Lower 49
33 Pause 49
34 Plot 50
34.1 Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
34.1.1 Binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
CONTENTS gnuplot 4.2 5
34.1.2 Binary general . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
34.1.2.1 Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
34.1.2.2 Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
34.1.2.3 Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
34.1.2.4 Endian . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
34.1.2.5 Filetype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
34.1.2.5.1 Avs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
34.1.2.5.2 Edf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
34.1.2.6 Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
34.1.2.6.1 Scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
34.1.2.6.2 Transpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
34.1.2.6.3 Dx, dy, dz . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
34.1.2.6.4 Flipx, flipy, flipz . . . . . . . . . . . . . . . . . . . . . . . . . 54
34.1.2.6.5 Origin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
34.1.2.6.6 Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
34.1.2.6.7 Rotate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
34.1.2.6.8 Perpendicular . . . . . . . . . . . . . . . . . . . . . . . . . . 55
34.1.2.7 Binary examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
34.1.3 Every . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
34.1.4 Example datafile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
34.1.5 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
34.1.6 Smooth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
34.1.6.1 Acsplines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
34.1.6.2 Bezier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
34.1.6.3 Csplines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
34.1.6.4 Sbezier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
34.1.6.5 Unique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
34.1.6.6 Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
34.1.7 Special-filenames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
34.1.8 Thru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
34.1.9 Using . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
34.1.9.1 Using title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
34.1.9.2 Xticlabels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
34.1.9.3 X2ticlabels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
34.1.9.4 Yticlabels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
34.1.9.5 Y2ticlabels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
34.1.9.6 Zticlabels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
34.2 Errorbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
34.3 Errorlines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
34.4 Parametric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
34.5 Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
34.6 Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
