f12fe: FL CL CPP AD PY MB

NAG FL Interface
f12fef (real_symm_monit)

Note: this routine uses optional parameters to define choices in the problem specification. If you wish to use default settings for all of the optional parameters, then the option setting routine f12fdf need not be called. If, however, you wish to reset some or all of the settings please refer to Section 11 in f12fdf for a detailed description of the specification of the optional parameters.

Keyword Search:

NAG Library Manual, Mark 30

Interfaces: FL CL CPP AD PY MB

NAG FL Interface Introduction

F12 (Sparseig) Chapter Contents

F12 (Sparseig) Chapter Introduction

f12fe: FL CL CPP AD PY MB

▸▿ Contents

1 Purpose

2 Specification

3 Description

4 References

5 Arguments

6 Error Indicators and Warnings

7 Accuracy

8 Parallelism and Performance

9 Further Comments

▸▿ 10 Example

10.1 Program Text

10.2 Program Data

10.3 Program Results

1 Purpose

f12fef can be used to return additional monitoring information during computation. It is in a suite of routines which includes f12faf, f12fbf, f12fcf and f12fdf.

2 Specification

Fortran Interface

Subroutine f12fef (

niter, nconv, ritz, rzest, icomm, comm)

Integer, Intent (In)	::	icomm(*)
Integer, Intent (Out)	::	niter, nconv
Real (Kind=nag_wp), Intent (In)	::	comm(*)
Real (Kind=nag_wp), Intent (Inout)	::	ritz(), rzest()

C Header Interface

#include <nag.h>

void	f12fef_ (Integer niter, Integer nconv, double ritz[], double rzest[], const Integer icomm[], const double comm[])

The routine may be called by the names f12fef or nagf_sparseig_real_symm_monit.

3 Description

The suite of routines is designed to calculate some of the eigenvalues,

λ

, (and optionally the corresponding eigenvectors,

x

) of a standard eigenvalue problem

A x = λ x

, or of a generalized eigenvalue problem

A x = λ B x

of order

n

, where

n

is large and the coefficient matrices

A

and

B

are sparse, real and symmetric. The suite can also be used to find selected eigenvalues/eigenvectors of smaller scale dense, real and symmetric problems.

On an intermediate exit from f12fbf with

irevcm = 4

, f12fef may be called to return monitoring information on the progress of the Arnoldi iterative process. The information returned by f12fef is:

–the number of the current Arnoldi iteration;
–the number of converged eigenvalues at this point;
–the real and imaginary parts of the converged eigenvalues;
–the error bounds on the converged eigenvalues.

f12fef does not have an equivalent routine from the ARPACK package which prints various levels of detail of monitoring information through an output channel controlled via an argument value (see Lehoucq et al. (1998) for details of ARPACK routines). f12fef should not be called at any time other than immediately following an

irevcm = 4

return from f12fbf.

4 References

Lehoucq R B (2001) Implicitly restarted Arnoldi methods and subspace iteration SIAM Journal on Matrix Analysis and Applications 23 551–562

Lehoucq R B and Scott J A (1996) An evaluation of software for computing eigenvalues of sparse nonsymmetric matrices Preprint MCS-P547-1195 Argonne National Laboratory

Lehoucq R B and Sorensen D C (1996) Deflation techniques for an implicitly restarted Arnoldi iteration SIAM Journal on Matrix Analysis and Applications 17 789–821

Lehoucq R B, Sorensen D C and Yang C (1998) ARPACK Users' Guide: Solution of Large-scale Eigenvalue Problems with Implicitly Restarted Arnoldi Methods SIAM, Philadelphia

5 Arguments

1: $niter$ – Integer Output: On exit: the number of the current Arnoldi iteration.
2: $nconv$ – Integer Output: On exit: the number of converged eigenvalues so far.
3: $ritz (*)$ – Real (Kind=nag_wp) array Output: Note: the dimension of the array ritz must be at least $ncv$ (see f12faf).

On exit: the first nconv locations of the array ritz contain the real converged approximate eigenvalues.
4: $rzest (*)$ – Real (Kind=nag_wp) array Output: Note: the dimension of the array rzest must be at least $ncv$ (see f12faf).

On exit: the first nconv locations of the array rzest contain the Ritz estimates (error bounds) on the real nconv converged approximate eigenvalues.
5: $icomm (*)$ – Integer array Communication Array: Note: the dimension of the array icomm must be at least $\max (1, licomm)$ , where licomm is passed to the setup routine (see f12faf).

On entry: the array icomm output by the preceding call to f12fbf.
6: $comm (*)$ – Real (Kind=nag_wp) array Communication Array: Note: the dimension of the array comm must be at least $\max (1, lcomm)$ , where lcomm is passed to the setup routine (see f12faf).

On entry: the array comm output by the preceding call to f12fbf.

6 Error Indicators and Warnings

None.

7 Accuracy

A Ritz value,

λ

, is deemed to have converged if its Ritz estimate

\leq Tolerance \times | λ |

. The default Tolerance used is the machine precision given by x02ajf.

8 Parallelism and Performance

Background information to multithreading can be found in the Multithreading documentation.

f12fef is not threaded in any implementation.

9 Further Comments

None.

10 Example

This example solves

K x = λ K_{G} x

using the Buckling option (see f12fdf, where

K

and

K_{G}

are obtained by the finite element method applied to the one-dimensional discrete Laplacian operator

\frac{\partial^{2} u}{\partial x^{2}}

[0, 1]

, with zero Dirichlet boundary conditions using piecewise linear elements. The shift,

σ

, is a real number, and the operator used in the Buckling iterative process is

op = inv (K - σ K_{G}) \times K

and

B = K

f12fe: FL CL CPP AD PY MB

NAG FL Interfacef12fef (real_​symm_​monit)

▸▿ Contents

1 Purpose

2 Specification

3 Description

4 References

5 Arguments

6 Error Indicators and Warnings

7 Accuracy

8 Parallelism and Performance

9 Further Comments

10 Example

10.1 Program Text

10.2 Program Data

10.3 Program Results

NAG FL Interface
f12fef (real_symm_monit)