lis_matrix_set_vbr(3)

💖 lis_matrix_set_vbr(3) — the one from the Lis Library Functions ✨

okay bestie, sit down, hydrate, because we're about to associate some arrays with a matrix and it's honestly kind of a slay 🫶

---

🌸 NAME 🌸

lis_matrix_set_vbr — associate the arrays in the VBR format with the matrix 💅

---

✨ SYNOPSIS ✨

#include "lis.h"

LIS_INT lis_matrix_set_vbr(LIS_INT nnz, LIS_INT nr, LIS_INT nc, LIS_INT
bnnz, LIS_INT row[], LIS_INT col[], LIS_INT ptr[], LIS_INT bptr[],
LIS_INT bindex[], LIS_SCALAR value[], LIS_MATRIX A);

like… look at her. eleven arguments and she's serving every single one 👑

---

🦋 DESCRIPTION 🦋

So basically: this function associates the arrays in the VBR format with matrix A. That's the whole job. She takes your VBR-format arrays and she hands them over to A. no cap, that's it, that's the vibe 🌈

---

🎀 INPUT 🎀

• nnz — the number of nonzero elements 🔢
• nr — the number of row blocks
• bnc — the number of column blocks 👀 (yes, the synopsis up there calls this one nc, and down here the page says bnc — I'm just telling you what's on the page, don't come for me)
• bnnz — the number of nonzero blocks 🧱
• row, col, ptr, bptr, bindex, value — the arrays in the VBR format. all of them. the whole squad 💜
• A — the matrix 🫶

---

🌟 OUTPUT 🌟

• A — the matrix associated with the arrays ✨ (she's been through a glow-up, she now has the arrays)

---

💀 EXIT STATUS 💀

the following exit values are returned:

• 0 — the process is normally terminated 😌 slay, we love a clean exit
• unspecified — an error occurred 😭 not the vibe, something went wrong

---

🚨 NOTE 🚨

okay this part is IMPORTANT bestie, do not skip it: after lis_matrix_set_vbr is called, the function lis_matrix_assemble must be called. like, must must. you don't get to skip this step, she's not done until you assemble her 💅

---

👑 SEE ALSO 👑

• lis(3)
• http://www.ssisc.org/lis/

---

and that's the page!! 🎀 shoutout to the Lis Library Functions manual, dated 6 Sep 2012, page lis_matrix_set_vbr(3) — go forth, associate those arrays, and call lis_matrix_assemble afterwards or I will know 🌸💖✨