lis_matrix_set_dia(3f)

📦 version 2.1.11, in fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

✨ lis_matrix_set_dia — bestie edition ✨

okay so this is a page from the Lis Library Functions manual, and today we're talking about lis_matrix_set_dia 💅. it's a Fortran subroutine, it lives in section 3f, and it's lowkey one of those little glue functions that makes the whole DIA thing work. let's get into it 🫶

🌸 NAME 🌸

lis_matrix_set_dia — it associates the arrays in the DIA format with the matrix. that's the whole job. iconic, honestly 👑

🎀 SYNOPSIS 🎀

subroutine lis_matrix_set_dia(LIS_INTEGER nnd, LIS_INTEGER index[],
LIS_SCALAR value[], LIS_MATRIX A, LIS_INTEGER ierr);

yes bestie, that's the exact signature, copy it character for character, no notes 💖

🦋 DESCRIPTION 🦋

so what it does is: it associates the arrays in the DIA format with matrix A. that's it. that's the vibe. the arrays are the DIA-format ones, the matrix is A, and this function is the matchmaker ✨

💜 INPUT 💜

  • nnd — the number of nonzero elements, fr fr. that's the count you're handing over.
  • index, value — the arrays in the DIA format. these are your actual data, the index array and the value array, coming in as a pair 🍓
  • A — the matrix. your main character, the one everything is being associated with 👑

🌈 OUTPUT 🌈

  • A — the matrix, now associated with the arrays. she's been matched up, she's thriving 💅

💀 NOTE 💀

okay listen, this one actually matters: after lis_matrix_set_dia is called, the function lis_matrix_assemble must be called. no skipping, no procrastinating. set it, then assemble it. periodt 🎀

🌟 SEE ALSO 🌟

and that's the page, bestie 🧚 go forth and associate those arrays. this little writeup comes straight from the Man Page source, dated 6 Sep 2012, and it's the lis_matrix_set_dia(3f) page from the Lis Library Functions manual — so if you ever need to cite it, that's the tea 💖✨

📦 where this page comes from