This is "COJAC" ... a prototype geometry viewer for Geant3 rz or fz files.

This is the Linux readme.

Overview
========

COJAC is a Java application that uses Java3D to render Geant3 volumes. It also
contains code to load events from an Objectivity database and render them in
the detector. COJAC calls a run time library via the Java Native Interface (JNI).
This run time library is a small set of JNI C routines that call a small set
of Fortran routines, which in turn call Zebra routines in the CERN Program Library.

Prerequisites
=============

Java JDK 1.3 or above (available at www.java.sun.com)
Java3D 1.2 or above (available at www.blackdown.com)
OpenGL runtime (see instructions that come with Blackdown Java3D)
gcc and g77
CERN Program Library files packlib.a mathlib.a kernlib.a

Build procedure
===============

source the "setup" file provided to set the LD_LIBRARY_PATH, PATH and
CLASSPATH environment variables. You may well need to alter the directory
names specified in "setup"

source the "build" file provided. This builds some test executables which
are run against a Geant3 file called "cms113.rz" (not provided). It then
builds the shared library libG3.so.

Execution
=========

Invoke COJAC using "java COJAC <myfile.rz>"

where myfile.rz is the name of the Geant3 file.

By default, detector volumes down to 4 nested levels are treated. The control
panel allows to increase or decrease the detail level. But beware of running
out of memory at high detail levels.

A picture of the appearance of COJAC is in the archive as "COJAC.jpg".


Julian Bunn
Caltech Center for Advanced Computing Research
julian@cacr.caltech.edu

