/home/abui...G/cblat2.f(3)

πŸ“¦ version 3.12.0, in opensuse-leap 16.0

πŸ’– NAME πŸ’–

So this page is from the Library Functions Manual, section 3, and the thing it's documenting is a whole file path, bestie:

/home/abuild/rpmbuild/BUILD/lapack-
static-3.12.0-build/lapack-3.12.0/BLAS/TESTING/cblat2.f

Yep. That's the entire NAME stanza. It's literally just the file's whole life story as a path β€” cblat2.f living its best life inside the BLAS TESTING directory of the lapack-static-3.12.0-build rpmbuild tree. No cap, that's the name. 🫢


✨ SYNOPSIS ✨

πŸŽ€ Functions/Subroutines πŸŽ€

Okay so this is the part where I list every single function and subroutine this file has to offer β€” and I mean every one, no skipping, no "and friends", we're doing all of them πŸ’…. Signatures are copied exactly, character for character, because we do not play with argument lists. 🌸

  • program CBLAT2 β€” the program itself, main character energy fr fr πŸ‘‘
    • CBLAT2 β€” yep, that's the name again, it's a whole program and it's called CBLAT2
  • subroutine CCHK1 β€” a subroutine, and here is its full arg list, exactly as written: (sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nkb, kb, nalf, alf, nbet, bet, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g) πŸ¦‹
  • subroutine CCHK2 β€” another one, and look at that arg list, it's giving long: (sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nkb, kb, nalf, alf, nbet, bet, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g) ✨
  • subroutine CCHK3 β€” this one swaps in xt and z, obsessed: (sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nkb, kb, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, xt, g, z) πŸŽ€
  • subroutine CCHK4 β€” no kb/bet here, but it's got z at the end, periodt: (sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nalf, alf, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g, z) πŸ’œ
  • subroutine CCHK5 β€” same energy, same exact arg list as its sibling, lowkey iconic: (sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nalf, alf, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g, z) 🌈
  • subroutine CCHK6 β€” and the sixth one, same args again, the way they just kept the pattern: (sname, eps, thresh, nout, ntra, trace, rewi, fatal, nidim, idim, nalf, alf, ninc, inc, nmax, incmax, a, aa, as, x, xx, xs, y, yy, ys, yt, g, z) 🌸
  • subroutine CCHKE β€” short and sweet, only three args: (isnum, srnamt, nout) 🧚
  • subroutine CMAKE β€” a builder-ish little guy, here's the whole thing: (type, uplo, diag, m, n, a, nmax, aa, lda, kl, ku, reset, transl) πŸ”₯
  • subroutine CMVCH β€” big arg list incoming, brace yourself: (trans, m, n, alpha, a, nmax, x, incx, beta, y, incy, yt, g, yy, eps, err, fatal, nout, mv) 😭
  • logical function LCE β€” note: it returns a logical, bestie, and it takes (ri, rj, lr) πŸ¦‹
  • logical function LCERES β€” also a logical function: (type, uplo, m, n, aa, as, lda) ✨
  • complex function CBEG β€” this one returns complex and takes exactly one thing: (reset) πŸ’€
  • real function SDIFF β€” returns real, takes two: (x, y) ⭐
  • subroutine CHKXER β€” args: (srnamt, infot, nout, lerr, ok) 🌈
  • subroutine CREGR1 β€” long boi, all of it, no edits: (trans, m, n, ly, kl, ku, alpha, a, lda, x, incx, beta, y, incy, ys) πŸŽ€
  • subroutine XERBLA β€” the classic, taking (srname, info) πŸ‘‘

That's every single entry in the synopsis, bestie β€” nothing dropped, nothing merged, nothing "cleaned up" πŸ’–

✨ Function/Subroutine Documentation ✨

okay bestie, buckle up β€” this is the part where the page just... lists everything. Every single routine in cblat2.f, signature and all. No descriptions for most of them (the source is lowkey mysterious like that πŸ™ˆ), but we are NOT skipping any, because every detail matters. πŸ’…


🌸 CBEG

complex function CBEG (logical reset)

Definition at line 3155 of file cblat2.f.

(that's it. that's the whole entry. she's giving mystery, she's giving "look me up in the source" energy ✨)


πŸ‘‘ program CBLAT2

πŸŽ€ Purpose:

fr fr this is the main character of the whole file, so listen up:

Test program for the COMPLEX Level 2 Blas.

The program must be driven by a short data file. The first 18 records of the file are read using list-directed input, and the last 17 records are read using the format ( A6, L2 ). An annotated example of a data file can be obtained by deleting the first 3 characters from the following 35 lines β€” and here they are, verbatim, don't touch anything:

!> 'cblat2.out'      NAME OF SUMMARY OUTPUT FILE
!> 6                 UNIT NUMBER OF SUMMARY FILE
!> 'CBLA2T.SNAP'     NAME OF SNAPSHOT OUTPUT FILE
!> -1                UNIT NUMBER OF SNAPSHOT FILE (NOT USED IF .LT. 0)
!> F        LOGICAL FLAG, T TO REWIND SNAPSHOT FILE AFTER EACH RECORD.
!> F        LOGICAL FLAG, T TO STOP ON FAILURES.
!> T        LOGICAL FLAG, T TO TEST ERROR EXITS.
!> 16.0     THRESHOLD VALUE OF TEST RATIO
!> 6                 NUMBER OF VALUES OF N
!> 0 1 2 3 5 9       VALUES OF N
!> 4                 NUMBER OF VALUES OF K
!> 0 1 2 4           VALUES OF K
!> 4                 NUMBER OF VALUES OF INCX AND INCY
!> 1 2 -1 -2         VALUES OF INCX AND INCY
!> 3                 NUMBER OF VALUES OF ALPHA
!> (0.0,0.0) (1.0,0.0) (0.7,-0.9)       VALUES OF ALPHA
!> 3                 NUMBER OF VALUES OF BETA
!> (0.0,0.0) (1.0,0.0) (1.3,-1.1)       VALUES OF BETA
!> CGEMV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CGBMV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CHEMV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CHBMV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CHPMV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CTRMV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CTBMV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CTPMV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CTRSV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CTBSV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CTPSV  T PUT F FOR NO TEST. SAME COLUMNS.
!> CGERC  T PUT F FOR NO TEST. SAME COLUMNS.
!> CGERU  T PUT F FOR NO TEST. SAME COLUMNS.
!> CHER   T PUT F FOR NO TEST. SAME COLUMNS.
!> CHPR   T PUT F FOR NO TEST. SAME COLUMNS.
!> CHER2  T PUT F FOR NO TEST. SAME COLUMNS.
!> CHPR2  T PUT F FOR NO TEST. SAME COLUMNS.

🧚 Further Details

===============

See:

Dongarra J. J., Du Croz J. J., Hammarling S. and Hanson R. J.. An extended set of Fortran Basic Linear Algebra Subprograms. Technical Memoranda Nos. 41 (revision 3) and 81, Mathematics and Computer Science Division, Argonne National Laboratory, 9700 South Cass Avenue, Argonne, Illinois 60439, US. Or NAG Technical Reports TR3/87 and TR4/87, Numerical Algorithms Group Ltd., NAG Central Office, 256 Banbury Road, Oxford OX2 7DE, UK, and Numerical Algorithms Group Inc., 1101 31st Street, Suite 100, Downers Grove, Illinois 60515-1263, USA.
-- Written on 10-August-1987. Richard Hanson, Sandia National Labs. Jeremy Du Croz, NAG Central Office. 10-9-00: Change STATUS='NEW' to 'UNKNOWN' so that the testers can be run multiple times without deleting generated output files (susan)

(shoutout susan for that one, we stan a maintainer who fixes the rerun pain πŸ™)

Author

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

Definition at line 102 of file cblat2.f.


πŸ§ͺ CCHK1

subroutine CCHK1 (character*6 sname, real eps, real thresh, integer nout,
    integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
    integer, dimension( nidim ) idim, integer nkb, integer, dimension( nkb )
    kb, integer nalf, complex, dimension( nalf ) alf, integer nbet, complex,
    dimension( nbet ) bet, integer ninc, integer, dimension( ninc ) inc,
    integer nmax, integer incmax, complex, dimension( nmax, nmax ) a,
    complex, dimension( nmax*nmax ) aa, complex, dimension( nmax*nmax ) as,
    complex, dimension( nmax ) x, complex, dimension( nmax*incmax ) xx,
    complex, dimension( nmax*incmax ) xs, complex, dimension( nmax ) y,
    complex, dimension( nmax*incmax ) yy, complex, dimension( nmax*incmax )
    ys, complex, dimension( nmax ) yt, real, dimension( nmax ) g)

Definition at line 434 of file cblat2.f.


πŸ§ͺ CCHK2

subroutine CCHK2 (character*6 sname, real eps, real thresh, integer nout,
    integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
    integer, dimension( nidim ) idim, integer nkb, integer, dimension( nkb )
    kb, integer nalf, complex, dimension( nalf ) alf, integer nbet, complex,
    dimension( nbet ) bet, integer ninc, integer, dimension( ninc ) inc,
    integer nmax, integer incmax, complex, dimension( nmax, nmax ) a,
    complex, dimension( nmax*nmax ) aa, complex, dimension( nmax*nmax ) as,
    complex, dimension( nmax ) x, complex, dimension( nmax*incmax ) xx,
    complex, dimension( nmax*incmax ) xs, complex, dimension( nmax ) y,
    complex, dimension( nmax*incmax ) yy, complex, dimension( nmax*incmax )
    ys, complex, dimension( nmax ) yt, real, dimension( nmax ) g)

Definition at line 807 of file cblat2.f.


πŸ§ͺ CCHK3

subroutine CCHK3 (character*6 sname, real eps, real thresh, integer nout,
    integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
    integer, dimension( nidim ) idim, integer nkb, integer, dimension( nkb )
    kb, integer ninc, integer, dimension( ninc ) inc, integer nmax, integer
    incmax, complex, dimension( nmax, nmax ) a, complex, dimension(
    nmax*nmax ) aa, complex, dimension( nmax*nmax ) as, complex, dimension(
    nmax ) x, complex, dimension( nmax*incmax ) xx, complex, dimension(
    nmax*incmax ) xs, complex, dimension( nmax ) xt, real, dimension( nmax )
    g, complex, dimension( nmax ) z)

Definition at line 1155 of file cblat2.f.

notice how CCHK3 has xt and z instead of y/yt/yy/ys β€” she's built different, and yes that's just how it is πŸ’…


πŸ§ͺ CCHK4

subroutine CCHK4 (character*6 sname, real eps, real thresh, integer nout,
    integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
    integer, dimension( nidim ) idim, integer nalf, complex, dimension( nalf
    ) alf, integer ninc, integer, dimension( ninc ) inc, integer nmax,
    integer incmax, complex, dimension( nmax, nmax ) a, complex, dimension(
    nmax*nmax ) aa, complex, dimension( nmax*nmax ) as, complex, dimension(
    nmax ) x, complex, dimension( nmax*incmax ) xx, complex, dimension(
    nmax*incmax ) xs, complex, dimension( nmax ) y, complex, dimension(
    nmax*incmax ) yy, complex, dimension( nmax*incmax ) ys, complex,
    dimension( nmax ) yt, real, dimension( nmax ) g, complex, dimension(
    nmax ) z)

Definition at line 1516 of file cblat2.f.


πŸ§ͺ CCHK5

subroutine CCHK5 (character*6 sname, real eps, real thresh, integer nout,
    integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
    integer, dimension( nidim ) idim, integer nalf, complex, dimension( nalf
    ) alf, integer ninc, integer, dimension( ninc ) inc, integer nmax,
    integer incmax, complex, dimension( nmax, nmax ) a, complex, dimension(
    nmax*nmax ) aa, complex, dimension( nmax*nmax ) as, complex, dimension(
    nmax ) x, complex, dimension( nmax*incmax ) xx, complex, dimension(
    nmax*incmax ) xs, complex, dimension( nmax ) y, complex, dimension(
    nmax*incmax ) yy, complex, dimension( nmax*incmax ) ys, complex,
    dimension( nmax ) yt, real, dimension( nmax ) g, complex, dimension(
    nmax ) z)

Definition at line 1793 of file cblat2.f.


πŸ§ͺ CCHK6

subroutine CCHK6 (character*6 sname, real eps, real thresh, integer nout,
    integer ntra, logical trace, logical rewi, logical fatal, integer nidim,
    integer, dimension( nidim ) idim, integer nalf, complex, dimension( nalf
    ) alf, integer ninc, integer, dimension( ninc ) inc, integer nmax,
    integer incmax, complex, dimension( nmax, nmax ) a, complex, dimension(
    nmax*nmax ) aa, complex, dimension( nmax*nmax ) as, complex, dimension(
    nmax ) x, complex, dimension( nmax*incmax ) xx, complex, dimension(
    nmax*incmax ) xs, complex, dimension( nmax ) y, complex, dimension(
    nmax*incmax ) yy, complex, dimension( nmax*incmax ) ys, complex,
    dimension( nmax ) yt, real, dimension( nmax ) g, complex, dimension(
    nmax, 2 ) z)

Definition at line 2077 of file cblat2.f.

okay so CCHK4, CCHK5 and CCHK6 look near-identical but CCHK6's z is dimension( nmax, 2 ) β€” two columns, because she needs room for two vectors. not me noticing that on the third read 😭


πŸ§ͺ CCHKE

subroutine CCHKE (integer isnum, character*6 srnamt, integer nout)

Definition at line 2399 of file cblat2.f.


πŸ” CHKXER

subroutine CHKXER (character*6 srnamt, integer infot, integer nout, logical
    lerr, logical ok)

Definition at line 3223 of file cblat2.f.


πŸ—οΈ CMAKE

subroutine CMAKE (character*2 type, character*1 uplo, character*1 diag,
    integer m, integer n, complex, dimension( nmax, * ) a, integer nmax,
    complex, dimension( * ) aa, integer lda, integer kl, integer ku, logical
    reset, complex transl)

Definition at line 2742 of file cblat2.f.


🎬 CMVCH

subroutine CMVCH (character*1 trans, integer m, integer n, complex alpha,
    complex, dimension( nmax, * ) a, integer nmax, complex, dimension( * )
    x, integer incx, complex beta, complex, dimension( * ) y, integer incy,
    complex, dimension( * ) yt, real, dimension( * ) g, complex, dimension(
    * ) yy, real eps, real err, logical fatal, integer nout, logical mv)

Definition at line 2934 of file cblat2.f.


🧡 CREGR1

subroutine CREGR1 (character*1 trans, integer m, integer n, integer ly,
    integer kl, integer ku, complex alpha, complex, dimension(lda,*) a,
    integer lda, complex, dimension(*) x, integer incx, complex beta,
    complex, dimension(*) y, integer incy, complex, dimension(*) ys)

Definition at line 3251 of file cblat2.f.


🫢 LCE

logical function LCE (complex, dimension( * ) ri, complex, dimension( * )
    rj, integer lr)

Definition at line 3066 of file cblat2.f.


🫢 LCERES

logical function LCERES (character*2 type, character*1 uplo, integer m,
    integer n, complex, dimension( lda, * ) aa, complex, dimension( lda, * )
    as, integer lda)

Definition at line 3096 of file cblat2.f.


πŸ“ SDIFF

real function SDIFF (real x, real y)

Definition at line 3207 of file cblat2.f.


🚨 XERBLA

subroutine XERBLA (character*6 srname, integer info)

Definition at line 3284 of file cblat2.f.


πŸ’œ Author

Generated automatically by Doxygen for LAPACK from the source code.


and that's the whole page bestie, you made it to the end πŸŽ‰πŸ’– every routine, every dimension, every last logical, all accounted for β€” no skips, no summaries, periodt.

this diva right here is LAPACK, Version 3.12.0, straight from cblat2.f, and yes she was auto-generated by Doxygen for LAPACK from the source code β€” iconic behaviour honestly 🫢✨

πŸ“¦ where this page comes from