The IMSL library is a collection of Fortran and C subroutines and functions useful in statistical and mathematical analysis.

At this time IMSL is installed on the SCF and on the RCF.

Requirements

To use any of the IMSL routines, you must write a program in FORTRAN or C (or some other language) to call the desired routine. You must then link the program source code to the IMSL library during compilation.

The following setup is required in order to use the IMSL subroutines in the RCF or SCF:

Host	Command
aludra almaak	To source the current IMSL library: source /usr/usc/imsl/default/setup.csh To source the setup files for the compilers: source /usr/spac/sparcompilers/default/setup.csh

If you would like these commands executed automatically each time you log in, you can add them to your .login file.

A Sample FORTRAN Program calling an IMSL routine

Here's a very simple FORTRAN program calling the IMSL function TDATE, which returns today's date. This program will be called test.f in the following examples. Remember, in FORTRAN each line of code must be indented:

indent-->
         INTEGER IDAY, IYEAR, MONTH
         EXTERNAL TDATE
         CALL TDATE(IDAY, MONTH, IYEAR)
         WRITE(*,*)'Day-Month-Year = ', IDAY, '-', MONTH, '-', IYEAR
         END

Compiling with IMSL

To compile the previous example, use the fortran compiler (f90) and link to the imsl library.

Host	Command
aludra almaak	To compile with f90 and link to the imsl, socket, and nsl libraries: f90 $F90FLAGS test.f $LINK_F90

Using IMSL FORTRAN routines in a C program

Whenever a C program calls FORTRAN routines, the C program must:
1. convert the FORTRAN procedure name to lowercase
2. append an underscore to the FORTRAN procedure name
3. pass all arguments as pointers

To compile, use a C compiler (gcc for example). There are several Fortran libraries that it may be necessary to link.
• If the FORTRAN routines call intrinsic or math functions, you must add the -lF90 and -lm options.

Starting with the new version of the fortran compiler, you must use a C compiler (gcc) to create the object file for the C program, then use the fortran compiler (f90) to do the linking to the IMSL library and to create the executable.

A Sample C Program calling an IMSL Fortran routine

In this example, this C program calls the IMSL routine TDATE. This program will be called test.c in the examples below.

main ()
{ int day, year, month;
  tdate_(&day, &month, &year);
  printf("Day-Month-Year = %d-%d-%d\n", day, month, year);
}

To compile this program, use the following commands:

Host	Command
aludra almaak	To compile the C code: gcc -c test.c To link the C object file with the imsl library: f90 test.o -L /usr/usc/lib -limsl -lF90 -lM90 -lsocket -lnsl -lm

Documentation

For more information about using compilers, search the ITS Help System.
1. IMSL C Numerical Libraries User's Guide
2. IMSL Fortran Numerical Libraries -- MATH (including Special Functions)
3. IMSL Fortran Numerical Libraries -- STAT

Visual Numerics, Inc.
9990 Richmond Avenue, Suite 400
Houston TX 77042-4548

713/784-3131

<support@houston.vni.com> === http://www.vni.com/

IMSL documentation is available in PDF format on the Visual Numerics Web Site:

www.vni.com/products/imsl/documentation/

IMSL documentation is not normally available at the USC Bookstore. All hard-copy references must be obtained directly from Visual Numerics (www.vni.com/). .

---

---