There are six FORTRAN files in the SLEIGN2 package:
To run one of the examples in the xamples.f file in an UNIX environment with a FORTRAN compiler, enter the following command:
f77 xamples.f drive.f sleign2.f -o xamples.xThis will create the executable file xamples.x and two object files drive.o and sleign2.o. Now run xamples.x whenever you want to work an example from the list of examples in the xamples.f file.
To run your own problem proceed as follows:
f77 makepqw.f -o makepqw.x
makepqw.x(This interactive program will ask you for a file name - this must end in .f - for example, if your chosen problem has the name bloggs then enter bloggs.f). This file, after makepqw.x has been run, will contain the subroutines for p,q,w and, if necessary, the functions u and v which are used to define singular limit-circle boundary conditions at one or both end-points.
f77 bloggs.f drive.f sleign2.f -o bloggs.x(drive.f and sleign2.f can be replaced with drive.o and sleign2.o if these .o files are available to speed up the compilation; these .o files are created by the first compilation.)
bloggs.x(The user is asked to provide information for the code to run bloggs.x, for example boundary conditions, eigenvalue indexes, numerical tolerances, name for report file if so desired. See the autoinput.txt file for instructions on how to automate the input of the required information.)
Note that the above procedures may have to be modified for non UNIX environments, e.g. DOS or Apple.
Note also that in running xamples.x or bloggs.x the user has access to
the interactive help device; at any point where the program halts
type h
The file sepdr.f is a sample driver for separated
regular and singular boundary conditions; coupdr.f is a sample driver program for coupled
regular and singular boundary conditions. Experienced users who want
to bypass the extensive user-friendly interface provided in drive.f and in makepqw.f and
use their own driver program may wish to look at these two sample
drivers; this also applies to users who want to call the subroutines
within sleign2.f in their own programs.
All six of the FORTRAN .f files are supplied in single precision;
to convert these files to double precision replace "REAL" by
"DOUBLE PRECISION" throughout. In UNIX this can be effected using
sed, or within the vi editor as follows:
Additional information on the SLEIGN2 package can be found in the
intro.pdf file.
Acknowledgments: The authors are grateful to their colleagues
Howard Dwyer, Qingkai Kong and Hongyou Wu for help and
advice at a number of stages in the development of this program.
Some of the theoretical underpinnings of the algorithm for coupled
boundary conditions were obtained jointly with Michael Eastham, Qingkai
Kong and Hongyou Wu.
The authors thank Burt Garbow for expert assistance in preparing the
FORTRAN content of the SLEIGN2 files.
A special thanks to Eric Behr for his help throughout the development
of the code, for setting up the public access through the World Wide
Web, and for informed advice.
All suggestions, comments and criticisms are welcome; please
send all comments to
sl2
Northern Illinois University, DeKalb, IL. 60115-2888, USA, and
School of Mathematics, University of Birmingham, Birmingham B15
2TT, England, UK. 01 December, 2000.
:1,$ s/REAL/DOUBLE PRECISION
It is recommended that the user try the program in single precision and
switch to double precision as required.
A number of recent papers related to the SLEIGN2 package are also available:
Authors: Paul Bailey, Norrie Everitt and Tony Zettl
(with the assistance of Burt Garbow.)
math.niu.edu
This page is at
http://www.math.niu.edu/SL2/
with a mirror at
http://web.mat.bham.ac.uk/SL2/
Last revised: 8/15/2006