You are a guest. Restricted access. Read more.
SCaVis manual


First, make sure that the JAVA virtual machine is installed. Simply click on this link to check the JAVA version. For Linux/Mac, one can also check the JAVA by typing in the terminal:

java -version

You will see:

java version "1.7.0_05"
Java(TM) SE Runtime Environment (build 1.7.0_05-b06)
Java HotSpot(TM) Server VM (build 23.1-b03, mixed mode)

or a similar message.

You can install Java using this link Java install page. You can install JAVA JDK (for developers) from the Oracle JAVA download page. The JDK JAVA version allows to compile JAVA code using ``javac'' compiler. Linux/Mac users usually have JAVA installed by default.

SCaVis Installation

Get the most recent file from the SCaVis Download Web page, where “VERSION” is the current version.

SCaVis 1.0 and above requires Java version 1.7.X. You can use Java 1.6.x to run jHepWork version 3.4 (and below). It is not recommended to run SCaVis IDE using OpenJDK on linux, since it misses some cryptographic libraries and fonts.

For Linux/Mac:

Get the recent a stable release as:

wget -O
./     # run ScaVis IDE

One can also use a devolomenent (unstable) version as:

wget -O
./     # run ScaVis IDE

For Windows:

Download and unzip the scavis-[VERSION].zip file, where [VERSION] is a version number. This creates the directory scavis-[VERSION]. Go to this directory, and the subdirectory “scavis”, and click the file scavis.bat. This executable Windows file will launch the SCaVis. Alternatively, click the file scavis.jar.

Generic installation using jPort menu

Instead of unzipping the ScaVis files, consider using the jPort portable desktop menu. This method works for all platforms (Windows, Linux and Mac), and you can carry ScaVis on a USB flash drive. In addition, you can install other jWork.ORG applications.

Additional information

SCaVis always put its installation files inside the “scavis” directory. It never modifies your Windows system files nor change the Windows settings. This means that removal of SCaVis is very simple - just remove the directory “scavis”!

For Mac, Linux and UNIX, one can put the file “” to the


directory, so one can start SCaVis from any directory. In this case, one should set the variable “JEHEP_HOME” (defined inside the script “”) to the directory path where the file “jehep.jar” is located.

The full members have access to the professional edition of SCaVis-Pro. This version periodically receives bug-fix updates scavis-[VERSION] (note “pro” string).

General comment

First time when you run “” (Linux/Unix/Mac) or “scavis.bat” (Windows), you will see the 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 Jython finishes caching Java 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, SCaVis IDE starts very fast.

Quick check of examples

You can run all SCaVis examples using the menu [Tools]-[Examples]. This brings up a window with free examples. Select any file and click [Run] (from this dialog, not from the IDE toolbar). Look at the YouTube ScaVis clip which shows SCaVis Online examples.

You can also use free examples using [Online examples]. You can run and view only free examples (marked with the red letter F). If you run SCaVis-Pro, you can view and run all examples.

Activation of SCaVis-Pro

If you have a full membership, you can activate SCaVis-Pro as this: download and run the free SCaVis version. Then, go to the SCaVis toolbar and select [Help]→[Activate]. You need to enter your username (not password!) that was requested by you for full membership.

SCaVis-Pro can be used for a commercial purpose, plus it has full access to built-in examples [Tools]→[Online examples], SCaVis manual, full Java API, online examples,source code etc.

In a few situations, the activation may fail (when, for example, you do not have correct network settings). Then request the password by sending email to scavis [at]

Updating SCaVis

Simply remove the directory “scavis” (if you did not create your files inside the directory “scavis”!). Then unzip the zip file with a new version. SCaVis periodically checks that you are running the most updated version.

If you are using SCaVis-Pro (professional) version, you should receive updates of separate jar libraries on a regular bases and thus there is no need to reinstall the entire program. This helps keep all of the numerical libraries on your computer up-to-date.

To make sure that your computer use the latest SCaVis libraries, check [Help]-[Update]

Uninstalling SCaVis

To uninstall SCaVis is simple: just remove the directory “scavis” with your installation (for windows/linux/mac). SCaVis never leaves any files in your system directory or changes Windows register.

Libraries for Eclipse and NetBeans

You can download single-jar file which does not contain IDE. This jar files can be used for import to Eclipse or NetBeans IDE (both good to work with Python or Java). These jar files are available for SCaVis full members as described here netbeans. You can also download a minimalistic jar file (~10MB) which can be deployed for applets.

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 class of SCaVis. In addition, one can write structural data using a C++ code and read them back using SCaVis (class EFile).

Installation for multiple users

The description discussed above concerns a single-use installation. It may be convenient to install SCaVis in a central location (for example on a shared directory on NFS) so all users will be able to run run the program. Below is a step-by step instruction describing how to do this.

This advanced section is available for the full members. Click the link for the full membership here.

<< back

man/general/installation.txt · Last modified: 2015/01/25 20:38 by admin
CC Attribution-Share Alike 3.0 Unported
Powered by PHP Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0 Valid HTML5