SPIDER Installation on Windows

CONTENTS

1. LOADING THE DISTRIBUTION
2. INSTALLATION
3. DOCUMENTATION
4. RUNNING SPIDER
5. TESTING SPIDER
6. BUGS

1. LOADING THE DISTRIBUTION Code is distributed by ftp or by Internet download in compressed tar format. The distribution takes about 176 Mb of disk space but includes libraries and executables for different systems. Only about 17Mb is necessary for a single operating system. To load SPIDER use the following commands:

   cd PARENT-DIR

   (where PARENT-DIR is parent for desired location of SPIDER,assume it to be C:\)

   For Ftp delivery:

   Unzip the file, we suggest using Winzip. Winzip is a software for Windows to use Zip files and other archives in compression formats, you can download Winzip from your internet browser.
   There are two steps involved, first, extract the zip file, second, extract the tar file. During the first extraction, specify
   

   PARENT-DIR\spider
   

   ( spider is a new sub-directory for SPIDER, hereafter referred to as SPIDER_DIR)
   in the extract window. After that, be sure to rename the tar file with the extension .tar before opening it for the second extraction, and keep the path PARENT-DIR\SPIDER_DIR in the extract window.

   T he following directories will be created:
   SPIDER_DIR ------------ installation instructions
   SPIDER_DIR\src -------- source code, libraries
   SPIDER_DIR\bin -------- executable files
   SPIDER_DIR\man -------- ASCII documentation, Nextresults
   SPIDER_DIR\docs ------- documentation
   SPIDER_DIR\proc ------- Sample proceedure files
   SPIDER_DIR\prints ----- hardcopy documentation
   
2. INSTALLATION
   • Installation of Executable.
     • Using Precompiled and Linked Executable.
       Use the following commands to run SPIDER in a terminal window:

       cd SPIDER_DIR\bin
       spider
       

       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 is accessible.
       If the SPIDER still does not run please contact us at the address below. Please send complete info on what you are trying to do, error messages, etc.

     • Compiling and Linking SPIDER. If you wish to modify SPIDER source code you will have to compile the source code on your computer. The precompiled executable spider.exe was created using Digtal Visual Fortan 5.0.
       See SPIDER Compilation and Linking for Windows for information on compilation of SPIDER.

   • Other Installation Tasks.
     • Setting "spider" Command. You can define an alias for your SPIDER location. You would put a line similar to the following in your AUTOEXEC.BAT startup file:

       DOSKEY spider=C:\SPIDER_DIR\bin\spider.exe
       

       Alternatively, you can modify your path so that your system can locate the executable file when you type "spider". To alter your path add the following to the PATH environmental variable in the Start->Settings->Control Panel->System ->Environment tab:

       C:\SPIDER_DIR\bin
       

       or,

       put following in your AUTOEXEC.BAT startup file:
       

       PATH=%PATH%;C:\SPIDER_DIR\bin
       

     • Memory allocation.
       If your system complains about a lack of swap space, then you will have to increase the swap space on your computer. A less satisfactory alternative is to edit spider.f to decrease MAXDI, and remake your SPIDER system. SPIDER is distributed with a unlabeled common size of 28 Mb. Most SPIDER subroutines allocate their own memory at runtime and no longer use large amounts of space from the unlabeled common.

   • DOCUMENTATION There is an overview of SPIDER documentation in the file: documents.html in the SPIDER_DIR\docs sub-directory. All SPIDER documentation is included with the distribution and is easily accessible via your World-Wide-Web browser (e.g. Netscape). Just point your browser at: SPIDER_DIR\docs\spider.html

   • RUNNING SPIDER
     • All SPIDER files must have a three letter extension (or datacode). This extension is automatically added by SPIDER.

     • The SPIDER "RESULTS" files are named results.ext.? where "?" is incremented for existing results file in that directory.

     • Since the character "X" is used as a flag for register substitution in file names you should avoid the use of "X" in any filenames except for this purpose. If the last two characters of a filename consist of a digit followed by a alphabetical character this is a flag for substitution of a loop counter. You should avoid such filenames except for this purpose.

   • TESTING SPIDER Some simple tests are available to see if SPIDER is installed correctly.

   • 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 relevant results files, procedure files, and error messages.

     Send this info to:

     ArDean Leith
     Wadsworth Labs, P.O. Box 509, Albany, New York 12201
     phone: 518-486-5604
     fax: 518-486-2191
     email: spider@wadsworth.org