lis_matrix_set_size(3)

✨ lis_matrix_set_size — bestie edition 💖

okay so we're in the Lis Library Functions corner of the manual, section 3, and today's main character is lis_matrix_set_size(3) 🎀

---

🌸 NAME 🌸

lis_matrix_set_size — assign the size of the matrix. that's it, that's the job, and she does it flawlessly 💅

---

🦋 SYNOPSIS 🦋

#include "lis.h"

LIS_INT lis_matrix_set_size(LIS_MATRIX A, LIS_INT local_n, LIS_INT
global_n);

---

✨ DESCRIPTION ✨

Assign the size of matrix A. like, you're telling the matrix how big she is. iconic behavior honestly.

---

🎀 INPUT 🎀

• A — the matrix herself 👑
• local_n — the number of rows of the partial matrix. yes, partial, we're being specific here.
• global_n — the number of rows of the global matrix. the big picture number, if you will.

---

💀 EXIT STATUS 💀

the following exit values are returned, no cap:

• 0 — the process is normally terminated 🫶 everything's fine, we're thriving
• unspecified — an error occurred 😭 not the vibe. something went wrong and it's giving chaos.

---

⚠️ NOTE ⚠️

okay bestie this part is important so pay attention:

Either local_n or global_n must be provided. you gotta give her one of them, fr fr.

In the case of the serial and multithreaded environments, local_n is equal to global_n. so it literally does not matter which one you hand over. Therefore, both lis_matrix_set_size(A,n,0) and lis_matrix_set_size(A,0,n) create a matrix of size n x n. same result, two paths, both slay ✨

For the multiprocessing environment though? different story:

• lis_matrix_set_size(A,n,0) creates a partial matrix of size n x N on each processing element, where N is the total sum of n. 🔥
• On the other hand, lis_matrix_set_size(A,0,n) creates a partial matrix of size m_p x n on the processing element p. The values of m_p are determined by the library. 👑 (not by you, not by me — by the library. respect her authority.)

---

🌈 SEE ALSO 🌈

• lis(3)
• http://www.ssisc.org/lis/ — go visit, she's got lore 💜

---

and that's the whole page bestie 🧚 sourced from the Lis Library Functions, dated 6 Sep 2012, which is giving vintage but she still eats. mwah, go set some sizes 💖🌸💅