To run Ptplot 5.6 applets, you must install the version 1.3 or later of the Javasoft Java Plug-in. In theory, it should be possible to run Ptplot using the Java 1.2 plug-in, but we recommend upgrading to the Java 1.4.2 plug-in.
If you will be extending the Ptplot classes, then you
should install the Java 1.4.2 Java Development Kit:
If you do not want to require your users to install the Java 1.4.2 plug-in, then you should stick with Ptplot 3.1, which does not use Swing.
Ptplot is distributed in several formats.
ptplot, then you may want to go through the installation procedure so that the standalone scripts are properly localized.
This tar file (ptplot5.6.tar.gz), will unpack into called ptplot5.6, and the configure-make-make install process will not install any files outside of this ptplot5.6 directory. So if you unpack the tar file into /usr/local, after installing you will have /usr/local/ptplot5.6, and you may want to tell users to add /usr/local/ptplot5.6/bin to their PATH. The scripts in the bin directory will run the plotter as a standalone application, or they can add /usr/local/ptplot5.6 to their Java CLASSPATH.
If you are using Windows and you want to rebuild Ptplot or
localize the standalone scripts, then you will need to install the
Cygwin toolkit from
We have packaged up the necessary Cygwin tools and made them available at
If you are running Windows and do not want to install the Cygwin toolkit,
Using Ptplot under Windows without Cygwin
Below are the installation instructions for Unix and Windows with Cygwin.
javacis in your path.
PTIIenvironment variable to point to the top of the Ptplot tree. Under C-shell, one would do:
setenv PTII ~/src/ptolemy/ptplot5.6Under Cygwin with bash:
PTII=c:\\ptolemy\\ptplot5.6 export PTII
cd "$PTII"(The double quotes are only necessary if $PTII has spaces in it)
rm -f config.* ./configure
$PTII/bincontains the following scripts
Note that under Java 1.4.0_01, viewing local applets that have spaces in the path name may fail if the applet tries to download a data file. The workaround is to place the Ptplot distribution in a directory that does not have space in the pathname. For details, see the Troubleshooting Guide.
Note that when you run the installer under Windows, Ptplot is added to your Start menu under Ptolemy -> Ptplot 5.6.
/bin/shscript that determines some information about your environment and then modifies a few files. When the
configurescript is run, it reads in
To get help with
configure reads in the
and substitutes strings inside the
configure reads in
PTIIvariable to the top-level directory of the Ptplot tree.
PTIIis used by the standalone
ptplot.batscript and other scripts
javais in your path by running
%PTII%\binto your PATH.
C:\ptolemy\ptplot5.6> cd ptolemy\plot
C:\ptolemy\ptplot5.6\ptolemy\plot>set CLASSPATH=..\.. C:\ptolemy\ptplot5.6\ptolemy\plot>echo %CLASSPATH% ..\..
C:\ptolemy\ptplot5.6\ptolemy\plot>del *.class C:\ptolemy\ptplot5.6\ptolemy\plot>javac *.java
ptplot.bat, which reads
pxgraphargsapplet parameter should use this jar file.
plot.jaris used by the Ptolemy II build system.
plotapplication.jaris present, then it is used by the standalone scripts (
*applet.jarfile into the same directory as your applet, and then to use the
archiveapplet directive. For examples of applet html code, see the demonstrations.
ptplotscript is shared between the standalone applications,
ptplotdetermines what name it was called with, and selects the appropriate class accordingly.
ptplot script is run,
ptolemy.plot.PlotApplication is run
ptplot script is copied to
ptolemy.plot.plotml.HistogramMLApplication is run
ptplot script is copied to
ptolemy.plot.compat.PxgraphApplication is run
Under Unix or Windows with Cygwin, you can use a hard link to create the histogram and pxgraph script:
cd $PTII/bin ln ptplot histogram ln ptplot pxgraph
Under Windows in a DOS shell, three .bat scripts are provided:
Last Updated: $Date: 2007/01/14 00:31:58 $