web : INSTALLATION ON SGI

Contents

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

GENERAL

Web is a point-and-click interface for display and interaction with SPIDER images and data. Web is written in Cfor the MOTIF/X-WINDOW system. Web was developed and tested on SGI and DEC Unix computers.

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
WEB_DIR/bin ---------- executables
WEB_DIR/docs --------- documentation, html pages
WEB_DIR/rgb ---------- rgb color look-up-tables
WEB_DIR/AppPlusS ----- AppPlusS widget for Web_linux_24
WEB_DIR/AppPlusS_64 -- AppPlusS widget for Web_linux_24 64-bit OS


INSTALLATION

• Installation of Executable.
  • Using Precompiled and Linked Executables.
    The WEB_DIR/bin directory should contain the following executable binary files: web2, web3 and web4 for use as follows .

    web	Processor	Irix
    ------	--------------------	----
    web4	R5000,R8000,R10000	6.*
    web3	R4***	6.*
    web2	R4*** up	5.3

    If you are confused which Web to use, I suggest you start at the top of the above list and use the first executable that successfully runs on your specific SGI computer. It should be optimal.
    In the following commands substitute the desired Web version (2, 3 or 4) for the "?". Use the following commands to start Web:

    cd WEB_DIR/bin
    web?
    

    If the executable binary does not run and you get an error message like: command not found see " Other Installation Tasks" below to ensure that your desired executable and any needed run-time libraries are accessible.
    If you are unable to get any Web to run, contact us at the address below. Please send complete info on what you are trying to do, error messages, etc.

  • Compiling and Linking Web. If you wish to modify Web source code, link Web with different libraries, or compile Web with different compilation options (e.g. change optimization levels) you may have to compile and the source code on your computer.
    See Web Compilation and Linking documentation for further information.

• 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/bin/web?
    

    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/bin
    

    then rename the web? executable in WEB_DIR/bin 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.

    You may need the following for run-time libraries if you use web3 or web4:
    

    setenv LD_LIBRARYN32_PATH=/usr/lib32:/usr/lib32/X11

• Installation on non-SGI Unix computers.
  See web-inst-dec.html for inststallation on DEC Unix computers. For installation on other Unix based computers, such as SUNs, the C code which we supply will have to be compiled and linked on those computers. Such compilation will require familiarity with your operating system to set the necessary flags for compilation and linking. You may also have to change the coding of the Makefile. Please understand that due to limited staff and equipment we may not be able to assist with some problems you may encounter porting Web to other computers. We offer sample Makefiles for Sun Sparc called Makefile_sunsparc in the WEB_DIR/src directory. We offer sample Makefiles for Linux called Makefile_linuxieee24 in the WEB_DIR/src directory.

1. Setting X-Window visual.
   Web is written for an 8-bit false-color visual. If your X-server is set for 24 bit true-color exclusively, you may have to alter the setting to allow use of an 8 bit false-color visual. See the SPIDER FAQ for further info.

TESTING WEB

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

In the event that you have questions about methodologies or wish to report bugs please send us complete info on what you are trying to do including any error messages.

Send this info 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