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:
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.
Get the recent a stable release as:
wget -O scavis.zip http://sourceforge.net/projects/scavis/files/latest/download unzip scavis.zip ./scavis.sh # run ScaVis IDE
One can also use a devolomenent (unstable) version as:
wget -O scavis.zip http://jwork.org/scavis/download/current.php unzip scavis.zip ./scavis.sh # run ScaVis IDE
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.
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.
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.
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.
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] jwork.org
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 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.
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).
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.