DIGSTATS Java 3D Slicer is a Java program designed to run over the internet with a web browser. It aids in visualization of three dimensional datasets by displaying a slice, or cross-section, of the dataset. The position and angle of the slice is modifiable by various controls within the program. The applet has been tested with Netscape Communicator 4.05 and Microsoft Internet Explorer 3.0, though it runs much faster under Netscape because of certain optimizations in the Netscape Java Virtual Machine.
The program starts with an empty data set. Choose a file from the drop down box in the upper-left hand corner of the window (some files are larger than others and will take more time to load). Once the file is loaded, the first data set is automatically displayed. Files with multiple data sets will list them in the drop-box in the upper-right hand corner. It may take a moment to convert the data to a format usable by your machine and to map the data to colors for display, but this is only done once, each time the data set is loaded.
The applet is capable of viewing any HDF file on the server, not just those in the drop-box. If you wish to view a file not in the list, simply select "Open URL..." and enter the address of the file you wish to view. The file is added to the list and then loaded. Note that because of security restrictions imposed upon the Applet by Java, you cannot enter the URL of a file on your own local hard-drive, or a server other than that where the applet was started from. To do this, you will need to download the applet and run it outside of your web-browser.
Across the top lie drop-boxes for selecting a file to load, and for selecting a particular data set to view if the file has more than one. A box to the left of the window, the viewport, displays the actual slice. Underneath it is displayed the X, Y and Z coordinates of a particular piece of data in the data set. You can view the numerical values of different points by moving the mouse over the slice being displayed. In the center lies a color legend, showing what the colors displayed in the viewport represent, and a wire-frame box with a polygon inside representing position of the current slice being displayed. On the right are controls for adjusting the position of the current slice.
When moving the mouse over the slice currently being displayed, four fields at the bottom of the window will tell you the X, Y and Z coordinates of the point the mouse is over, plus the value of the data at that point. If the data set defines a range for each variable different from the number of data entries along that axis, these coordinates will be in that range. The slice position, however, is still adjusted by the number of data entries present along each axis.
If you wish to view HDF files that are not on a web-server, but instead are on your own local hard-drive, you will need to run the viewer outside of a web-browser in order to avoid the security restrictions placed on applets. You will need several things in order to do this.
Once you have downloaded and installed the Java Virtual Machine (following
the instructions from the web-site you obtained it from), simply create a
directory for the program, and extract the files from Slicer.zip,
making sure you preserve the directory structure stored in the file (you
should now have two subdirectories: Slice3D and hdf).
Now you just need to start the Java interpreter with the
Slicer class file.
Using Sun's JRE or JDK, it may be possible to launch the applet while it is still compressed in the .ZIP file, with one of the following commands:
jre -cp Slicer.zip SlicerOr,
java -cp Slicer.zip Slicer
The initial list of files present when you start the viewer is located in a file called index.slice. This file is simply a list of data set name/URL pairs, one line each, such as:
My Data mydata.hdf My Other Data http://www.myserver.com/somedir/myotherdata.hdfAn optional
endmay appear by itself on the last line. This file should be placed in the same directory where the viewer is started, and all URL's are resolved relative to this position. Note that Applet security restrictions prevent the Applet from loading a file from any server other than the one it was started on. These restrictions do not apply when the viewer is run on its own Java Virtual Machine outside of a web-browser.