gnuplot 4.6
An Interactive Plotting Program
Thomas Williams & Colin Kelley
Version 4.6 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, P´eter Juh´asz,
Thomas Koenig, David Kotz,
Ed Kubaitis, Russell Lang,
Timoth´ee Lecomte, Alexander Lehmann,
Alexander Mai, Bastian M¨arkisch,
Ethan A Merritt, Petr Mikul´ık,
Carsten Steger, Shigeharu Takeno,
Tom Tkacik, Jos Van der Woude,
James R. Van Zandt, Alex Woo, Johannes Zellner
Copyright
c
1986 - 1993, 1998, 2004 Thomas Williams, Colin Kelley
Copyright
c
2004 - 2012 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.
2012 Version 4.6
2 gnuplot 4.6 CONTENTS
Contents
I Gnuplot 16
Copyright 16
Introduction 16
Seeking-assistance 17
New features 18
New syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Local customization of linetypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
New plot styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Revised polar axes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
New smoothing algorithms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
New time/date handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Statistical summary of data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
New or revised terminal drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Backwards compatibility 20
Batch/Interactive Operation 20
Canvas size 21
Command-line-editing 21
Comments 22
Coordinates 22
Datastrings 23
Enhanced text mode 23
Environment 24
Expressions 25
Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Elliptic integrals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Random number generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Unary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Ternary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
CONTENTS gnuplot 4.6 3
Summation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Gnuplot-defined variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
User-defined variables and functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Fonts 31
Cairo (pdfcairo, pngcairo, epscairo, wxt terminals) . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Gd (png, gif, jpeg terminals) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Postscript (also encapsulated postscript *.eps) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Glossary 33
Linetypes, colors, and styles 33
Colorspec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Background color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Linecolor variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Rgbcolor variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Linestyles vs linetypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Mouse input 36
Bind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Bind space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Mouse variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Plotting 38
Start-up (initialization) 38
String constants and string variables 38
Substitution and Command line macros 39
Substitution of system commands in backquotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Substitution of string variables as macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
String variables, macros, and command line substitution . . . . . . . . . . . . . . . . . . . . . . . . 40
Syntax 41
Quote Marks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Time/Date data 42
II Plotting styles 42
Boxerrorbars 43
Boxes 43
Boxplot 44
4 gnuplot 4.6 CONTENTS
Boxxyerrorbars 45
Candlesticks 45
Circles 46
Ellipses 47
Dots 47
Filledcurves 48
Financebars 49
Fsteps 49
Fillsteps 49
Histeps 49
Histograms 50
Newhistogram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Automated iteration over multiple columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Image 53
Transparency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Image failsafe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Impulses 54
Labels 54
Lines 55
Linespoints 55
Points 55
Polar 56
Steps 56
Rgbalpha 56
Rgbimage 56
Vectors 56
Xerrorbars 57
Xyerrorbars 57
CONTENTS gnuplot 4.6 5
Yerrorbars 57
Xerrorlines 58
Xyerrorlines 58
Yerrorlines 59
3D (surface) plots 59
2D projection (set view map) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
III Commands 60
Cd 60
Call 60
Clear 61
Do 61
Evaluate 62
Exit 62
Fit 62
Adjustable parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Short introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Error estimates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Statistical overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Practical guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Control variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Multi-branch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Starting values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Help 69
History 69
If 69
If-old . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Iteration 70
Load 70