HPL_pdlaprnt(3)

💖 HPL_pdlaprnt — bestie, it's from the HPL Library Functions 💖

okay so real quick, the vibe: this is HPL_pdlaprnt(3), a whole icon in the HPL Library Functions lineup. no cap.

---

✨ NAME ✨

HPL_pdlaprnt — print a distributed matrix A. that's it, that's the whole job, and she does it flawlessly 💅

---

🎀 SYNOPSIS 🎀

#include "hpl.h"

void HPL_pdlaprnt( const HPL_T_grid * GRID, const int M, const int N,
const int NB, double * A, const int LDA, const int IAROW, const int
IACOL, const char * CMATNM );

---

🌸 DESCRIPTION 🌸

okay so HPL_pdlaprnt prints a distributed matrix A to standard error. not stdout, bestie — standard error. read that again, i'll wait. 🫶

the way it works is genuinely so cunty: the local pieces of A get sent over to the process at coordinates (0,0) in the grid, and then they get printed. so everybody's little shard of the matrix takes a lil trip to process (0,0) and that one process does the printing. main character energy fr fr 👑

---

🌈 ARGUMENTS 🌈

• GRID (local input) — const HPL_T_grid * on entry, GRID points to the data structure holding all the process grid info. it's the map of who's where, basically. 🗺️
• M (global input) — const int on entry, M says how many rows the coefficient matrix A has. and listen — M must be at least zero. negative rows? not a thing, we don't do that here. 💀
• N (global input) — const int on entry, N says how many columns the coefficient matrix A has. same rule, bestie: N must be at least zero. ✨
• NB (global input) — const int on entry, NB is the blocking factor used to partition and distribute the matrix. and heads up — NB must be larger than one. not one, not zero, larger than one. periodt. 🎀
• A (local input) — double * on entry, A points to an array of dimension (LDA,LocQ(N)). this array holds the coefficient matrix that's about to get printed. she's the moment. 💖
• LDA (local input) — const int on entry, LDA is the leading dimension of the array A. and it must be at least max(1,LocP(M)). do the math, don't skip it. 🧮
• IAROW (global input) — const int on entry, IAROW is the row process coordinate that owns the first row of A. it must be larger than or equal to zero and less than NPROW. stay in your lane, literally. 🌸
• IACOL (global input) — const int on entry, IACOL is the column process coordinate that owns the first column of A. it must be larger than or equal to zero and less than NPCOL. same energy, different axis. 🦋
• CMATNM (global input) — const char * on entry, CMATNM is the name of the matrix that's getting printed. give her a name, she deserves one. 💜

lowkey important: every single one of those "must be" rules? yeah, those are real. ignore them and it's giving undefined behaviour, and not the fun kind. 😭

---

👀 SEE ALSO 👀

• HPL_fprintf (3) — go read her too, she's iconic in her own right.

---

okay and finally, the lil sign-off moment: this whole page is HPL 2.2, dated February 24, 2016. yeah, she's an older queen but she still ate and left no crumbs. stan forever. 💅✨🌈