gnuplot
An Interactive Plotting Program
Thomas Williams & Colin Kelley
Version 4.0 organized by: Hans-Bernhard Bröker and others
Major contributors (alphabetic order):
Hans-Bernhard Bröker
John Campbell
Robert Cunningham
David Denholm
Gershon Elber
Roger Fearick
Carsten Grammes
Lucas Hart
Lars Hecking
Thomas Koenig
David Kotz
Ed Kubaitis
Russell Lang
Alexander Lehmann
Alexander Mai
Ethan A Merritt
Petr Mikuĺı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
Mailing list for comments: [email protected]
Mailing list for bug reports: [email protected]
This manual was prepared by Dick Crawford.
Last edited: 2004/04/13 17:23:36
2 gnuplot 4.0 CONTENTS
Contents
I Gnuplot 12
1 Copyright 12
2 Introduction 12
3 Seeking-assistance 13
4 What is New in Version 4.0 14
4.1 Mouse and hotkey support in interactive terminals . . . . . . . . . . . . . . . . . . . . . . 14
4.2 New terminal features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.3 New plot style pm3d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.4 New plot style filledcurves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.5 Filled boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.6 New plot option smooth frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.7 Improved text options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.8 More text encodings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.9 Arrows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.10 Data file format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.11 Other changes and additions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.12 Accompanying documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
5 Batch/Interactive Operation 16
6 Command-line-editing 17
7 Comments 18
8 Coordinates 18
9 Environment 18
10 Expressions 19
10.1 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
10.1.1 Random number generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
10.2 Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
10.2.1 Unary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
10.2.2 Binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
10.2.3 Ternary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
10.3 User-defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
11 Glossary 23
12 Mouse input 24
CONTENTS gnuplot 4.0 3
12.1 Bind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
12.2 Mouse variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
13 Plotting 25
14 Start-up 26
15 Substitution 26
16 Syntax 26
17 Time/Date data 27
II Commands 28
18 Cd 28
19 Call 29
20 Clear 29
21 Exit 29
22 Fit 30
22.1 Adjustable parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
22.2 Short introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
22.3 Error estimates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
22.3.1 Statistical overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
22.3.2 Practical guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
22.4 Fit controlling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
22.4.1 Control variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
22.4.2 Environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
22.5 Multi-branch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
22.6 Starting values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
22.7 Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
23 Help 36
24 History 36
25 If 36
26 Load 37
27 Pause 38
28 Plot 38
28.1 Data-file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
4 gnuplot 4.0 CONTENTS
28.1.1 Every . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
28.1.2 Example datafile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
28.1.3 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
28.1.4 Smooth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
28.1.4.1 Acsplines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
28.1.4.2 Bezier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
28.1.4.3 Csplines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
28.1.4.4 Sbezier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
28.1.4.5 Unique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
28.1.4.6 Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
28.1.5 Special-filenames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
28.1.6 Thru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
28.1.7 Using . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
28.2 Errorbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
28.3 Errorlines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
28.4 Parametric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
28.5 Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
28.6 Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
28.7 With . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
29 Print 49
30 Pwd 49
31 Quit 49
32 Replot 50
33 Reread 50
34 Reset 51
35 Save 51
36 Set-show 52
36.1 Angles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
36.2 Arrow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
36.3 Autoscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
36.3.1 Parametric mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
36.3.2 Polar mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
36.4 Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
36.5 Bmargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
36.6 Border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
36.7 Boxwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
36.8 Clabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
CONTENTS gnuplot 4.0 5
36.9 Clip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
36.10 Cntrparam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
36.11 Color box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
36.12 Contour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
36.13 Data style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
36.14 Datafile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
36.14.1 Set datafile missing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
36.14.2 Set datafile separator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
36.14.3 Set datafile commentschars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
36.15 Decimalsign . . . . . . . . . . . . . . . . . . .
