Web Icon WADSWORTH    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*
    3. 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 Web runs but the whole Web application is blank.

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

  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




Source: web-inst-osx.html     Updated: 09/29/11     ArDean Leith