WEB : Installation on Linux with 24 bit Visual

Contents of this document

1. GENERAL
2. LOADING WEB
3. INSTALLATION
4. TESTING WEB
5. BUGS

GENERAL

WEB is a point-and-click interface for display and interaction with SPIDER images and data. WEB is written in C for the MOTIF/X-WINDOW system. WEB has been developed and tested on SGI computers. If you have a Linux computer, you will need a C compiler and MOTIF development software on your computer to be able to compile and link WEB. These instructions will create a Web executable for use on Intel PC with files having byte ordering same as SGI byte ordering. The modifications for use on a 24 bit color Visual were provided by Dr. Erik Vogan. I believe that these modifications allow use of most of the common WEB operations, however operations such as "Power Spectrum" and "Masking" will fail to work on this visual until I get them fixed.

LOADING WEB

cd PARENT-DIR

(where PARENT-DIR is parent of desired location of Web)

mkdir web

(creates a new sub-directory for Web, hereafter referred to as WEB_DIR)

cp -r "your_cdrom_device"/web/* web

The following directories will be created:
WEB-DIR/src -------- source code, libraries, executables
WEB_DIR/docs ------- documentation, html pages
WEB_DIR/rgb -------- rgb color look-up-tables
WEB_DIR/AppPlusS ---- AppPlusS widget for Linux 24 bit


INSTALLATION

• Compiling and Linking the Executable. You will have to compile the source code on your computer. Use the following commands to compile and link WEB:

  cd WEB_DIR/AppPlusS
  xmkmf -a ; make ;
  cd WEB_DIR/src
  make -f Makefile_linuxieee24 Web_linuxieee24
  xrdb -load Web_resources_linux24 ; xrdb -query

  Do not worry if the "make" of AppPlusS fails to create an executable all we need is the library.
  If anything fails or the new executable does not run, contact us at the address below.

  Note: The archive (ar) command in the Makefile may use a lot of space in your TMPDIR. If you get a message about no space being left on your device I suggest you redefine TMPDIR to a directory that has space (e.g.):
  setenv TMPDIR /usr/tmp

• Other Installation Tasks.
  • Setting "web" Command. You can define an alias for your WEB location. If you are using the 'C' shell, you would put a line similar to the following in your .cshrc startup file, depending on the version of WEB you intend to use:

    alias web WEB_DIR/web_linuxieee24
    

    Alternatively, you can modify your path so that your your system can locate the executable file when you type "web". To alter your path add the following to the PATH environmental variable in your startup file:

    WEB_DIR
    

    then rename the web_linuxieee24 executable in WEB_DIR to: web.

  • Setting environment variables.
    Set environment variables for the location of your *.rgb color-look-up-table files. If you are using the 'C' shell, you should put lines similar to the following in your .cshrc startup file:

    setenv SPRGB_DIR "YOUR_RGB_FILE_DIR/"
    setenv WEBMAN_DIR "WEB_DIR/docs"
    

    Sample color look-up-tables are provided in the rgb sub-directory of web.

• Setting X-Window visual.
  Web was written for an 8-bit false-color visual. Dr Erik Vogan has provided these modifications for use with a 24 bit Visual. We believe that this works for the most common Web operations. However I believe that operations that use an overlay such as the "Masking" operation will fail to work properly!

TESTING

To test web use the following command:


web
USE MOUSE TO SELECT MENU ITEMS FROM PULL-DOWN MENUS


Further information on the use of WEB is given in the web manual.

You may enter the file extension on the command line, e.g.:


web dat


BUGS, SUGGESTIONS

Please send any bug reports to:
ArDean Leith
phone: 518-486-5604
fax: 518-486-2191
email: spider@wadsworth.org
www: http://www.wadsworth.org/spider_doc/web/docs/web.html