lis_matrix_convert(3f)

✨ NAME ✨

lis_matrix_convert — convert the matrix format 💅

okay so real quick bestie, this one lives in the Lis Library Functions collection, and the page itself is lis_matrix_convert(3f) — a Fortran-callable routine, no cap. Its whole job? Glow-up your matrix from one storage format into another. Slay. 🦋

---

🌸 SYNOPSIS 🌸

subroutine lis_matrix_convert(LIS_MATRIX Ain, LIS_MATRIX Aout, LIS_INTEGER ierr);

---

💖 DESCRIPTION 💖

Convert matrix Ain into Aout of the format specified by lis_matrix_set_type.

That's literally it. You hand it a matrix, it hands you back the same matrix wearing a different outfit, and the outfit is whatever you told lis_matrix_set_type to put it in. Iconic behavior honestly. 👑

---

🎀 INPUT 🎀

• Ain — The source matrix. this is the one you're converting FROM, your before pic 📸

---

🧚 OUTPUT 🧚

• Aout — The destination matrix. this is the after pic, freshly formatted ✨

---

💅 NOTE 💅

okay here's the tea, and it's important tea:

• The storage format of the Aout is set by lis_matrix_set_type. You gotta tell it what you want BEFORE, bestie.
• The block size of the BSR, BSC, and VBR formats is set by lis_matrix_set_blocksize. Those three care about block size, the rest don't. 🫶
• The conversions indicated by 1 in the table below are performed directly — no detours, straight shot.
• The other ones are performed via the indicated formats — so like, it takes a lil connecting flight through whatever format is named in the cell.
• The conversions with no indication are performed via the CSR format. CSR is the main character of the airport, everyone connects through it. ✈️

And here's the full conversion map, verbatim, every single cell, no edits, no crumbs left behind:

┌─────────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┐
│ Src/Dst │  CSR │  CSC │  MSR │  DIA │  ELL │  JAD │  BSR │  BSC │  VBR │  COO │  DNS │
├─────────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
│ CSR     │      │  1   │  1   │  1   │  1   │  1   │  1   │  CSC │  1   │  1   │  1   │
├─────────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
│ COO     │  1   │  1   │  1   │  CSR │  CSR │  CSR │  CSR │  CSC │  CSR │      │  CSR │
└─────────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┘

👀 little vibe check on the blank cells: a CSR → CSR conversion has no 1 and no format named, so it goes via CSR (which, yeah, it already is CSR). And a COO → COO conversion is the same deal — no indication, so it routes through CSR. The table is telling you the routing, not judging you. 💀

---

🌈 SEE ALSO 🌈

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

---

that's the whole page bestie, you ate it up 🍓 this was the Man Page for lis_matrix_convert(3f), dated 6 Sep 2012. go forth and convert, mwah 💋