lis_matrix_set_ell(3)

πŸ“¦ version 2.1.11, in fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

πŸ’– lis_matrix_set_ell β€” bestie edition πŸ’–

okay so this is a page from the Lis Library Functions manual, and today's main character is lis_matrix_set_ell(3). pull up a chair, grab a boba, we're linking arrays to a matrix and it's gonna be so smooth ✨


✨ NAME ✨

lis_matrix_set_ell β€” the way you associate the arrays in the ELL format with the matrix. that's it, that's the whole job, and she does it flawlessly πŸ’…


✨ SYNOPSIS ✨

#include "lis.h"

LIS_INT lis_matrix_set_ell(LIS_INT maxnzr, LIS_INT index[], LIS_SCALAR
value[], LIS_MATRIX A);

like… look at that signature. iconic. no notes 🫢


✨ DESCRIPTION ✨

so basically you're taking the arrays that live in the ELL format and you're introducing them to matrix A. formally: associate the arrays in the ELL format with matrix A. it's giving matchmaker but for data structures πŸ’–


✨ INPUT ✨

  • maxnzr β€” the maximum number of nonzero elements in each row. the ceiling, the limit, the "no row gets more than this many" energy πŸ‘‘
  • index, value β€” the arrays in the ELL format. the actual goods. the whole point of the function tbh 🌸
  • A β€” the matrix. she's the one getting the arrays attached to her ✨

✨ OUTPUT ✨

  • A β€” the matrix, now associated with the arrays. glow up complete πŸ’…

✨ EXIT STATUS ✨

here's what she hands back to you:

  • 0 β€” the process is normally terminated. everything slayed, no crumbs 🌈
  • unspecified β€” an error occurred 😭 (we don't know which one, she's being mysterious, and ngl that's a little stressful)

✨ NOTE ✨

okay listen. this part is not optional. after lis_matrix_set_ell is called, you must call lis_matrix_assemble. no skipping, no "I'll do it later", no "surely it's fine". it is not fine. call it. periodt πŸ’€

✨ SEE ALSO ✨


and that's the whole page bestie!! this was written up under Man Page, dated 6 Sep 2012, and it's from the Lis Library Functions manual, section lis_matrix_set_ell(3). mwah, go call lis_matrix_assemble, ily, bye πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from