DLAFTS(3)

📦 version 3.12.0, in opensuse-leap 16.0

🌸 DLAFTS(3) — the vibe-check subroutine for your test ratios 🌸

okay so this is a page out of the LAPACK manual, bestie — DLAFTS lives at /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/EIG/dlafts.f and honestly it's giving "hall monitor of the testing suite" and I mean that as the highest compliment 💅 it literally checks your results and snitches to a file when something flops.

✨ SYNOPSIS ✨

Functions/Subroutines:

subroutine DLAFTS (type, m, n, imat, ntests, result, iseed, thresh,
    iounit, ie)

DLAFTS — that's the whole name, no notes, she said it herself 🎀

🦋 Function/Subroutine Documentation 🦋

subroutine DLAFTS (character*3 type, integer m, integer n, integer imat,
    integer ntests, double precision, dimension( * ) result, integer,
    dimension( 4 ) iseed, double precision thresh, integer iounit, integer
    ie)

DLAFTS 👑 (yes the heading is literally just her name again, iconic behaviour)

heads up bestie: m shows up in the signature but the docs below never give it its own little paragraph. not me noticing 👀 — just relaying the facts fr fr.

🎯 Purpose

!>
!>    DLAFTS tests the result vector against the threshold value to
!>    see which tests for this matrix type failed to pass the threshold.
!>    Output is to the file given by unit IOUNIT.
!>

so like. she takes your RESULT vector, holds it up against THRESH like a bouncer with a clipboard, and any ratio that's too big gets named and shamed in the file on unit IOUNIT 😭💀

🌈 The Arguments (all of them, every single one, no skipping)

!>  TYPE   - CHARACTER*3
!>           On entry, TYPE specifies the matrix type to be used in the
!>           printed messages.
!>           Not modified.
!>
  • TYPE — CHARACTER*3 ✨ on entry this is the matrix type, and it gets dropped right into the printed messages so everyone knows which matrix type is out here failing. Not modified 🫶
!>  N      - INTEGER
!>           On entry, N specifies the order of the test matrix.
!>           Not modified.
!>
  • N — INTEGER 🌸 on entry, N is the order of the test matrix. Not modified.
!>  IMAT   - INTEGER
!>           On entry, IMAT specifies the type of the test matrix.
!>           A listing of the different types is printed by DLAHD2
!>           to the output file if a test fails to pass the threshold.
!>           Not modified.
!>
  • IMAT — INTEGER 🎀 on entry, IMAT is the type of the test matrix. and here's the cute part: if a test fails to pass the threshold, a listing of the different types gets printed by DLAHD2 to the output file. so DLAHD2 is the friend who brings the receipts 📋 Not modified.
!>  NTESTS - INTEGER
!>           On entry, NTESTS is the number of tests performed on the
!>           subroutines in the path given by TYPE.
!>           Not modified.
!>
  • NTESTS — INTEGER 💖 on entry, NTESTS is the number of tests that were performed on the subroutines in the path given by TYPE. Not modified.
!>  RESULT - DOUBLE PRECISION               array of dimension( NTESTS )
!>           On entry, RESULT contains the test ratios from the tests
!>           performed in the calling program.
!>           Not modified.
!>
  • RESULT — DOUBLE PRECISION, array of dimension ( NTESTS ) 🦋 on entry, this holds the test ratios from the tests performed in the calling program. the receipts. the evidence. Not modified — she just reads, she does not touch.
!>  ISEED  - INTEGER            array of dimension( 4 )
!>           Contains the random seed that generated the matrix used
!>           for the tests whose ratios are in RESULT.
!>           Not modified.
!>
  • ISEED — INTEGER, array of dimension ( 4 ) 🍓 this one contains the random seed that generated the matrix used for the tests whose ratios are in RESULT. so if something goes feral you can reproduce it, love that for you. Not modified.
!>  THRESH - DOUBLE PRECISION
!>           On entry, THRESH specifies the acceptable threshold of the
!>           test ratios.  If RESULT( K ) > THRESH, then the K-th test
!>           did not pass the threshold and a message will be printed.
!>           Not modified.
!>
  • THRESH — DOUBLE PRECISION ⭐ on entry, this is the acceptable threshold for the test ratios. the rule: if RESULT( K ) > THRESH, then the K-th test did not pass the threshold and a message gets printed. that's the whole vibe check, no cap. Not modified.
!>  IOUNIT - INTEGER
!>           On entry, IOUNIT specifies the unit number of the file
!>           to which the messages are printed.
!>           Not modified.
!>
  • IOUNIT — INTEGER 💜 on entry, this is the unit number of the file the messages get printed to. the group chat where the callouts land. Not modified.
!>  IE     - INTEGER
!>           On entry, IE contains the number of tests which have
!>           failed to pass the threshold so far.
!>           Updated on exit if any of the ratios in RESULT also fail.
!>
  • IE — INTEGER 🔥 on entry, IE holds the number of tests that have failed to pass the threshold so far. and — plot twist — this one IS updated on exit if any of the ratios in RESULT also fail 🫢 so it's a running tally, a fail counter, the "how many L's have we taken" number.

💖 Author 💖

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

Definition at line 97 of file dlafts.f. ⭐

🌟 Author (yes, again, she's thorough) 🌟

Generated automatically by Doxygen for LAPACK from the source code. 🤖✨ so no human wrote this prose and honestly it shows, but we love her anyway.

and that's the whole page, bestie!! 💅🎀🦋 this absolute queen is documented as LAPACK, Version 3.12.0 — mwah, go pass your thresholds, ily 🫶💖

📦 where this page comes from