SROUNDUP_LWORK.F(3)

Okay bestie, welcome to INSTALL/sroundup_lwork.f from the Library Functions Manual — this is the tiny-but-iconic routine that deals with a subtle bug when you return LWORK as a Float, and it is serving main-character energy. 💅✨

🌸 NAME 🌸

INSTALL/sroundup_lwork.f — that's the name, no cap. 🫶

✨ SYNOPSIS ✨

🧚 Functions/Subroutines 🧚

• real function sroundup_lwork (lwork) — SROUNDUP_LWORK. That's the whole synopsis vibe. 🎀

🎀 FUNCTION/SUBROUTINE DOCUMENTATION 🎀

real function sroundup_lwork (integer lwork)

SROUNDUP_LWORK — say it with me, bestie. 👑

💖 Purpose 💖

SROUNDUP_LWORK deals with a subtle bug with returning LWORK as a Float. This routine guarantees it is rounded up instead of down by multiplying LWORK by 1+eps when it is necessary, where eps is the relative machine precision. E.g.,

float( 16777217            ) == 16777216
float( 16777217 ) * (1.+eps) == 16777218

Then the docs hand us the literal return/verbatim bits:

!> \return SROUNDUP_LWORK
!> \verbatim
!>         SROUNDUP_LWORK >= LWORK.
!>         SROUNDUP_LWORK is guaranteed to have zero decimal part.
!>

💅 Parameters 💅

• LWORK — workspace size. That's it, that's the argument. 🍓

🌈 Author 🌈

Weslley Pereira, University of Colorado Denver, USA. 👑

🔥 Further Details 🔥

!>  This routine was inspired in the method `magma_zmake_lwork` from MAGMA.
!>  \see https://bitbucket.org/icl/magma/src/master/control/magma_zauxiliary.cpp
!>

Definition at line 58 of file sroundup_lwork.f. ✨

💜 AUTHOR 💜

Generated automatically by Doxygen for LAPACK from the source code. 🤖💖

Okay that's the whole page, bestie! Mwah 💋 — from LAPACK Version 3.12.0, page INSTALL/sroundup_lwork.f(3), and there's no date line in the footer to report, so I'm not inventing one. 🦋🌸