1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
4
<title>Gnuplot.py</title>
5
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5
8
<body bgcolor="#ffffff">
7
10
<center><h1>Gnuplot.py on <a href="http://sourceforge.net"><img
8
src="http://sourceforge.net/sflogo.php?group_id=17434&type=1"
11
src="http://sourceforge.net/sflogo.php?group_id=17434&type=1"
9
12
width="88" height="31" border="0" alt="SourceForge Logo"></a></h1></center>
19
22
href="http://gnuplot-py.sourceforge.net">Gnuplot.py home page</a>
20
<li> Download the current version (version 1.5) as a <a
21
href="http://download.sourceforge.net/gnuplot-py/Gnuplot-1.5.tar.gz">
22
tar file</a> or as a <a
23
href="http://download.sourceforge.net/gnuplot-py/Gnuplot-1.5.zip">
24
zip file</a> (includes documentation)
24
href="http://sourceforge.net/projects/gnuplot-py/">Gnuplot.py
25
project page</a> on SourceForge.
27
href="http://sourceforge.net/project/showfiles.php?group_id=17434">
28
current version (version 1.7)</a> (includes documentation)
26
30
href="http://gnuplot-py.sourceforge.net/doc">online
29
href="https://sourceforge.net/projects/gnuplot-py/">Gnuplot.py
30
project page</a> on SourceForge.
33
href="http://lists.sourceforge.net/lists/listinfo/gnuplot-py-users">Gnuplot.py
34
users' mailing list</a>
46
50
plotting different datasets one after another. </p>
48
52
<p> Commands are communicated to gnuplot through a pipe and data
49
either through the same pipe (as "inline" data) or through temporary
50
files. It has been written and tested on a unix computer but is also
51
reported to work on MS Windows and the Macintosh (please give me
53
either through the same pipe (as "inline" data), through FIFOs (named
54
pipes), or through temporary files. It has been developed under Unix
55
and is known to work under various forms of Unix (including Linux), MS
56
Windows, MacOS, and Mac OS X. There is now also preliminary support
57
for running Gnuplot.py under Jython/Java. </p>
54
59
<p> This package has an object-oriented design that allows the user
55
60
flexibility to set plot options and to run multiple gnuplot sessions
66
<p> (26 Jan 2001) Gnuplot.py version 1.5 is out. The development of
67
Gnuplot.py went through a lull during year 2000. One reason is that I
68
don't use it in my new job. Another reason (I like to think) is that
69
version 1.4 worked pretty well and didn't need much work. This month
70
I've had some extra time so I incorporated several contributions from
71
other users and made some improvements myself. I also moved the
72
project to <a href="http://sourceforge.net">SourceForge</a> because of
73
their excellent facilities and to open up the development process.
74
Version 1.5 has a few new features, a better source code organization,
75
a <a href="http://python.org/sigs/distutils-sig/">distutils</a>-based
76
installation process, and better platform independence. </p>
78
<p> To read about changes introduced in earlier versions, read the
79
<tt>NEWS.txt</tt> file in the distribution. </p>
71
<p> (17 October 2003) Gnuplot.py version 1.7 is out. This version
72
includes a change of license from GPL to LGPL, support for sending
73
data to Gnuplot via FIFOs (named pipes) under unix, and preliminary
74
support for running Gnuplot.py under Jython. For more information,
75
read the <tt>NEWS.txt</tt> file in the distribution. </p>
82
78
<h2>Documentation</h2>
84
The quickest way to learn how to use Gnuplot.py is to run the simple
85
demonstration by typing `<tt>python demo.py</tt>', then to look at the
86
<tt>demo.py</tt> file to see the commands that create the demo. One
87
of the examples is probably similar to what you want to do. </p>
89
<p> HTML documentation is included in the doc/ directory of the
90
distribution and is also available <a
80
<p> The quickest way to learn how to use Gnuplot.py is to install it
81
then run the simple demonstration by typing `<tt>python demo.py</tt>',
82
then to look at the <tt>demo.py</tt> file to see the commands that
83
create the demo. One of the examples is probably similar to what you
86
<p> Don't forget to read the Gnuplot.html, README.txt and FAQ.txt
87
files in the Gnuplot.py distribution. </p>
89
<p> HTML documentation for the Python classes is included in the doc/
90
directory of the distribution and is also available <a
91
91
href="doc/index.html">online</a>. This documentation is extracted
92
92
automatically from the package's docstrings using <a
93
href="https://sourceforge.net/projects/happydoc/"> happydoc</a> and is
94
known to have some formatting problems. </p>
93
href="http://sourceforge.net/projects/happydoc/"> happydoc</a> and is
94
known to have some formatting problems. Alternatively, you can look
95
at the docstrings yourself by opening the python files in an
96
<p> Finally, you can look at the docstrings yourself by opening the
97
file <tt>__init__.py</tt> in an editor. </p>
98
<p> Finally, there is a new <a
99
href="mailto:gnuplot-py-users@lists.sourceforge.net">mailing list</a>
100
for Gnuplot.py users. For more information about subscribing to the
101
list or viewing the archive of old articles, please click <a
102
href="http://lists.sourceforge.net/lists/listinfo/gnuplot-py-users">here</a>.
99
105
<p> To get good use out of Gnuplot.py, you will want to know something
100
106
about gnuplot, for which a good source is the gnuplot help (run
101
107
gnuplot then type `help', or read it online at <a
102
href="http://www.cs.dartmouth.edu/gnuplot/gnuplot.html"> this
108
href="http://www.gnuplot.info/gnuplot.html"> this
103
109
website</a>). You might also want to check out Bernhard Reiter's <a
104
href="http://www.usf.Uni-Osnabrueck.DE/~breiter/tools/gnuplot/index.en.html">
110
href="http://www.usf.uni-osnabrueck.de/~breiter/tools/gnuplot/index.en.html">
105
111
gnuplot information page</a>, which has many more links. </p>
108
114
<h2>Installation</h2>
110
116
<p> More detailed installation instructions are contained in
111
<tt>README.txt</tt></a>. </p>
117
<tt>README.txt</tt>. </p>
113
<p> Before you can use Gnuplot.py, you will need working versions of
119
<p> Before you can use Gnuplot.py, you will need working versions of </p>
115
<li> the <a href="http://www.gnuplot.org">gnuplot</a> program,
121
<li> the <a href="http://www.gnuplot.info">gnuplot</a> program,
116
122
<li> <a href="http://www.python.org">Python</a> (version 1.5 or
118
124
<li> the <a href="http://numpy.sourceforge.net/"> Numeric Python
122
128
<p> If you want to run under MS Windows, make sure you are either
123
129
using Python version 2.0 or later or that you have the <a
125
131
extensions</a> installed. Also make sure you have
126
132
<tt>pgnuplot.exe</tt> (see the README.txt file for details). </p>
128
<p> To install Gnuplot.py:
134
<p> To install Gnuplot.py: </p>
130
<li> Download either <a
131
href="http://download.sourceforge.net/gnuplot-py/Gnuplot-1.5.tar.gz">
132
Gnuplot-1.5.tar.gz</a> or <a
133
href="http://download.sourceforge.net/gnuplot-py/Gnuplot-1.5.zip">
137
href="http://sourceforge.net/project/showfiles.php?group_id=17434">Download</a>
138
either <code>gnuplot-py-1.7.tar.gz</code> or <code>
139
Gnuplot-1.7.zip</code>.
135
141
<li> Gunzip and untar (or unzip) it, which will create a directory
136
called ``Gnuplot-1.5''.
142
called <code>gnuplot-1.7</code>.
137
144
<li> Refer to <tt>README.txt</tt> in that directory for further
138
instructions. Basically it should be enough to type
139
<code>python setup.py install</code>.
145
instructions. Usually it should be enough to type <code>python
146
setup.py install</code>.
142
150
<p> You can also access the latest Gnuplot.py sources via CVS. Click
143
<a href="https://sourceforge.net/cvs/?group_id=17434"> here</a> for
151
<a href="http://sourceforge.net/cvs/?group_id=17434"> here</a> for
144
152
more information. </p>
147
155
<h2>Copyleft</h2>
149
157
<p> Gnuplot.py is released under the <a
150
href="http://www.fsf.org/copyleft/gpl.html"> GNU General Public
151
License</a>, which means that it can be freely copied and used, but
152
that there are some restrictions on your rights to incorporate it into
153
acommercial products. See the <a href="LICENSE"> LICENCE</a> file for
154
more information. (If these restrictions are a problem for you,
158
href="http://www.fsf.org/copyleft/lesser.html"> GNU Lesser General
159
Public License</a>, which means that it can be freely copied and used,
160
but that there are some restrictions on your rights to incorporate it
161
into commercial products. See the <a href="LICENSE"> LICENCE</a> file
162
for more information. (If these restrictions are a problem for you,
155
163
please contact me to discuss the issue.)