Installation of RayGUI
Linux Users: If you are using g77 as a FORTRAN compiler, you are likely to run into trouble compiling jrayinvr, rayinvr, xrayinv2. You may have to modify the source codes. Check this first before attempting to install the whole package.
- Make sure, JAVA is running and paths for Java are set
- You need a directory /tmp with global write permission
- Unzip and un-tar raygui_XX.tar.Z or raygui_XX.tar.gz (XX: version no.). This creates a directory raygui which contains three sub-directories:
gui: Graphical user interface
rayinvr: rayinvr package from
Colin Zelt (email@example.com), slightly modified, together with some auxiliary programs.
graph: Java 2D Graph package Vers. 2.4 from
- Add setenv CLASSPATH .../raygui/gui/classes:.../raygui/graph/classes:/usr/java:.
to your environment. "..." here and hereafter denotes the path above raygui. The third path depends on where JAVA is installed on your system. Don't forget to include "." in the CLASSPATH environment.
- Add .../raygui/rayinvr/bin and /tmpto your path; this is for rayinvr and other executables.
- Test, if Java 2D is working: Open with browser
You should be able to run the applets: Example 1 should display a y=x^3 graph in green. If this does not run, try to compile the package in ...raygui/graph/source. There is a Makefile.
If some other examples do not run, don't worry too much. Complete documentation of the package should be found under file:...ray_gui/graph/Top.html.
Ray-tracing and graphical user interface:
- Compile rayinvr and auxiliary programs. Go to ...raygui/rayinvr. Modify Makefile. Compile as follows:
RayGUI invokes jrayinvr, not xrayinvr2, however, xrayinvr2 should be used to test if the installation went fine and if there are any problems with running RayGUI. There are old rayinvr Makefiles in the rayinvr directories. They are not used for installation but may be helpful, if compilation fails using the Makefile in ...raygui/rayinvr
- Check that the directory ...raygui/rayinvr/bin exists
- make clean: clean all *.o files
- make xrayinvr2: X-version of rayinvr
- make jrayinvr: version of rayinvr which is invoked by for RayGUI
- make xvmodel: X-version of vmodel, a program to test, edit, and plot velocity models
- make misc: auxiliary programs. Solaris users: rayplot probably won't compile. Don't worry, you don't need it anyway.
- make chform_vm: conversion of models from/to ray_window to/from rayinvr
- make clean: clean all *.o files again.
- Check if xrayinvr2 and are working:
- Go to ...raygui/gui/examples/test
- Call jrayinvr. This should run without error messages.
- Call xrayinvr2. This should give a velocity model and a ray diagram. If it is against a black background, something might be wrong with the color tables. This does not affect RayGUI - so don't worry.
- The RayGUI JAVA classes are in ...raygui/gui/classes. They should be ready to go. If not, change to ...raygui/gui/code and "make all". See Makefile for details. Some deprecation warnings are OK.
- Check if RayGUI is running:
If this does not work, call xrayinvr2 and/or jrayinvr to check error messages. If both fail, the error is most likely in the r.in file. Check with a text-editor.
- source rayInit copies scripts from ...raygui/ray_scripts to /tmp. These are simple csh scripts which may need some modifications under other environments.
- Go to ...raygui/gui/examples/test
- Call java ray_window -- a window Rayinverse GUI should pop up. If not, try to compile RayGUI (see above)
- Click menus >File>Open model. ">" denotes a menu or sub-menu. Select v.ray. A simple model should be displayed.
- >Properties>Show Time Plots and >Properties>Show Rays.
- Click >Set Range in the TIME PLOT window. Headwaves from a shot generated at 2.8 km should be displayed together with computed traveltimes (red) and picks (blue). This shows, that the GUI is running.
- >File>Output v.in. Check that v.in was created in rayinvr format (check date of file). May take a few seconds.
- This is the actual test for jrayinvr: rename the file tx.out to e.g. tx.old.
>Run rayinvr in the Rayinverse GUI window. A new menu should pop up.
>Run. After a few seconds, the file tx.out should be re-created. tx.out and tx.old should be identical. If tx.out has not been created, something went wrong with jrayinvr.
Back to top page
Questions and comments? firstname.lastname@example.org
Last revised Apr. 10, 2002