Eclpss Deployment Page

System Requirements

To launch the Eclpss framework on your system you must install the Java SDK version 1.4 (or higher).

For those who are new to Java...

We encourage you to review The Java Tutorial to learn the basic syntax of the language.
To make your life simple, when you download Java SDK version 1.4.x, just say yes to everything.
Several of the java binaries that will be installed on your system and used by Eclpss include:

"java" runs applications and you use this binary to run your simulations.
"javac" compiles java source code and you use this binary to compile your programs.
"javadoc" generates documentation for your simulations.
"javaws" launches Java Web Start and you may use this program to launch Eclpss.

It is a good idea to have at least 256MB memory.
The best deployment option for Eclpss is Java Web Start. After installing the Java SDK, you click on this link (below) and it causes the browser to launch the Java Web Start software. This software automatically downloads and runs the Eclpss framework on all platforms, so compatibility is not a problem.
You may also run Eclpss on your system by downloading the Executable Jar file below.

First-time Users

Regardless of how you launch Eclpss, be aware that the Eclpss software:

requires access to the hard drive and system;
writes XML files, Java source files and Java class files;
makes system calls to compile and run the Java source files it creates.

The Eclpss software is signed using an internal certificate so you can trust launching the software through Java Web Start.

When you launch Eclpss using Java Web Start, a fairly intimidating dialog will caution you about what you would be letting this application do (write to the hard drive, etc.). It prompts you, asking if you wish to continue. If you still wish to enter the world of Eclpss, click the Continue button.

Upon first startup of the software you will be prompted for the location of several items. Browse to these items and select them. If you make a mistake, don't worry, you can change a path later from the preferences dialog.

Version News

The latest (bleeding version) is Eclpss V2.0-b3, March 2004. Read about the new features and bug fixes!
(The Walkthrough example uses this version.)

Deployment

To begin using Eclpss, choose your method of deployment (running the Eclpss program).
Download and install the latest Java SDK if it is not on your system already.

To verify the version of java on your system (or if it exists):

Windows: start an MS-DOS prompt window and type "java -version"
X-based operating system: from a terminal window, type "java -version"
Mac OS X: from a terminal window, type "java -version"

If you choose to use Java Web Start, install the program and click on the jnlp file below.
If you choose to use the Executable Jar file, download it from the link below onto your system
and deploy Eclpss using the appropriate command line below.

Deployment Option Environment Setup Deployment Instructions

Java Web Start 1. Install Java SDK version 1.4
2. Install Java Web Start
Click Here (Eclpss jnlp file V2.0-b3)

Executable Jar File Install Java SDK version 1.4 1. Download Eclpss Jar File (V2.0-b3)
2. Execute the jar at a command prompt

Windows from the MS-DOS prompt: "java -jar eclpss_V2.0-b3.jar" Any X-based Operating System: "java -jar -DDISPLAY=$DISPLAY eclpss_V2.0-b3.jar" MAC OS X: "java -jar eclpss_V2.0-b3.jar"

A Word About Builds

This software will be released by version and build. A version change constitutes a major change or addition of features.

Those feature changes will be specified on this site. A change in build number means some bug(s) have been addressed. These fixes will also be noted on this site, or in our up-and-coming "bug database".

Eclpss V2.0-b3 Features

Preferences has additional fields and features to customize the GUIs and tailor model execution.

Eclpss V2.0-b2 Features

Framework and framework-generated models run under Mac OS X

Eclpss V2.0-b1 Features

In the Model Runner

Workspace Viewer Pause the Model Runner at various times during the simulation and view workspace from the Model Runner window to see the values currently in the grid.

In the Model Editor

Red-Black Tiling An option to run a simulation in parallel using red-black (checkerboard) tiling. Select this type of parallel execution if you are doing, for example, a Gauss-Seidel iteration which reads the north, south, east and west neighbors.
Grid Bounds Checking After ensuring a simulation runs correctly, an option to eliminate grid bounds checking to improve performance time of the simulation.

Several bug fixes.

Eclpss V1.2-b0 Features

Model Editor

Data Input and Output Component Generator These data component generators let you scale the state variable data.
- Input: you may initialize state variables either from a data file or with a constant.
- Output: to a file.
Color Gradient Swatches The Graphical Component Editor now displays a swatch of the color gradient that you select for minimum and maximum values. In addition, this gradient, along with the minimum and maximum values, is also displayed in the simulation!
Plotting Data This new feature allows you to plot data, e.g., Average temperature over time. A "Plotting Data" in the guided tour section will soon be available.

Several bug fixes.

Eclpss V1.1-b0 Features

Model Editor
- State Variable Report - A table that lists which SVs are read/written by each component.
- Graphical Component Generator - now saves your graphical specification
Several bug fixes.

Eclpss V1.0-b1 Features

Model Editor
Execution Groups - exist in all methods: Pre-Sim, Sim, and Post-Sim.

Eclpss V1.0-b0 Features

Model Editor
- Execution Groups - allow you to tailor the execution profile of groups of Sim methods.
- Constituent Panel - makes adding/removing/editing model constituents much more visual and also much easier
- Graphical Component Generator - a GUI which lets you specify colors for minimum and maximum values of SV attribute. It generates the code that displays the SV attribute graphically between the two colors.
- Memory Model - You select the type of execution for each Execution Group in Sim: Fully parallel (default); synchronized; sequential

Units - The J.A.D.E. Java Units API is now incorporated into the Eclpss framework. This allows you to use existing "known" units, or create your own units.

Eclpss V1.0-b0 Bug Fixes

The new model constituents panel allows users to add and remove components properly, thereby eliminating the problem of duplicate components.

State Variables are now checked for consistency before being added to a model.

Email questions, bugs, comments to w e n d e r @ c s . o s w e g o . e d u