Gnuplot: Difference between revisions

From csml-wiki.northwestern.edu
Jump to navigation Jump to search
 
(8 intermediate revisions by 2 users not shown)
Line 43: Line 43:


{/Symbol-Oblique [text]}
{/Symbol-Oblique [text]}

In emacs, one can use the shorthand <code>M-x ho</code> for Helvetica-Oblique and <code>M-x so</code> for Symbol-Oblique by inserting the following lines into your .emacs file.

(fset 'ho
(lambda (&optional arg) "Keyboard macro." (interactive "p") (kmacro-exec-ring-item (quote ("{/Helvetica-Oblique }^[OD" 0 "%d")) arg)))
(fset 'so
(lambda (&optional arg) "Keyboard macro." (interactive "p") (kmacro-exec-ring-item (quote ("{/Symbol-Oblique }^[OD" 0 "%d")) arg)))


More instructions are available [http://www.gnuplotting.org/manpage-gnuplot-4-6/#Q1-1-42 here].
More instructions are available [http://www.gnuplotting.org/manpage-gnuplot-4-6/#Q1-1-42 here].
Line 50: Line 57:
The following is a sample gnuplot script. Everything in braces should be replaced. Again, see the [http://www.gnuplot.info/ gnuplot homepage] or appropriate [http://www.gnuplotting.org/ tutorial] for more comprehensive usage.
The following is a sample gnuplot script. Everything in braces should be replaced. Again, see the [http://www.gnuplot.info/ gnuplot homepage] or appropriate [http://www.gnuplotting.org/ tutorial] for more comprehensive usage.


set term post eps enh color {dashed|solid} lw 2
set term post eps enh color {dashed|solid} lw 2
set output "filename.eps"
set output "filename.eps"
set encoding iso_8859_1
set encoding iso_8859_1
set key top right
set key top right
set format x "%3.2f" #format tics to have max 3 digits and
set format x "%3.2f" #format tics to have max 3 digits and
set format y "%3.2f" #max 2 digits after the decimal
set format y "%3.2f" #max 2 digits after the decimal
set xlabel "{xLabel}"
set xlabel "{xLabel}"
set ylabel "{yLabel}"
set ylabel "{yLabel}"
set xrange [{xmin}:{xmax}]
set xrange [{xmin}:{xmax}]
set yrange [{ymin}:{ymax}]
set yrange [{ymin}:{ymax}]
plot "datafile.dat" using 1:2:3 with errorbars
plot "datafile.dat" using 1:2:3 with errorbars


=== General usage tips ===
=== General usage tips ===
Line 98: Line 105:
<li>Gnuplot can histogram data without the need for preprocessing:
<li>Gnuplot can histogram data without the need for preprocessing:
<pre>
<pre>
rint(x)=(x-int(x)>0.9999)?int(x)+1:int(x)
binwidth=[binwidth]
binwidth=[binwidth]
bin(x,width)=width*rint(x/width) + binwidth/2.0
bin(x,width)=width*floor(x/width) + binwidth/2.0
set boxwidth binwidth
set boxwidth binwidth
plot "file.dat" using (bin($[colnum],binwidth)):1.0 smooth freq with boxes
plot "file.dat" using (bin($[colnum],binwidth)):(1.0) smooth freq with boxes
</pre>
</pre>
where the user should replace <tt>[binwidth]</tt> with the desired bin width and <tt>[colnum]</tt> with the column number of the data to be binned.
where the user should replace <tt>[binwidth]</tt> with the desired bin width and <tt>[colnum]</tt> with the column number of the data to be binned.
Line 109: Line 115:
=== Executable version for OS X ===
=== Executable version for OS X ===


Precompiled versions of Gnuplot are provided [[Binary versions of Gnuplot for OS X|here]].
<ul>

<li>Compiled on OS X 10.10.3 (Yosemite)</li>

<li>Prior to using this, you need to install X11/XQuartz (http://xquartz.macosforge.org/landing/)</li>

<li>Current version is Gnuplot 5.0.1</li>

<li>Includes GNU Readline library and PDF terminal</li>

<li>Installation procedure is not very sophisticated, but the resulting installation will be correct. First download [http://ariadne.ms.northwestern.edu/Download/Gnuplot/gnuplot_osx_501.zip gnuplot_osx_501.zip] and save to <tt>/tmp</tt>. Then:
<pre>
cd /usr/local
sudo unzip /tmp/gnuplot_osx_501.zip
</pre>
</li>

<li>You can now invoke gnuplot from a terminal window</li>

<li>Note: Older version still available: [http://ariadne.ms.northwestern.edu/Download/Gnuplot/gnuplot_osx_465.zip version 4.6.5], compiled on OS X 10.9.3 (Mavericks)</li>
</ul>

Latest revision as of 09:29, 6 May 2018

Overview

Gnuplot is a program for plotting scientific data. The resulting figures can be of very high quality, provided that attention is paid to detail. Impressive examples can be found on the gnuplot homepage. This page does not provide a detailed manual for gnuplot, but instead focuses on specific aspects typically encountered in the CSML when creating figures for manuscripts.

PDF terminal

The version of gnuplot installed on all local machines has been compiled with PDFlib, which makes it possible to directly produce PDF images. Such figures offer the important advantage that they are fully scalable and yet have a small file size. Choose this terminal via

 set term pdf enh [additional options]
 set output "filename.pdf"

Sometimes, fine-tuning of the resulting PDF figure is most conveniently done in Adobe Illustrator: each component of the figure will appear as an object that you can move, resize, etc.

Encapsulated PostScript terminal

Often when the output of a gnupot script requires further formatting it is easiest to do so using the Encapsulated PostScript (EPS) terminal. This is essentially the same as the PostScript terminal except that it contains some extra lines that allow it to interface with other programs. Invoke the EPS terminal via

 set term post eps enh color [additional options]
 set output "filename.eps"

For possible options see the instructions for the PostScript terminal on this page. One advantage of .eps files is that they can be edited directly in a text editor. See below for an example. Once the eps file has been formatted properly, you can convert it to PDF format using epstopdf. Executing the command

 epstopdf filename.eps

will create the PDF file filename.pdf.

Formatting labels

When choosing for instance an axis label via

 set xlabel "textlabel"

it is straightforward to use simple text, however often special formatting is necessary. A brief set of rules follows. For italic script place

 {/Helvetica-Oblique [text]}

inside the quotes, where [text] is what you wish to have in italics. All variables should be in italics. For greek letters use

 {/Symbol [text]}

where [text] is any character off of the list linked here. For italic Greek characters use

 {/Symbol-Oblique [text]}

In emacs, one can use the shorthand M-x ho for Helvetica-Oblique and M-x so for Symbol-Oblique by inserting the following lines into your .emacs file.

 (fset 'ho
    (lambda (&optional arg) "Keyboard macro." (interactive "p") (kmacro-exec-ring-item (quote ("{/Helvetica-Oblique }^[OD" 0 "%d")) arg)))
 (fset 'so
    (lambda (&optional arg) "Keyboard macro." (interactive "p") (kmacro-exec-ring-item (quote ("{/Symbol-Oblique }^[OD" 0 "%d")) arg)))

More instructions are available here.

Sample usage script

The following is a sample gnuplot script. Everything in braces should be replaced. Again, see the gnuplot homepage or appropriate tutorial for more comprehensive usage.

set term post eps enh color {dashed|solid} lw 2
set output "filename.eps"
set encoding iso_8859_1
set key top right
set format x "%3.2f" #format tics to have max 3 digits and
set format y "%3.2f" #max 2 digits after the decimal
set xlabel "{xLabel}"
set ylabel "{yLabel}"
set xrange [{xmin}:{xmax}]
set yrange [{ymin}:{ymax}]
plot "datafile.dat" using 1:2:3 with errorbars

General usage tips

  • Journals typically prefer Helvetica as the typeface for figures.
  • The origin should be marked with '0', not '0.0'. If you produce a figure directly in PDF format, this can be fixed in Adobe Illustrator. However, it is easier to use the EPS terminal and then edit the resulting .eps file using sed:
    sed -i 's/(0.0)/(0)/g' filename.eps
    
  • Gnuplot accepts abbreviated commands: you just have to enter enough characters to uniquely resolve a command. For example, it is acceptable to write
    plot "file.dat" us 1:2:3 w err
    

    instead of

    plot "file.dat" using 1:2:3 with errorbars
    
  • Gnuplot can plot compressed data files by sending the data through a pipe:
    plot '< gzip -dc data.gz'
    
  • To plot the average of columns that are spread over multiple files (but have the same number of lines in each file), take advantage of the paste command in Unix to combine them in single file. For example, if three files each contain two columns (x y), use
    paste file1.dat file2.dat file3.dat > combined.dat
    

    and then within gnuplot

    plot "combined.dat" us 1:(($2+$4+$6)/3)
    

    This can even be done on the fly by using a pipe:

    plot '< paste file1.dat file2.dat file3.dat' using 1:(($2+$4+$6)/3)
    
  • Gnuplot can histogram data without the need for preprocessing:
    binwidth=[binwidth]
    bin(x,width)=width*floor(x/width) + binwidth/2.0
    set boxwidth binwidth
    plot "file.dat" using (bin($[colnum],binwidth)):(1.0) smooth freq with boxes
    

    where the user should replace [binwidth] with the desired bin width and [colnum] with the column number of the data to be binned.

Executable version for OS X

Precompiled versions of Gnuplot are provided here.