NLEQ_RES package - release 1.1.1 at June 6, 2006

Description of the package:
---------------------------

The NLEQ_RES package consists of the files listed and briefly described
below:

filename        contents of file

nleq_res.c      nleq_res main routine and some nleq_res specific internal
                routines.

qnres.c         qnres main routine and some qnres specific internal routines.

utils.c         Common used utility routines by the NewtonLib codes:
                Dynamic memory allocation, computation of scalar products
                and norms, scaling and descaling of vectors, data output,
                parameter check and printout.
                
nleq.h          Common used type and macro definitions by the NewtonLib codes.
                Should also be included in main programs which call
                NewtonLib routines.

jacobian_and_linalg.c  Jacobian and linear algebra dependent routines.

jacobian.h      Type definition of the Jacobian - included via file nleq.h.

test_nleqres.c  An example main program illustrating the usage of nleq_res.

lapack_and_blas.f  A selection of subroutines from LAPACK and BLAS, which
                   are needed by the NewtonLib codes.

makefile        An input file to the UNIX make utility containing informa-
                tion how to build the executable program test_nleqres.

readme           This information.

nleq_res_out.nrm   Example monitor output of program run of test_nleqres.

nleq1_res_dat.nrm   Example data output of program run of test_nleqres.


The main program solves a sequence of test problems (the Chebyquad problem
with dimensions n=2,3,...,9). To build the executable program, you need to
compile and to link the files below:

test_nleqres.c, nleq_res.c, qnres.c, utils.c, jacobian_and_linalg.c,
lapack_and_blas.f

Under MacOSX (Darwin), SunOS, or Linux simply type in:
make             -   to build program test_nleqres.

Note that a few adaptations may be necessary to utilize the code for
your computer at hand. Please examine the nleq.h header file and adapt
the definitions of the macros SMALL and EPMACH, if needed.

If you wish to link other linear algebra routines than DGETRF and DGETRS
of LAPACK, then review the files jacobian_and_linalg.c and jacobian.h
and make the appropriate changes in these files.

Changes from Version 1.1 to 1.1.1:
----------------------------------

Missing int return code in function nleqres_initscale, bug fixed.
Missing int return code in function qnr_initscale, bug fixed.
                           

Changes from Version 1.0 to 1.1:
--------------------------------

Added the output data files iterfile, resfile and miscfile,
where optional data output is provided, a single line, starting
with the iteration number, for each iteration step. These data
are suitable for graphical display by the GNUPLOT program.
