jHepWork
  jHepWork
  Multiplatform data-analysis framework
Google
Web This Site

Latest news

jHepWork 2.2
Changelog:
- PFile based on Google's protocol buffers
- Can be used to write/read data from C++ (CBook package)
- Faster startup.
- Improvements for Mac LookAndFeel
- Rectangle zoom-in for HPlot

Contact

jhepwork(AT)jwork.org
(replace (AT) with @)

Other links:

jHepWork downloads


Download the latest version from (usually updated every two weeks): jHepWork download page

Mirror pages with the stable versions

SourceForge mirror
HepForge mirror

Installation

Unzip the downloaded file. This creates the directory jhepwork-[version]. jHepWork is ready! Run the script ``jhepwork.sh" for linux/unix or ''jhepwork.bat`` for Windows. Make sure that a JAVA virtual machine is installed. The program can run only using Java version 1.6 and above ( jHepWork 1.6, can run on Java version 1.5 as well). If you plan to run java code which has to be compiled, you should install the JDK (which includes ``javac'' compiler).

Check JAVA by typing ``java -version'' . If JAVA is installed, you should see

java version "1.6.0_10"
Java(TM) SE Runtime Environment (build 1.6.0_10-b33)
Java HotSpot(TM) Server VM (build 11.0-b15, mixed mode)

or a similar message. If not, install the recent java JRE (Java Runtime Environment) from the SUN web page

For Mac, Linux and UNIX, one can put the file "jhepwork.sh" to the "$HOME/bin" directory, so one can start jHepWork from any directory. In this case, one should set the variable "JEHEP_HOME" (defined inside the script "jhepwork.sh") to the directory path where the file "jehep.jar" is located.

First time you execute the "jhepwork.sh" (Linux/Unix/Mac) or "jhepwork.bat" (Windows), you will see many messages such as:

*sys-package-mgr*: processing new jar, 'jhplot.jar'
*sys-package-mgr*: processing new jar, 'jminhep.jar'
etc., etc.,

This is normal: you should wait until scanning of the Java libraries is done. When Jython cashes the jar libraries, it creates the directory "jython/cachedir" with the description of all classes located in jar files defined in the CLASSPATH variable. Next time when you execute the start-up script, jHepWork IDE will start very fast as the package cache is ready (of course, if you did not modify the Java CLASSPATH before starting the jHepWork IDE).

Note for Mac users: Please check the java version. On most Mac OS, the default java version is 1.5, while jHepWork was compiled using the version 1.6. This means you will see the error "java.lang.UnsupportedClassVersionError: Bad version number" when executing the script "jhepwork.sh". You should select change the Java version to 1.6 and above before running "jhepwork.sh" script. Look at this article How to change default Java version on Mac.

Quick check of jHepWork examples

You can run all jHepWork examples using the menu [Tools]-[jHPlot examples]. This brings up a dialog with Jython examples. Select any file and click [Run] (from this dialog, not from the IDE toolbar).

The code assist based on Java reflection

For JythonShell, simply instantiate any object (for example, define a string as a="string"), and check the methods of the object "a" by typing "a." and then pressing [Ctrl]+[Space].

For jeHEP editor, the code assist works differently. For the above example, type "a." and press [F4].

CBook package

If you are working with a C++ program and you will need to visualize data using Java or Jython, then you will need the CBook C++ package. This package allows you to fill histograms and vectors in a C++ code, and write them in a "pbu" file which contains zipped data records based on the Google's Protocol Buffers format. One can read such files using the jhplot.io.PFile class of jHepWork. In addition, one can write structural data using a C++ code and read them back using jHepWork (class EFile).

jHepWork version information

jHPlot code for the stable release