ZSYL01(3)

📦 version 3.12.0, in opensuse-leap 16.0

🦋 NAME 🦋

okay so bestie, this is the manual page for /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/EIG/zsyl01.f — yes that's the whole path, she's long, she's giving filesystem realness 💅 and it lives in the zsyl01.f(3) section of the manual, slay.

✨ SYNOPSIS ✨

Functions/Subroutines

subroutine ZSYL01 (thresh, nfail, rmax, ninfo, knt)
    ZSYL01

like literally that's it, that's the girl 🎀

🌸 Function/Subroutine Documentation 🌸

subroutine ZSYL01 (double precision thresh, integer, dimension( 3 ) nfail,
    double precision, dimension( 2 ) rmax, integer, dimension( 2 ) ninfo,
    integer knt)

ZSYL01 💖 (yes, the same name twice, she said "my name is my name" 👑

💜 Purpose

!> !> ZSYL01 tests ZTRSYL and ZTRSYL3, routines for solving the Sylvester matrix !> equation !> !> op(A)*X + ISGN*X*op(B) = scale*C, !> !> where op(A) and op(B) are both upper triangular form, op() represents an !> optional conjugate transpose, and ISGN can be -1 or +1. Scale is an output !> less than or equal to 1, chosen to avoid overflow in X. !> !> The test code verifies that the following residual does not exceed !> the provided threshold: !> !> norm(op(A)*X + ISGN*X*op(B) - scale*C) / !> (EPS*max(norm(A),norm(B))*norm(X)) !> !> This routine complements ZGET35 by testing with larger, !> random matrices, of which some require rescaling of X to avoid overflow. !> !>

so basically: she's the vibe-check routine for ZTRSYL and ZTRSYL3 🌈 she solves the whole Sylvester matrix equation situation, and then she's like "and did you do it correctly, bestie?" and checks the residual against your threshold. no cap, that's the whole job 🔥

🎀 Parameters 🎀

  • THRESH — THRESH is DOUBLE PRECISION. A test will count as ... if the residual, computed as described above, exceeds THRESH. 🫶
  • NFAIL — NFAIL is INTEGER array, dimension (3).
    • NFAIL(1) = No. of times residual ZTRSYL exceeds threshold THRESH
    • NFAIL(2) = No. of times residual ZTRSYL3 exceeds threshold THRESH
    • NFAIL(3) = No. of times ZTRSYL3 and ZTRSYL deviate

three little counters, each one doing her own thing 💅

  • RMAX — RMAX is DOUBLE PRECISION array, dimension (2).
    • RMAX(1) = Value of the largest test ratio of ZTRSYL
    • RMAX(2) = Value of the largest test ratio of ZTRSYL3

like the biggest ratio each one ever pulled — main character energy, recorded for the archives 👑

  • NINFO — NINFO is INTEGER array, dimension (2).
    • NINFO(1) = No. of times ZTRSYL returns an expected INFO
    • NINFO(2) = No. of times ZTRSYL3 returns an expected INFO

manifesting correct INFO values only ✨

  • KNT — KNT is INTEGER. Total number of examples tested. that's the headcount at the party 🍓

💀 Definition 💀

Definition at line 88 of file zsyl01.f. (yes, line 88, iconic number, no notes 🙈)

🌟 Author 🌟

Generated automatically by Doxygen for LAPACK from the source code. like she was born this way, machine-made and flawless 🧚

and that's the whole page bestie!! 💖 this beauty came to you from LAPACK, Version 3.12.0, dated /home/abui...IG/zsyl01.f(3) — mwah, go test some matrices, ily 🫶✨

📦 where this page comes from