ReadMe
December 1, 2016 ยท View on GitHub
This directory contains source code for the NITSOL package, some auxiliary software, and several example applications.
Building NITSOL
If you are the impatient type and just want to get on with it, just type
make
to build the package and several example codes. If you want to find out more about the make options, type
make help
NITSOL Documentation
Currently documentation for using NITSOL may be found in comments at the beginning of each source code file. See in particular the comments in nitsol.f. A more extensive user guide is planned.
Source code Directories:
Nitsol - source code for the NITSOL package: nitbd.f nitbt.f nitdrv.f nitgm.f nitjv.f nitsol.f nitstb.f nittfq.f
In addition, several header files contain global declarations and definitions: nitdflts.h nitinfo.h nitparam.h nitprint.h
Lapack - source code for LAPACK routines needed by NITSOL: dlaic1.f dlamch.f
This subset of LAPACK is provided just for convenience. We recommend that you link to a local installation of the library archive. This may be done by modifying the Makefile in this directory to change the definition of the LAPACK macro. Depending on the local installation, you might be able to link with the local installation of LAPACK by setting
LAPACK = -llapack
in the Makefile. At some installations the LAPACK library archive may be in a directory that is not among the default search paths, or the name of the library archive may not conform to the usual UNIX archive naming convention. Consult your local system administrator for the appropriate information.
Blas - source code for BLAS routines needed by NITSOL: daxpy.f dcopy.f ddot.f dnrm2.f dscal.f dswap.f
This subset of BLAS is provided just for convenience. We recommend that you link to a local installation of the library archive. This may be done by modifying the Makefile in this directory to change the definition of the BLAS macro. Depending on the local installation, you might be able to link with the local installation of LAPACK by setting
BLAS = -lblas
in the Makefile. At some installations the BLAS library archive may be in a location that is not among the default search paths, or the name of the library archive may not conform to the usual UNIX archive naming convention. Consult your local system administrator for the appropriate information.
If you are successful in linking to a local installation of LAPACK and/or BLAS, remember to remove the dependencies on lapack_lib and/or blas_lib from the Makefile to avoid unnecessary recompilations.
Application directories:
Several sample applications are provided to illustrate the use of NITSOL and to check the installation. Each is in its own directory:
Bratu - generalized Bratu problem Cavity - flow in driven cavity problem (OLD driver) Pormed - flow in porous media (steady-state version)
To build: The applications each have a specific target name: Bratu - bratu Cavity - cavity Pormed - pormed
To build an application, merely type "make
Checking the installation:
The following output from the three sample applications is provided to facilitate checking the installation. The output was obtained on an SGI Indy equipped with an R4600 microprocessor. (In the following "%" is the generic UNIX command prompt).
% bratu Type problem parameters nx, d, lambda: 63 32. 8. Type ikrysl, irpre (0-1), and ijacv (0-1):
ikrysl = 0 => GMRES 1 => BiCGSTAB 2 => TFQMR irpre = 0 => no right preconditioning 1 => right preconditioning ijacv = 0 => finite-difference Jv 1 => analytic Jv
0 1 1 Type maximum Krylov subspace dimension: 50 Choice of forcing term: 0 Type iplvl (informational printout level), and ipunit (printout unit): iplvl = 0 => no printout, = 1 => iteration number and F-norm, = 2 => ... + stats, step-norm, lin model norm, = 3 => ... + some Krylov method and backtrack info. = 4 => ... + more Krylov method and backtrack info. 1 6
Solve generalized Bratu problem using Newton-GMRES
GMRES restart value: 50
Use Choice 1 for forcing term
Preconditioner is a fast Poisson solver
Use analytic J*v evaluations
Problem parameters:
nx: 63 n: 3969 d: 3.20E+01 lambda:8.00E+00
ftol: 1.23E-07 stptol: 1.00E-06
Initial f-norm: 1.230E-01
nitdrv: Beginning nonlinear iterations.
It. no. 0 F norm = 1.230D-01
It. no. 1 F norm = 5.187D-02
It. no. 2 F norm = 1.663D-02
It. no. 3 F norm = 2.054D-03
It. no. 4 F norm = 7.175D-08
nitdrv: Terminating nonlinear iterations.
Termination flag iterm: 0 Final f-norm: 7.175E-08 No. function evaluations: 5 No. J*v evaluations: 41 No. P(inverse)*v evaluations: 45 No. linear iterations: 41 No. nonlinear iterations: 4 No. backtracks: 0 To go, type 0; to stop, type 1: 1
% cavity Type problem parameters nx, Re (Reynold's number): 63 1000 Type ikrysl, irpre (0-1), and ijacv (0-1):
ikrysl = 0 => GMRES 1 => BiCGSTAB 2 => TFQMR irpre = 0 => no right preconditioning 1 => right preconditioning
0 1 Type kdmax = maximum Krylov subspace dimension: 200 Type ifdord = order of finite-difference formula: 1 Type iplvl (informational printout level), and ipunit (printout unit): iplvl = 0 => no printout, = 1 => iteration number and F-norm, = 2 => ... + stats, step-norm, lin model norm, = 3 => ... + some Krylov method and backtrack info. = 4 => ... + more Krylov method and backtrack info. 1 6
Solve driven cavity problem using Newton-GMRES
Preconditioner is biharmonic solver with Cholesky decomposition.
Use 1-th order finite differences for Jacobian
Problem parameters:
nx: 63 n: 3969 Reynolds number: 1000.0
ftol: 1.000E-08 stptol: 1.016E-07
Initial f-norm: 1.016E+00
nitdrv: Beginning nonlinear iterations.
It. no. 0 F norm = 1.016D+00
It. no. 1 F norm = 2.935D-01
It. no. 2 F norm = 2.220D-01
It. no. 3 F norm = 1.137D-01
It. no. 4 F norm = 7.950D-02
It. no. 5 F norm = 5.423D-02
It. no. 6 F norm = 4.517D-02
It. no. 7 F norm = 3.720D-02
It. no. 8 F norm = 3.006D-02
It. no. 9 F norm = 2.633D-02
It. no. 10 F norm = 1.652D-02
It. no. 11 F norm = 9.931D-03
It. no. 12 F norm = 4.218D-03
It. no. 13 F norm = 9.233D-04
It. no. 14 F norm = 8.741D-06
It. no. 15 F norm = 7.314D-08
nitdrv: Terminating nonlinear iterations.
Termination flag iterm: 0 Final f-norm: 7.314E-08 No. function evaluations: 296 No. J*v evaluations: 277 No. P(inverse)*v evaluations: 292 No. linear iterations: 277 No. nonlinear iterations: 15 No. backtracks: 3 To go, type 0; to stop, type 1: 1
% pormed Type problem parameters nx, d, bll, bur, src: 63 -50. 1. 0. 50. Type ikrysl, irpre (0-1), and ijacv (0-1):
ikrysl = 0 => GMRES 1 => BiCGSTAB 2 => TFQMR irpre = 0 => no right preconditioning 1 => right preconditioning ijacv = 0 => finite-difference Jv 1 => analytic Jv
2 1 0 Type tol and fill for incomplete factorization: 0.0 4 Type ifdord = order of finite-difference formula: 1 Choice of forcing term: 1 Type iplvl (informational printout level), and ipunit (printout unit): iplvl = 0 => no printout, = 1 => iteration number and F-norm, = 2 => ... + stats, step-norm, lin model norm, = 3 => ... + some Krylov method and backtrack info. = 4 => ... + more Krylov method and backtrack info. 1 6
Solve flow in porous media problem using Newton-TFQMR
Use Choice 2 for forcing term
alpha = 2.00E+00 gamma = 1.00E+00
Preconditioner is ILUT(0.00, 4)
Use 1-th order finite differences for Jacobian
Problem parameters:
nx: 63 n: 3969 d:-5.00E+01 bll:1.000E+00 bur:0.000E+00 src:5.00E+01
ftol: 4.18E-06 stptol: 1.00E-06
Initial f-norm: 4.178E+00
nitdrv: Beginning nonlinear iterations.
It. no. 0 F norm = 4.178D+00
It. no. 1 F norm = 1.118D+00
It. no. 2 F norm = 9.369D-01
It. no. 3 F norm = 4.527D-01
It. no. 4 F norm = 3.072D-01
It. no. 5 F norm = 1.981D-01
It. no. 6 F norm = 3.820D-02
It. no. 7 F norm = 1.087D-02
It. no. 8 F norm = 7.204D-04
It. no. 9 F norm = 3.335D-07
nitdrv: Terminating nonlinear iterations.
Termination flag iterm: 0 Final f-norm: 3.335E-07 No. function evaluations: 59 No. J*v evaluations: 47 No. P(inverse)*v evaluations: 38 No. linear iterations: 19 No. nonlinear iterations: 9 No. backtracks: 2 To go, type 0; to stop, type 1: 1