Table of Contents
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:
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.
Get the most recent scavis-VERSION.zip file from the SCaVis Download Web page, where “VERSION” is the current version.
wget -O scavis.zip http://jwork.org/scavis/download/current.php
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.
Unzip the downloaded file scavis-[VERSION].zip, where [VERSION] stands for a version number. Or simply do this in the prompt:
wget -O scavis.zip http://jwork.org/scavis/download/current.php unzip scavis.zip
Then start the IDE as:
cd scavis ./scavis.sh
Alternatively, you can start the IDE using the command: “java -jar scavis.jar” (note the limitation discussed above).
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.
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 “scavis.sh” 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 “scavis.sh”) 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]pro.zip (note “pro” string).
First time when you run “scavis.sh” (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.
Note for the Mac users: Please check the java version. On most Mac OS, the default java version is 1.5, while SCaVis was compiled using the version 1.6. This means you will see the error “java.lang.UnsupportedClassVersionError: Bad version number” when executing the script “scavis.sh”. You should select change the Java version to 1.6 and above before running “scavis.sh” script. Look at this article How to change default Java version on Mac.
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 ScVis-Pro
If you have a full membership, you can activate SCaVis-Pro as [Help]-[Activate], and entering your ScaVis user name (not password!) as requested using the full membership link. SCaVis-Pro can be used for a commercial purpose and have full access to online examples ([Tools]-[Online examples]), wiki, Java API, source code etc.
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.
This is very 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.
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 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.
You are done. Now any user can run the program by executing “jh” command.