Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Installing JAS3

Java Analysis Workstation 3 (JAS3) is a graphical workbench application that can be used for viewing and manipulating AIDA histograms, viewing event displays, and looking at basic information contained in LCIO files.

Before You Start

If you have installed JAS previously, then you may want to remove the existing plugin configuration to avoid conflicts with the new installation.

...

The new plugin jars will be downloaded automatically later when configuring the plugins within JAS.

Getting the Distribution

You can download the latest distribution from the download area or use a command like this.

No Format
wget http://java.freehep.org/maven2/org/freehep/jas-assembly/3.12.211/jas-assembly-3.12.211-distribution.tar.gz

The above wget command is just an example using a specific version. 

In general, the current distribution listed in the download area should be used rather than some older one.

Installing the Distribution

Once the tarball is downloaded, you can unpack it with a Unix command.

No Format
tar -zxvf jas-assembly-3.12.211-distribution.tar.gz

This will create the directory jas-assembly-3.12.2 which 11 which is the root directory for running JAS.

...

The rest of the configuration will be done within JAS itself.

Running JAS

You can run JAS from the command line using a simple command such as the following.

No Format
 ./jas-assembly-3.12.211/jas3

You should now see the GUI load.

It is also possible to setup a command shortcut pointing to this script.  (Doing this depends on the specifics of your operating system and/or window manager.)

Installing the Plugins from HPS Java

When developing HPS Java, you may want to update JAS3 with changes from your local installation. 

The plugins are installed automatically when building the entire hps-java trunk.

No Format
cd hps-java; mvn install -DskipTests

Configuring Plugins

This will make sure that JAS sees your local version of the HPS Java Plugin and is the preferred method for installing the plugins.

Configuring Plugins

One can also install the plugins without having a local installation of hps-java, although this method can fall behind or not find the correct plugins at timesNext we need to configure the plugins using for analyzing HPS data.

In the View menu, click on the Plugin Manager item and find the HPS Java plugin in the tree menu under hep > hps.

...

Info
titleHow Do JAS3 Plugins Work

JAS installs jar files for plugins into ~/.JAS3/extensions which are then automatically loaded when the application starts.  An XML configuration file located in a standard place within the jar allows it to be used and configured as a plugin by the application.

Installing the Plugin from HPS Java

...

.

...

It can be installed by itself as follows.

No Format
cd hps-java/plugin; mvn

Once this is done, you will need to restart JAS for it to load the modified jar files.

The plugin is also installed automatically when building the entire trunk.

No Format
cd hps-java; mvn -DskipTests

This should make sure that JAS sees your local version of the HPS Java Plugin.

 

...