OBTAINING CASPR

IMPORTANT! If you dowload the code, please register with your name, email and postal addresses. Doing so will ensure that you are kept informed, via email, of bug fixes and updates.

CASPR may be obtained via anonymous ftp from stratus.ssec.wisc.edu. Make a directory for the CASPR subdirectories that will be obtained; e.g., mkdir caspr. Download the tar file caspr.tar.gz from the ftp site (some tar file may have version number, e.g., caspr501.tar.gz which is version 5.0.1 tar file). Optionally, download test/casprtest.tar.gz if you want the test images and profile data.

Next, put the tar file in the directory you created then uncompress and extract the tar file:

gzip -d caspr.tar.gz
tar xvf caspr.tar

If all goes well then you should have a number of subdirectories and you can delete the tar file.

If you downloaded the test images and profile data, then create a test subdirectory of the main caspr directory, move the casprtest.tar.gz file there, unzip and untar it, then delete the tar file.

THE MANUAL

Postscript versions of Part I and Part II of this manual are available via the download page.

INSTALLING CASPR

Installing CASPR involves two steps: setting environment variables and compiling those components written in Fortran 90 and C.

ENVIRONMENT SETUP

The following environment variables need to be set or modified: CASPR_DIR, the location of the main CASPR directory, IDL_PATH, the search path for IDL, and SHL_EXT, the filename extension used for the shared object libraries of the C modules (see below). The location of the CASPR files must be added to the IDL_PATH environment variables so that they can be used from any directory. In UNIX you can add the following to your .cshrc file:

source $HOME/progs/setenv_caspr

If your main CASPR directory is not $HOME/caspr then you need to modify the above statement appropriately and edit the setenv_caspr file.

Under Microsoft Windows 3.1 or 95 you can set the IDL_PATH environment variable in the autoexec.bat file. Also, set a TEMP environment variable to a directory that can be used for temporary files. For example:

    SET CASPR_DIR=C:\CASPR\PROGS
    SET IDL_PATH=+C:\IDL\LIB;C:\CASPR\PROGS
    SET TEMP=C:\TEMP

modifying the path C:\CASPR\PROGS appropriately. Under Windows NT 4.0 you should add the IDL_PATH variable to your environment via the System icon (in Control Panel) rather than editing autoexec.bat. Under all Windows versions you could instead edit the IDL path via IDL's Preferences dialog box.

Input image files may be compressed with either the Unix compress utility or with gzip. If one of these is used, then it must be in your search path. No verification of this is done. Results files may be compressed, but only gzip will be used. MSDOS versions of both of these compression programs are available at the same ftp site as CASPR.

Note that when transferring image and results binary files between UNIX and DOS, bytes must be swapped. Procedures for performing this conversion are described in the User's Guide.

COMPILING C CODE

In a few cases it was not practical to write IDL code to operate on entire arrays (images). For speed considerations these procedures were written in Fortran and C. IDL allows calls to external routines via the call_external procedure. This facility is widely used in CASPR. So, external functions must be compiled into shared object libraries before running CASPR. A makefile for major Unix operating systems is provided. See the file README.C and README.F in the progs directory for further information. To learn more about call_external, the IDL documentation chapter Operating System Access in IDL version 4 or the IDL Advanced Development Guide in version 5 give details for the major operating systems.

So to build the shared object libraries for the Fortran and C functions, type make at the Unix prompt. The makefile will determine the correct filename extension for the shared object libraries; e.g., Sun Solaris produces shared object files with an "so" extension. The SHL_EXT environment variable described above should be set to this extension automatically in the Unix script setenv_caspr. For Windows, an extension of "dll" is assumed (globals.pro). The shared libraries are expected to be in $CASPR_DIR/progs.

RUNNING CASPR

See Section 3 of the User's Guide for instructions on using the CASPR system.