DDRVLS(3)

Okay bestie 💖 welcome to the ddrvls.f(3) page from the Library Functions Manual — manual name folded in near the top like a little name tag, exactly as requested. This is the LAPACK page for the file at the path below, and we are getting into every single detail, no skips, periodt.

🌸 NAME

The file this page is about is literally this exact path:

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/LIN/ddrvls.f

✨ SYNOPSIS

🎀 Functions/Subroutines

okay so here is the synopsis, copied exactly, character for character:

subroutine DDRVLS (dotype, nm, mval, nn, nval, nns, nsval, nnb, nbval,
    nxval, thresh, tsterr, a, copya, b, copyb, c, s, copys, nout)
    DDRVLS

💜 Function/Subroutine Documentation

This is the full signature for subroutine DDRVLS — all the types and dimensions are right here:

subroutine DDRVLS (logical, dimension( * ) dotype, integer nm, integer,
    dimension( * ) mval, integer nn, integer, dimension( * ) nval, integer
    nns, integer, dimension( * ) nsval, integer nnb, integer, dimension( * )
    nbval, integer, dimension( * ) nxval, double precision thresh, logical
    tsterr, double precision, dimension( * ) a, double precision, dimension(
    * ) copya, double precision, dimension( * ) b, double precision,
    dimension( * ) copyb, double precision, dimension( * ) c, double
    precision, dimension( * ) s, double precision, dimension( * ) copys,
    integer nout)
    DDRVLS

✨ Purpose

The purpose is giving: DDRVLS tests the least squares driver routines DGELS, DGELST, DGETSLS, DGELSS, DGELSY, and DGELSD. That is the whole tea ☕.

💅 Parameters

• DOTYPE — DOTYPE is LOGICAL array, dimension (NTYPES). These are the matrix types used for testing, bestie: matrices of type j (for 1 <= j <= NTYPES) are used for testing if DOTYPE(j) = .TRUE.; if DOTYPE(j) = .FALSE., then type j is not used. The matrix of type j is generated as follows:
  • j=1: A = U*D*V where U and V are random orthogonal matrices and D has random entries (> 0.1) taken from a uniform distribution (0,1). A is full rank.
  • j=2: the same of 1, but A is scaled up.
  • j=3: the same of 1, but A is scaled down.
  • j=4: A = U*D*V where U and V are random orthogonal matrices and D has 3*min(M,N)/4 random entries (> 0.1) taken from a uniform distribution (0,1) and the remaining entries set to 0. A is rank-deficient.
  • j=5: the same of 4, but A is scaled up.
  • j=6: the same of 5, but A is scaled down.
• NM — NM is INTEGER. The number of values of M contained in the vector MVAL.
• MVAL — MVAL is INTEGER array, dimension (NM). The values of the matrix row dimension M.
• NN — NN is INTEGER. The number of values of N contained in the vector NVAL.
• NVAL — NVAL is INTEGER array, dimension (NN). The values of the matrix column dimension N.
• NNS — NNS is INTEGER. The number of values of NRHS contained in the vector NSVAL.
• NSVAL — NSVAL is INTEGER array, dimension (NNS). The values of the number of right hand sides NRHS.
• NNB — NNB is INTEGER. The number of values of NB and NX contained in the vectors NBVAL and NXVAL. The blocking parameters are used in pairs (NB,NX).
• NBVAL — NBVAL is INTEGER array, dimension (NNB). The values of the blocksize NB.
• NXVAL — NXVAL is INTEGER array, dimension (NNB). The values of the crossover point NX.
• THRESH — THRESH is DOUBLE PRECISION. The threshold value for the test ratios. A result is included in the output file if RESULT >= THRESH. To have every test ratio printed, use THRESH = 0.
• TSTERR — TSTERR is LOGICAL. Flag that indicates whether error exits are to be tested.
• A — A is DOUBLE PRECISION array, dimension (MMAX*NMAX) where MMAX is the maximum value of M in MVAL and NMAX is the maximum value of N in NVAL.
• COPYA — COPYA is DOUBLE PRECISION array, dimension (MMAX*NMAX).
• B — B is DOUBLE PRECISION array, dimension (MMAX*NSMAX) where MMAX is the maximum value of M in MVAL and NSMAX is the maximum value of NRHS in NSVAL.
• COPYB — COPYB is DOUBLE PRECISION array, dimension (MMAX*NSMAX).
• C — C is DOUBLE PRECISION array, dimension (MMAX*NSMAX).
• S — S is DOUBLE PRECISION array, dimension (min(MMAX,NMAX)).
• COPYS — COPYS is DOUBLE PRECISION array, dimension (min(MMAX,NMAX)).
• NOUT — NOUT is INTEGER. The unit number for output.

🌸 Author

The author list is giving academic royalty:

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

Definition at line 189 of file ddrvls.f.

👑 Author

Generated automatically by Doxygen for LAPACK from the source code.

---

And that is the whole page, bestie 🫶. Big kiss from LAPACK Version 3.12.0, and the footer path is /home/abui...IN/ddrvls.f(3). No date is listed on this page, so I am not inventing one — we keep the facts cute and correct 💅✨.