SSL II USER'S GUIDE - Lahey Computer Systems

HOW TO USE THIS MANUAL
This section describes the logical organization of this
manual, and the way in which the user can quickly and
accurately get informations necessary to him from the
manual.
This manual consists of two parts. Part I describes an
outline of SSL II. Part II describes usage of SSL II
subroutines.
Part I consists of twelve chapters.
Chapter 2 describes the general rules which apply to
each SSL II subroutine. It is suggested that the user
read this chapter first.
Chapters 3 through 12 are concerned with certain
fields of numerical computation, and were edited as
independently as possible for easy reference. At the
beginning of every chapter, the section “OUTLINE” is
given, which describes the classification of available
subroutines in the chapter, and how to select subroutines
suitable for a certain purpose. The user should read the
section at least once.
As mentioned above, there is no confusing or difficult
relation between the chapters: it is quite simple as shown
in the following diagram.
12
Chapter 1
Chapter 2
Chapter 3
Chapter 4
Chapter 5
Chapter 12
Each chapter from chapter 3 on has several sections,
the first of which is the section “OUTLINE” that, as
noted previously, introduces the following sections.
As the diagram shows, if the user wants to obtain
eigenvalues, for example, of a certain matrix, he should
first read Chapter 2, then jump to Chapter 4, where he
can select subroutines suitable for his purposes.
Part II describes how to use SSL II subroutines. The
subroutines are listed in alphabetical order.
When describing an individual subroutine, the
following contents associated with the subroutine are
shown:
• Function
• Parameters
• Comments on use
• Method
and what we intend to describe under each title above
are as follows:
Function
Describes explanation of the functions.
Parameters
Describes variables and arrays used for transmitting
information into or from the subroutine. Generally,
parameter names, which are commonly used in SSL II,
are those habitually used so far in many libraries.
Comments on use
This consists of the following three parts.
• Subprograms used
If other SSL II subroutines are used internally by the
subroutine, they are listed under “SSL II”. Also, if
FORTRAN intrinsic functions or basic external
functions are used, they are listed under “FORTRAN
basic functions”.
• Notes
Discusses various considerations that the user should
be aware of when using the subroutine.
• Example
An example of the use of the subroutine is shown.
For clarity and ease of understanding, any applications
to a certain field of engineering or physical science
have not been described. In case other subroutines
must be used as well as the subroutine to obtain a
mathematical solution, the example has been designed
to show how other subroutines are involved. This is
especially true in the chapters concerning linear
equations or eigenvalues etc. Conditions assumed in
an example are mentioned at the beginning of the
example.
Method
The method used by the subroutine is outlined. Since
this is a usage manual, only practical aspects of the
algorithm or computational procedures are described.
References on which the implementation is based and
those which are important in theory, are listed in
Appendix D “References”, so refer to them for further
information or details beyond the scope of the “Method”
section.
In this manual, included are the SSL II Subroutine list
and four appendices. In the SSL II Subroutine list, SSL
II Subroutines are arranged in the order of fields and then
in the order of their classification codes. This list can be
used for quick reference of subroutines.
Appendix A explains the functions of the auxiliary
subroutines and Appendix B contains the three lists,
which are concerned respectively with
• General subroutines
• Slave subroutines
• Auxiliary subroutines
General subroutines is an alphabetical listing of all
subroutines. In the list, if a certain entry uses other
subroutines, they are shown on the right. Slave
subroutines is an alphabetical listing of slave subroutines