Web: Installation on Mac OSX

1. GENERAL

   Web is a point-and-click interface for display and interaction with SPIDER images and data. Web is written in C for use with the X WINDOW system under Motif. Thanks to Dr. Ngai Shing Mogk and Dr. Neil Ranson from the University of Leeds for the original port of Web for use on OSX.

2. INSTALLING THE SPIDER/WEB DISTRIBUTION
   (May have already been done if you have installed SPIDER!)

   1. Download SPIDER/Web and place it in an appropriate directory: PARENT-DIR.
      The uncompressed whole distribution will take about 850Mb but includes libraries and executables for several different systems some of which can be discarded.
   2. Unpack the compressed tar archive e.g.
      tar --gunzip -xvf spiderweb.tar*

   The following Web directories will be created under: PARENT-DIR (along with other directories for SPIDER, etc.):

   Directory	Contents
   web/src	Web source code, libraries
   web/src/osx	Openmotif code, libraries
   web/bin	Web executables
   web/docs	Web documentation
   web/rgb	Color look-up-tables
   web/jweb	JWeb directory

3. SETTING "Web" COMMAND AND ENVIRONMENT VARIABLES

   The PARENT-DIR/web/bin directory contains following OSX executable binary files:

   For Platform	Startup file	Executable	Visual	Libraries	Makefile
   OSX 10.4+ on Intel	None needed	web_osx_tru	24 bit Truecolor	Static OpenMotif	Makefile_osx_tru
   OSX 10.5+ on Intel	web_osx_8.sh	web_osx_8	8 bit	Static OpenMotif	Makefile_osx_8
   OSX 10.4 on Intel	web8-osx.zsh	web_osx_8	8 bit	Static OpenMotif	Makefile_osx_8

   OSX 10.4+

   If you are on a Intel based system running OSX 4+ try the web_osx_tru executable first. It does not require any startup script and simply runs by itself. If it is unacceptably slow you can try the older 8 bit executables instead.

   You will need to tell your system the location of your Web executable, and other Web related files. If you are using the 'C' shell, you should edit PARENT_DIR in the following line to point to the location of the web installation on your system. Finally place both of the following lines in your .cshrc startup file: (If you do not have a .cshrc file in your home directory you can create it with any text editor.)

   alias web       "PARENT_DIR/web/bin/web_osx_tru"
   setenv SPRGB_DIR "PARENT_DIR/web/rgb"
   

   OSX 10.5+

   The Web startup script: web_osx_8.sh allows use of Web's 8 bit visual on a machine which has been set to use a 24 bit visual (i.e. 'millions' of colours in the X11 preferences menu). However this will only work if no 24 bit X11 software is currently running on the machine (i.e. the X11 application is NOT present in the Dock). We have not yet found a way to use this Web when 24/32 bit X11 applications are already running. However some X11 applications e.g. xclock can be started in the normal OS X 10.5 manner after Web without problems.

   You will need to tell your system the location of your Web executable, and other Web related files. If you are using the 'C' shell, you should edit PARENT_DIR in the following line to point to the location of the web installation on your system. Finally place the following four lines in your .cshrc startup file: (If you do not have a .cshrc file in your home directory you can create it with any text editor.)

   setenv WEB_DIR    "PARENT_DIR/web"
   setenv WEBBIN_DIR "$WEB_DIR/bin"
   setenv SPRGB_DIR  "$WEB_DIR/rgb"
   alias  web       "$WEBBIN_DIR/web_osx_8.sh"

   Before OSX 10.5

   The Web startup script: web_osx_8.zsh allows use of Web's 8 bit visual without interfering with use of other applications which need a 24 bit visual (i.e. 'millions' of colours in the X11 preferences menu).

   You will need to tell your system the location of your Web executable, and other Web related files. If you are using the 'C' shell, you should edit PARENT_DIR in the following line to point to the location of the web installation on your system. Finally place the following four lines in your .cshrc startup file: (If you do not have a .cshrc file in your home directory you can create it with any text editor.)

   setenv WEB_DIR    "PARENT_DIR/web"
   setenv WEBBIN_DIR "$WEB_DIR/bin"
   setenv SPRGB_DIR  "$WEB_DIR/rgb"
   alias  web       "$WEBBIN_DIR/web_osx_8.zsh"

4. TESTING Web

   Use your web command to start Web.
   You may enter the SPIDER file extension on the startup command line, e.g.: web dat

   To control Web: USE MOUSE TO SELECT MENU ITEMS FROM PULL-DOWN MENUS

   Further information is given in the Web manual.

5. PROBLEM SOLVING

   If Web does not run

   • If you get an error message like: Command not found

     See "Setting Web command" above to ensure that your desired executable is accessible.

   • If you get an error message about a Missing library ...:

     Ensure that the following run time libraries are installed from your distribution:
     libXm, libXt, libX11, libXmu, libXau, libXdmcp, libfreetype and libXext.

     Also you may need to tell Web the location of dynamic X Window and Motif libraries. These X-Window libraries may in:
     /usr/X11R6/lib.

     If you are using the 'C' shell add the following lines to your .cshrc startup file:

     if ( $?DYLD_LIBRARY_PATH ) then

     setenv DYLD_LIBRARY_PATH '$DYLD_LIBRARY_PATH:/usr/X11R6/lib'

     else

     setenv DYLD_LIBRARY_PATH '/usr/X11R6/lib'

     endif

   • If you get another error message or no error message:

     Early Leopard releases of OSX 10.5 have significant problems with X11 applications. Try upgrading to more recent OSX release.

   • If Web still does not run:

     Try compiling and linking Web on your system. This is usually easy if you have already installed the necessary X-window and Motif development headers and libraries on your system.

   If Web runs but the whole Web application is blank.

   • This occurs with earlier X11 releases for OSX 10.5.

     Install the latest X11 version.

   If Web runs and but the other windows on the screen have strange colors when the Web window is in use (has focus).

   • You must be using the alternative 24 bit Web executable . This behaviour is expected for 24 bit Web. We recommend you use 8-bit Web and the Web startup script: web_osx_8.sh, described above, which does not have this problem).

6. FURTHER PROBLEMS, BUGS, & SUGGESTIONS

   If you are still unable to get Web to run properly or you have questions about methodologies, or wish to report bugs please contact us. Please include complete info on what you are trying to do, exact error messages, OS version, platform (PPC or Intel), and the value of environment variable: DYLD_LIBRARY_PATH.

   ArDean Leith
   phone: 518-486-5604
   email: spider@wadsworth.org