3 Known Problems and Workarounds
- 1 -
1. Introduction
The complib umbrella of mathematical and scientific
libraries contains complib.sgimath and complib.slatec.
These libraries are predominantly composed of free, public-
domain software (except for the BLAS, FFTs, and convolution
routines) , provided by SGI for your convenience. Support
is limited to bug fixes at SGI's discretion.
CHALENGEcomplib 2.0 is available in 64-bit mode for R8000
architectures (-mips4) running IRIX 6.0 in shared and non-
shared linkages (-non_shared), and single and multiple
processor architectures (-mp). To use the non-shared
linkages, you must have the MipsPro Fortran compiler.
The library complib.sgimath contains an extensive collection
of industry standard libraries such as Basic Linear Algebra
Subprograms (BLAS), the Extended BLAS (Level 2 and Level 3),
EISPACK, LINPACK, and LAPACK. Internally developed libraries
such for calculating Fast Fourier Transforms (FFT's) and
Convolutions are also included, as well as select SCILIB
routines from Cray Research. Documentation is available per
routine via individual reference pages (man pages).
The complib.sgimath library is available on Silicon
Graphics, Inc., Power Challenge systems via the -l
compilation flag, -lcomplib.sgimath (append _mp for
multiprocessing libraries).
A copy of the LAPACK Users' Guide, published by SIAM, is
available. This guide gives a detailed description of the
philosophy behind LAPACK as well as an explanation of its
usage. The LAPACK Users' Guide can be purchased from:
SIAM, 3600 University City Science Center, Philadelphia, PA
19104-2688; 215-382-9800, FAX 215-386-7999. It will also be
available from booksellers. The guide costs $15.60 for SIAM
members, and $19.50 for non-members. Please specify order
code OT31 when ordering. To order by e-mail, send message
to service@siam.org.
The LINPACK documentation is also available in book form,
the reference is: Dongarra J., et al., SIAM, 1979, LINPACK
Users' Guide, $19.50.
In addition, complib.slatec is available. SLATEC is the
acronym for the Sandia, Los Alamos, Air Force Weapons
Laboratory Technical Exchange Committee. The SLATEC Common
Mathematical Library (CML) Subcommittee decided in 1977 to
construct a mathematical FORTRAN subprogram library that
could be used on a variety of computers at the three sites.
A primary impetus for the library development was to provide
- 2 -
portable, non-proprietary, mathematical software for member
sites' supercomputers.
The SLATEC mathematical libraries are available on Silicon
Graphics, Inc., Power Challenge systems via the -l
compilation flag, -lcomplib.sgimath (append _mp for
multiprocessing libraries).
There are over 1,400 routines.
For documentation, use SLADOC in /usr/sbin. SLADOC is a
program that provides online documentation for each
computational kernel found in the SLATEC library.
The Library is in the public domain and distributed by the
Energy Science and Technology Software Center.
Energy Science and Technology Software Center
P.O. Box 1020
Oak Ridge, TN 37831
Telephone 615-576-2606
E-mail estsc%a1.adonis.mrouter@zeus.osti.gov
1.1 COMPLIB.SGIMATH_AVAILABILITY
Many of the routines in complib.sgimath are available from
netlib@research.att.com.
mail netlib@research.att.com
send index
The Internet address netlib@research.att.com refers to a
gateway machine, 192.20.225.2, at AT&T Bell Labs in Murray
Hill, New Jersey. This address should be understood on all
the major networks. For systems having only uucp
connections, use uunet!research!netlib. In this case, there
is a charge for a long-distance 1200 bps phone calls, so
keep your requests to a reasonable size!
If ftp is more convenient for you than e-mail, you may
connect to research.att.com; log in as netlib. (This is for
read-only ftp, not telnet.) Filenames end in .Z, reflecting
the need to have the uncompress command applied after you've
ftp'd them. compress source code for a variety of systems
and operating systems can be obtained by anonymous ftp from
ftp.uu.net. The files in netlib/crc/res have a list of
files with modification times, lengths, and checksums to
assist people who wish to automatically track changes.
For access from Europe, try the duplicate collection in
Oslo:
- 3 -
Internet: netlib@nac.no
EARN/BITNET: netlib%nac.no@norunix.bitnet
X.400: s=netlib; o=nac; prmd=uninett; c=no;
EUNET/uucp: nuug!netlib
For the Pacific, try netlib@draci.cs.uow.edu.au located at
the University of Wollongong, NSW, Australia.
The contents of netlib (other than toms) is available on
CD-ROM from Prime Time Freeware. The price of their two-
disc set, which also includes statlib, TeX, Modula3,
Interview, Postgres, Tcl/Tk, and more is about $60; for
current information contact
Prime Time Freeware
370 Altair Way, Suite 150
Sunnyvale, CA 94086 USA
Tel: +1 408-738-4832
Fax: +1 408-738-2050
ptf@cfcl.com
The following libraries are available. These libraries are
part of complib.sgimath.
o The BLAS library, level 1, 2 and 3 and machine
constants. Most of BLAS routines in complib.sgimath
are hand-tuned for each architecture.
o A library of FFT and convolution routines developed by
Silicon Graphics. These routines are tuned for each
architecture.
o The EISPACK library, a collection of Fortran
subroutines that compute the eigenvalues and
eigenvectors of nine classes of matrices. The package
can determine the eigensystems of complex general,
complex Hermitian, real general, real symmetric, real
symmetric band, real symmetric tridiagonal, special
real tridiagonal, generalized real, and generalized
real symmetric matrices. In addition, there are two
routines which use the singular value decomposition to
solve certain least squares problems.
o The LAPACK library, for the most common problems in
numerical linear algebra: linear equations, linear
least squares problems, eigenvalue problems, and
singular value problems. It has been designed to be
efficient on a wide range of modern high-performance
computers.
- 4 -
o The LINPACK library, for linear equations and linear
least squares problems, linear systems whose matrices
are general, banded, symmetric indefinite, symmetric
positive definite, triangular, and tridiagonal square.
In addition, the package computes the QR and singular
value decompositions of rectangular matrices and
applies them to least squares problems.
o The SCILIB library, a portable FORTRAN emulation (by
M.J. McBride and S.H. Lamson) of CRAY SCILIB, a library
of scientific applications subprograms developed by
Cray Research, Inc.
Note: Packaged with your software is a separate sheet that
contains the Software License Agreement. This
software is provided to you solely under the terms
and conditions of the Software License Agreement.
Please take a few moments to review the Agreement.
This document contains the following chapters:
1. Introduction
2. Installation Information
3. Known Problems and Workarounds
1.2 Release_Identification_Information
Following is the release identification information for
complib:
Software Product complib
Version 2.0
Product Code SC4-W4D-6.0
System Software Requirements IRIX 6.0
1.3 Online_Release_Notes
After you install the online release notes for a product
(the relnotes subsystem), you can view the release notes on
your screen.
Note: You can read the online release notes for most
products before installing the software. Refer to
the booklet in your CD-ROM case for more information.
- 5 -
If you have a graphics system, select ``Release Notes'' from
the Help submenu of the Toolchest. This displays the
grelnotes(1) graphical browser for the online release notes.
Refer to the grelnotes(1) reference page for information on
options to this command.
If you do not have a graphics system, you can use the
relnotes command. Refer to the relnotes(1) reference page
for accessing the online release notes.
1.4 Product_Support
Silicon Graphics, Inc., provides a comprehensive product
support maintenance program for its products.
If you are in the U.S. or Canada and would like support for
your Silicon Graphics-supported products, contact the
Technical Assistance Center at 1-800-800-4SGI. If you are
outside these areas, contact the Silicon Graphics subsidiary
or authorized distributor in your country.
- 1 -
2. Installation_Information
This chapter lists supplemental information to the IRIS
Software Installation Guide. The information listed here is
product- and release-specific; use it with the Installation
Guide to install this product.
2.1 complib_Subsystems
complib for Power Challenge includes these subsystems:
complib.man.relnotes These release notes
complib.man.sgimath complib sgimath reference
pages (manual pages)
complib.man.slatec complib slatec reference pages
complib.sw.sgimath_tfp64 complib sgimath tfp64
libraries
complib.sw.slatec_tfp64 complib slatec tfp64 libraries
complib.hdr.sgimath.hdr.lib complib sgimath library
headers
2.2 complib_Subsystem_Disk_Space_Requirements
This section lists the subsystems (and their sizes) of
complib.
If you are installing this product for the first time, the
subsystems marked ``default'' are the ones that are
installed if you use the ``go'' menu item. To install a
different set of subsystems, use the ``install,''
``remove,'' ``keep,'' and ``step'' commands in inst to
customize the list of subsystems to be installed, then
select the ``go'' menu item.
Note: The listed subsystem sizes are approximate. Refer to
the IRIS Software Installation Guide for information
on finding exact sizes.
Subsystem Name Subsystem Size
(512-byte blocks)
- 2 -
complib.hdr.sgimath * 102
complib.man.relnotes * 21
complib.man.sgimath * 6932
complib.man.slatec * 190
complib.sw.sgimath_tfp64 * 70281
complib.sw.slatec_tfp64 * 55499
2.3 Installation_Method
All of the subsystems for complib can be installed using
IRIX. You do not need to use the miniroot. Refer to the
IRIS Software Installation Guide for complete installation
instructions.
2.4 Other_Installation_Information
The location of these libraries and their names are subject
to change. The libraries are currently PIC .a libraries,
not DSO .so libraries. In a future release of the
libraries, they may change to DSO .so libraries.
The complib.sw.* subsystems are for compilation with default
compiler flags (-64 -mips4), for example: (installed in
/usr/lib64/mips4)
f77 -64 -mips4 file.f -lcomplib.slatec
Use the _mp suffix for the multiprocessing version. The -mp
flag is also required at link time, for example:
f77 -64 -mips4 -mp file.f -lcomplib.slatec_mp
- 1 -
3. Known_Problems_and_Workarounds
o The LAPACK routines that solve general band and
triangular systems of linear equations have been
compiled with lower optimization in order to pass the
tests.
o Some failures occur in [cdsz]gg.out when type:
10=(small*D, large*I) 12=(small*I, large*D) are
tested.