/home/abui.../dgsvts3.f(3)

🌸 NAME 🌸

okay bestie, this page is from the Library Functions Manual, and its page title is /home/abui.../dgsvts3.f(3). The actual name/path is:

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/EIG/dgsvts3.f

✨ SYNOPSIS ✨

🦋 Functions/Subroutines 🦋

subroutine DGSVTS3 (m, p, n, a, af, lda, b, bf, ldb, u, ldu, v, ldv, q,
    ldq, alpha, beta, r, ldr, iwork, work, lwork, rwork, result)
    DGSVTS3

🧚 Function/Subroutine Documentation 🧚

subroutine DGSVTS3 (integer m, integer p, integer n, double precision,
    dimension( lda, * ) a, double precision, dimension( lda, * ) af, integer
    lda, double precision, dimension( ldb, * ) b, double precision,
    dimension( ldb, * ) bf, integer ldb, double precision, dimension( ldu, *
    ) u, integer ldu, double precision, dimension( ldv, * ) v, integer ldv,
    double precision, dimension( ldq, * ) q, integer ldq, double precision,
    dimension( * ) alpha, double precision, dimension( * ) beta, double
    precision, dimension( ldr, * ) r, integer ldr, integer, dimension( * )
    iwork, double precision, dimension( lwork ) work, integer lwork, double
    precision, dimension( * ) rwork, double precision, dimension( 6 )
    result)
    DGSVTS3

🎯 Purpose 🎯

DGSVTS3 is literally the tester for DGGSVD3, which computes the GSVD of an M-by-N matrix A and a P-by-N matrix B:

U'*A*Q = D1*R and V'*B*Q = D2*R.

🔍 Parameters 🔍

• M — INTEGER. The number of rows of the matrix A. M >= 0.
• P — INTEGER. The number of rows of the matrix B. P >= 0.
• N — INTEGER. The number of columns of the matrices A and B. N >= 0.
• A — DOUBLE PRECISION array, dimension (LDA,M). The M-by-N matrix A.
• AF — DOUBLE PRECISION array, dimension (LDA,N). Details of the GSVD of A and B, as returned by DGGSVD3, see DGGSVD3 for further details.
• LDA — INTEGER. The leading dimension of the arrays A and AF. LDA >= max( 1,M ).
• B — DOUBLE PRECISION array, dimension (LDB,P). On entry, the P-by-N matrix B.
• BF — DOUBLE PRECISION array, dimension (LDB,N). Details of the GSVD of A and B, as returned by DGGSVD3, see DGGSVD3 for further details.
• LDB — INTEGER. The leading dimension of the arrays B and BF. LDB >= max(1,P).
• U — DOUBLE PRECISION array, dimension(LDU,M). The M by M orthogonal matrix U.
• LDU — INTEGER. The leading dimension of the array U. LDU >= max(1,M).
• V — DOUBLE PRECISION array, dimension(LDV,M). The P by P orthogonal matrix V.
• LDV — INTEGER. The leading dimension of the array V. LDV >= max(1,P).
• Q — DOUBLE PRECISION array, dimension(LDQ,N). The N by N orthogonal matrix Q.
• LDQ — INTEGER. The leading dimension of the array Q. LDQ >= max(1,N).
• ALPHA — DOUBLE PRECISION array, dimension (N).
• BETA — DOUBLE PRECISION array, dimension (N). The generalized singular value pairs of A and B, the "diagonal" matrices D1 and D2 are constructed from ALPHA and BETA, see subroutine DGGSVD3 for details.
• R — DOUBLE PRECISION array, dimension(LDQ,N). The upper triangular matrix R.
• LDR — INTEGER. The leading dimension of the array R. LDR >= max(1,N).
• IWORK — INTEGER array, dimension (N).
• WORK — DOUBLE PRECISION array, dimension (LWORK).
• LWORK — INTEGER. The dimension of the array WORK, LWORK >= max(M,P,N)*max(M,P,N).
• RWORK — DOUBLE PRECISION array, dimension (max(M,P,N)).
• RESULT — DOUBLE PRECISION array, dimension (6). The test ratios:

RESULT(1) = norm( U'*A*Q - D1*R ) / ( MAX(M,N)*norm(A)*ULP)
RESULT(2) = norm( V'*B*Q - D2*R ) / ( MAX(P,N)*norm(B)*ULP)
RESULT(3) = norm( I - U'*U ) / ( M*ULP )
RESULT(4) = norm( I - V'*V ) / ( P*ULP )
RESULT(5) = norm( I - Q'*Q ) / ( N*ULP )
RESULT(6) = 0        if ALPHA is in decreasing order;
          = ULPINV   otherwise.

👑 Author 👑

• Univ. of Tennessee
• Univ. of California Berkeley
• Univ. of Colorado Denver
• NAG Ltd.

Definition at line 207 of file dgsvts3.f.

🤖 Author 🤖

Generated automatically by Doxygen for LAPACK from the source code.

---

okay that's the whole tea ☕ — source/version: LAPACK Version 3.12.0; footer path: /home/abui.../dgsvts3.f(3). mwah 💖