?larrb2

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 11/07/2023

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-94A50590-0FF8-4B80-9F45-34AA69D398F2

View Details

?larrb2

Provides limited bisection to locate eigenvalues for more accuracy.

Syntax

void slarrb2(MKL_INT* n, float* d, float* lld, MKL_INT* ifirst, MKL_INT* ilast, float* rtol1, float* rtol2, MKL_INT* offset, float* w, float* wgap, float* werr, float* work, MKL_INT* iwork, float* pivmin, float* lgpvmn, float* lgspdm, MKL_INT* twist, MKL_INT* info);

void dlarrb2(MKL_INT* n, double* d, double* lld, MKL_INT* ifirst, MKL_INT* ilast, double* rtol1, double* rtol2, MKL_INT* offset, double* w, double* wgap, double* werr, double* work, MKL_INT* iwork, double* pivmin, double* lgpvmn, double* lgspdm, MKL_INT* twist, MKL_INT* info);

Include Files

mkl_scalapack.h

Description

Given the relatively robust representation (RRR) LDL^T, ?larrb2 does "limited" bisection to refine the eigenvalues of LDL^T with indices in a given range to more accuracy. Initial guesses for these eigenvalues are input in w, the corresponding estimate of the error in these guesses and their gaps are input in werr and wgap, respectively. During bisection, intervals [left, right] are maintained by storing their mid-points and semi-widths in the arrays w and werr respectively. The range of indices is specified by the ifirst, ilast, and offset parameters, as explained in Input Parameters.

NOTE:

There are very few minor differences between larrb from LAPACK and this current function ?larrb2. The most important reason for creating this nearly identical copy is profiling: in the ScaLAPACK MRRR algorithm, eigenvalue computation using ?larrb2 is used for refinement in the construction of the representation tree, as opposed to the initial computation of the eigenvalues for the root RRR which uses ?larrb. When profiling, this allows an easy quantification of refinement work vs. computing eigenvalues of the root.

Input Parameters

n

The order of the matrix.

d

Array of size n.

The n diagonal elements of the diagonal matrix D.

lld

Array of size n-1.

The (n-1) elements l_i+1*l_i+1*d[i], i=0, ..., n-2.

ifirst

The index of the first eigenvalue to be computed.

ilast

The index of the last eigenvalue to be computed.

rtol1, rtol2

Tolerance for the convergence of the bisection intervals.

An interval [left, right] has converged if right - left < max (rtol1 * gap, rtol2 * max(|left|, |right|)) where gap is the (estimated) distance to the nearest eigenvalue.

offset

Offset for the arrays w, wgap and werr, i.e., the elements indexed ifirst - offset - 1 through ilast - offset -1 of these arrays are to be used.

w

Array of size n

On input, w[ifirst - offset - 1] through w[ilast - offset - 1] are estimates of the eigenvalues of LDL^T indexed ifirst through ilast.

wgap

Array of size n-1.

On input, the (estimated) gaps between consecutive eigenvalues of LDL^T, i.e., wgap[I - offset - 1] is the gap between eigenvalues I and I + 1. Note that if ifirst = ilast then wgap[ifirst - offset - 1] must be set to zero.

werr

Array of size n.

On input, werr[ifirst - offset - 1] through werr[ilast - offset - 1] are the errors in the estimates of the corresponding elements in w.

work

(workspace) array of size 4*n.

Workspace.

iwork

(workspace) array of size 2*n.

Workspace.

pivmin

The minimum pivot in the Sturm sequence.

lgpvmn

Logarithm of pivmin, precomputed.

lgspdm

Logarithm of the spectral diameter, precomputed.

twist

The twist index for the twisted factorization that is used for the negcount.

twist = n: Compute negcount from LDL^T - λI = L₊D₊L₊^T

twist = 1: Compute negcount from LDL^T - λI = U_-D_-U_-^T

twist = r, 1 < r < n: Compute negcount from LDL^T - λI = N_r Δ_r N_r^T

OUTPUT Parameters

w: On output, the eigenvalue estimates in w are refined.
wgap: On output, the eigenvalue gaps in wgap are refined.
werr: On output, the errors in werr are refined.
info: Error flag.

Parent topic: ScaLAPACK Auxiliary Routines

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

?larrb2

Syntax

Include Files

Description

Input Parameters

OUTPUT Parameters

See Also