4
<title>Gnuplot.py</title>
7
<body bgcolor="#ffffff">
9
<p><i><a href="index.html">Table of Contents</a></i></p>
11
<table border="0" cellpadding="5" cellspacing="0" width="100%">
12
<tr bgcolor="#88bbee">
16
width="10%"><font color="#000000">Gnuplot.py</font>
18
<th align="right"><font color="#000000"> </font></th>
22
<dl><dt>Gnuplot.py</dt><dd><p>A pipe-based interface to the gnuplot plotting program.</p>
25
<dt><p><strong>The Gnuplot.py home page is</strong><p>
26
</dt><dd><p> http://gnuplot-py.sourceforge.net</p>
30
<p>There you can get the latest version, view the documentation, or
36
<p>The best way to get started is to run the demo by typing `python
37
demo.py'. This should pop up a few gnuplot windows, one after
38
another, containing simple graphs, and also write a postscript file
39
called `gp_test.ps' to the current directory. Then look at the code
40
for the demo which is in the function `demo()' at the bottom of
41
demo.py. This should be enough to get you started making simple plots
44
<p>Documentation for Gnuplot.py is in the doc/ subdirectory (which is
45
generated automatically from the docstrings using happydoc). And
46
don't be shy, just open up the Python files with your favorite text
47
editor and take a look.</p>
49
<p>For a relatively thorough test of Gnuplot.py, type `python test.py'
50
which goes systematically through most Gnuplot.py features.</p>
55
<p>Obviously, you must have the gnuplot program if Gnuplot.py is to be of
56
any use to you. Gnuplot can be obtained via
57
<http://www.cs.dartmouth.edu/gnuplot_info.html>. You also need
58
Python's Numerical extension, which is available from
59
<http://numpy.sourceforge.net>.</p>
61
<p>Gnuplot.py uses Python distutils
62
<http://www.python.org/doc/current/inst/inst.html> and can be
63
installed by untarring the package, changing into the top-level
64
directory, and typing "python setup.py install". The Gnuplot.py
65
package is pure Python--no compilation is necessary.</p>
67
<p>If you want to try out the demonstration before installing the
68
package, type `python demo.py'.</p>
70
<p>Gnuplot.py is structured as a python package. That means that it
71
installs itself as a subdirectory called `Gnuplot' under a directory
72
of your python path (usually site-packages). If you don't want to use
73
distutils you can just move the main Gnuplot.py directory there and
74
rename it to "Gnuplot".</p>
76
<p>There are some configuration options that can be set near the top of
77
the platform-dependent files gp-unix.py (Unix), gp_mac.py (Macintosh),
78
and gp_win32.py (Windows). (Obviously, you should change the file
79
corresponding to your platform.) See the extensive comments in
80
gp_unix.py for a description of the meaning of each configuration
81
variable. Sensible values are already chosen, so it is quite possible
82
that you don't have to change anything.</p>
84
<p>Import the main part of the package into your python programs using
85
`import Gnuplot'. Some other features can be found in the modules
86
Gnuplot.funcutils and Gnuplot.PlotItems.</p>
88
<p>For backwards compatibility, an old function-based interface to
89
Gnuplot.py (derived from Konrad Hinsen's original Gnuplot.py) is
90
available in a separate file, oldplot.py. However, this old interface
91
is deprecated and will no longer be developed.</p>
93
<p>Installation on Windows
94
-----------------------</p>
96
<p>I don't run Windows, but thanks to the help of users there is now a
97
way to use Gnuplot.py on that platform. Any feedback or additional
98
suggestions having to do with Windows would be especially appreciated.</p>
100
<p>If you are using a version of Python prior to 2.0, you must install
101
the quasi-standard Win32 extensions. This can be obtained from the
102
main Windows download page:</p>
103
<p> http://www.python.org/download/download_windows.html</p>
106
<p>Because the main MS-Windows gnuplot executable (wgnuplot.exe) doesn't
107
accept commands on standard input, Gnuplot.py cannot communicate with
108
it directly. However, there is a simple little program called
109
`pgnuplot.exe' that accepts commands on stdin and passes them to
110
wgnuplot. So to run Gnuplot.py on Windows, you need to make sure that
111
pgnuplot.exe is installed. It comes with gnuplot since at least
112
version 3.7.1. Alternatively you can get pgnuplot.exe alone by
113
downloading `testing/windows-stdin.zip' from one of the gnuplot
115
<ftp://ftp.gnuplot.vt.edu/pub/gnuplot/testing/windows-stdin.zip>).</p>
117
<p>Continue installing Gnuplot.py by following the instructions in the
118
previous section.</p>
120
<p>Installation on the Macintosh
121
-----------------------------</p>
123
<p>Thanks to more user help, Gnuplot.py should now work on the Macintosh
124
too. Since pipes don't exist on the Mac, communication with gnuplot
125
is via a python module called gnuplot_Suites.py (included) which uses
126
AppleEvents. Note that you will have to convert the python files to
127
Mac text files (different end-of-line character). Currently it is not
128
possible to print directly to a printer; however, it should be
129
possible to print to a postscript file and print that file manually.
130
Also, inline data does not seem to be supported. Let me know if you
131
find other problems or have patches to fix Mac limitations.</p>
136
<p>I would love to have feedback from people letting me know whether they
137
find Gnuplot.py useful. And certainly let me know about any problems,
138
suggestions, or enhancements. My address is at the bottom of this
141
<p>Gnuplot.py has been tested with gnuplot version 3.7, and I believe it
142
should work with version 3.5 (though some features, like enhanced
143
postscript mode and binary splot mode, will not work). Let me know if
144
you have trouble.</p>
146
<p>Gnuplot.py was developed under Linux and Digital Unix; it should work
147
without much problem on other unix computers. If you need to modify
148
it for your system tell me what was necessary and I'll include your
149
changes in a future release.</p>
151
<p>Gnuplot.py should also work under Windows and Macintosh (see above).
152
Feedback for these platforms is especially appreciated since I can't
153
test them myself.</p>
158
<p>See the file LICENSE for license info. Basically Gnuplot is GPL.</p>
163
<p>See CREDITS.txt for a list of people who have contributed code and/or
164
ideas to Gnuplot.py. Thanks especially to Konrad Hinsen
165
<hinsen@ibs.ibs.fr>, who wrote the first, procedural interface version
170
<mhagger@alum.mit.edu></p>
173
<table border="0" cellpadding="5" cellspacing="0" width="100%%">
176
<th bgcolor="#99ccff"
182
<font color="#000000">
183
<a name="Modules">Modules</a>
186
<th bgcolor="#99ccff"
190
<font color="#000000"> </font>
195
<table border="0" cellpadding="5">
196
<tr><td valign="top" align="left"><a href="Gnuplot.html">__init__</a></td><td valign="top" align="left"><dl><dt>Gnuplot</dt><dd><p>A pipe-based interface to the gnuplot plotting program.</p>
202
<table border="0" cellpadding="5">
203
<tr><td valign="top" align="left"><a href="Gnuplot/PlotItems.py.html">PlotItems</a></td><td valign="top" align="left"><dl><dt>PlotItems.py</dt><dd><p>Objects that can be plotted by Gnuplot.</p>
207
<tr><td valign="top" align="left"><a href="Gnuplot/_Gnuplot.py.html">_Gnuplot</a></td><td valign="top" align="left"><dl><dt>_Gnuplot.py</dt><dd><p>An object that represents a running gnuplot process.</p>
211
<tr><td valign="top" align="left"><a href="Gnuplot/demo.py.html">demo</a></td><td valign="top" align="left"><dl><dt>demo.py</dt><dd><p>Demonstrate the Gnuplot python module.</p>
215
<tr><td valign="top" align="left"><a href="Gnuplot/funcutils.py.html">funcutils</a></td><td valign="top" align="left"><dl><dt>funcutils.py</dt><dd><p>Subroutines that tabulate a function's values.</p>
219
<tr><td valign="top" align="left"><a href="Gnuplot/gnuplot_Suites.py.html">gnuplot_Suites</a></td><td valign="top" align="left"><p>Suite gnuplot Suite: Events supplied by gnuplot</p>
222
<tr><td valign="top" align="left"><a href="Gnuplot/gp.py.html">gp</a></td><td valign="top" align="left"><dl><dt>gp</dt><dd><p>a platform-independent interface to a gnuplot process.</p>
226
<tr><td valign="top" align="left"><a href="Gnuplot/gp_mac.py.html">gp_mac</a></td><td valign="top" align="left"><dl><dt>gp_mac</dt><dd><p>an interface to gnuplot for the Macintosh.</p>
230
<tr><td valign="top" align="left"><a href="Gnuplot/gp_unix.py.html">gp_unix</a></td><td valign="top" align="left"><dl><dt>gp_unix</dt><dd><p>an interface to gnuplot used for unix platforms.</p>
234
<tr><td valign="top" align="left"><a href="Gnuplot/gp_win32.py.html">gp_win32</a></td><td valign="top" align="left"><dl><dt>gp_win32</dt><dd><p>an interface to gnuplot for Windows.</p>
238
<tr><td valign="top" align="left"><a href="Gnuplot/oldplot.py.html">oldplot</a></td><td valign="top" align="left"><dl><dt>oldplot.py</dt><dd><p>Obsolete functional interface to Gnuplot.</p>
242
<tr><td valign="top" align="left"><a href="Gnuplot/setup.py.html">setup</a></td><td valign="top" align="left"><p>Setup script for the Gnuplot module distribution.</p>
245
<tr><td valign="top" align="left"><a href="Gnuplot/test.py.html">test</a></td><td valign="top" align="left"><dl><dt>test.py</dt><dd><p>Exercise the Gnuplot.py module.</p>
249
<tr><td valign="top" align="left"><a href="Gnuplot/utils.py.html">utils</a></td><td valign="top" align="left"><dl><dt>utils.py</dt><dd><p>Utility functions used by Gnuplot.</p>
265
<p><i><a href="index.html">Table of Contents</a></i></p>
267
<i>This document was automatically generated on Fri Jan 26 14:06:11 2001
268
by <a href="http://happydoc.sourceforge.net">HappyDoc</a> version r0_9_2</i>
b'\\ No newline at end of file'