Download Ptplot 5.1p1

Note:
This is not the most recent version of Ptplot. The most recent version can be found at http://ptolemy.eecs.berkeley.edu/java/ptplot/

Downloads

Ptplot is available for download in several format.
Each of the formats contains the same functionality.

Tar and Zip files:

ptplot5.1p2.tar.gz - 1.65Mb Gzipped Tar File

ptplot5.1p2.zip - 1.91Mb Compressed Zip File

The difference between ptplot5.1p1 and ptplot5.1p2 is that p2 is much more likely to build under Solaris. We hope to have a ptplot5.1p2 Windows installer available sometime in the future.

ptplot5.1p1: Windows only: Run the installer as an applet.
Note that this installer does not work with JDK1.4, it requires JDK1.3.1-02 or earlier. For details, see InstallShield Bugs below.

ptplot5.1p1: Windows only: Download a 3.45Mb Windows executable
Note that this installer does not work with JDK1.4, it requires JDK1.3.1 For details, see InstallShield Bugs below.

Build Instructions

Installation Instructions

1. Install Java, if necessary

Ptplot 5.1p1 requires Java 1.2 or later. Java 1.3 is preferred. The Ptplot 5.1p1 Windows installers require Java 1.3. To run Ptplot, the Java runtime environment (JRE) is sufficient. To run the applets in a browser, the Java plug-in is required. The JRE is bundled with the plug-in, so downloading the plug-in is sufficient. To extend Ptplot with your own Java code, the Java development kit (JDK) or an equivalent Java development environment is required. The JDK includes a Java compiler.

One way to determine what version of Java (if any) is installed is to run our Java Version Applet , which uses the Java 1.3 plug-in. Another way is to run the command below to see whether you have Java installed, and whether it is the proper version:

java -version

If the command cannot be found, or the version that is printed is less than 1.3, you should install the plug-in, JRE 1.3, or JDK 1.3

Downloads:

Windows JRE: The Java runtime environment, JRE (no Java compiler): j2re-1_3_0_02-win.exe (5.1Mb)

Full JDK, or other Platforms: http://java.sun.com/j2se/1.3/

2. Install Ptplot

There are three ways to install Ptplot on Windows machines:

Download the tar file and run using the java command

Download ptplot5.1p1.tar.gz (3.45Mb)
Untar the file. In this example, I untared it in d:\tmp so that d:\tmp\ptplot was created.
The tar file contains sources and jar files, to run the plotter, start up a command window with Start -> Run -> cmd and type
```
java -classpath d:/tmp/ptplot5.1p1/ptolemy/plot/plotapplication.jar ptolemy.p
lot.plotml.EditablePlotMLApplication
```
There are also simple DOS batch files that will start up the Plotter. They depend on the PTII environment variable being set. You can set that variable and run the batch files with:
```
C:\>set PTII=d:\tmp\ptplot5.1p1

C:\>echo %PTII%
d:\tmp\ptplot5.1p1

C:\>%PTII%\bin\ptplot
```

Run the installer as an applet. This applet, from InstallShield, will install Ptplot, from Berkeley, on your machine.
Note that this installer does not work with JDK1.4, it requires JDK1.3.1-02 or earlier. For details, see InstallShield Bugs below.

Download a 3.45Mb Windows executable, and execute it.
Note that this installer does not work with JDK1.4, it requires JDK1.3.1-02 or earlier. For details, see InstallShield Bugs below.

If you are not planning on extending Ptplot, and you downloaded using the applet or installer, then you can run Ptplot via Start->Ptolemy->Ptplot 5.1p1

To extend Ptplot under Windows, you will also need the Cygwin toolkit, and then follow the Installation Instructions to set up your build environment.

Other Platforms:

Standard tar file and configure method:

Download ptplot5.1p1.tar.gz (3.45Mb)
Follow the Installation Instructions

Bugs

The Installshield Installer has a number of bugs:

The Installshield installer does not work with JDK1.4, it requires JDK1.3.1-02 or earlier because the Installshield product used to create the installer requires knowing in advance the version of the JVM that will be used.
On 5/20/02, we were able to install with:

$ java -version
java version "1.3.1"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.1-b24)
Java HotSpot(TM) Client VM (build 1.3.1-b24, mixed mode)

The installer looks for JDK1.3.1-02, JDK1.3.1-01, JDK1.3.1 and JDK1.3

One workaround is to install from the tar file and run java from a console window. Another version is to install Java Runtime Environment 1.3.1-02 or earlier.

Older Java installations can be found at http://java.sun.com/products/archive/index.html

Another workaround is to extract the files in the setup.exe file:

 ./ptplot5_1p1setup.exe -is:extract

Then run

 java -jar ptplot5_1p1setup.jar

By default, the Ptplot is installed in the All Users menu. Ideally, the user would be given a choice as to whether Ptplot was installed for the current user or in the All Users menu.

The user should be prompted for where in the Start menu Ptplot II is installed.

The size of the install may be reported as 0kb.

The percent completed bars may not work.

Installing a bundled JRE does not work well so we don't use it. Installshield Multiplatform edition can be configured to download a JVM, but the JVM gets installed in a _jvm directory and is not added to Add/Remove Programs and the browswers can't use the plugin.

Installshield Multiplatform Edition can't update environment variables, so the user's path is not updated to include the directory where Ptplot is installed.

You may find the The Ptolemy II 1.0 Installshield Bugs useful.