lis(3)

💖 lis(3) — Introduction to Library Functions 💖

hiii bestie, welcome to the lis(3) page, aka your little gateway into the Library of Iterative Solvers 💅 (and yes, the manual name literally is "Introduction to Library Functions", we're being fancy today ✨)

---

✨ NAME ✨

lis — library of iterative solvers for linear systems 🧚

---

🌸 SYNOPSIS 🌸

[see Lis User Guide for full description]

ngl the synopsis is literally just that one line pointing you at the Lis User Guide — no cap, that's the whole vibe here 🙈

---

🎀 DESCRIPTION 🎀

So. Lis — that's Library of Iterative Solvers for linear systems, pronounced [lis] — is a parallel software library for solving discretized linear equations and eigenvalue problems that show up when you numerically solve partial differential equations with iterative methods. It's giving very "I do serious math but make it scalable" energy 🔥

Lis provides facilities for:

• Automatic program configuration ⚙️
• NUMA aware hybrid implementation with MPI and OpenMP 👑
• Exchangeable dense and sparse matrix storage formats 🍓
• Basic linear algebra operations for dense and sparse matrices ➕
• Parallel iterative methods for linear equations and eigenvalue problems 💜
• Parallel preconditioners for iterative methods 🫶
• Quadruple precision floating point operations 🔬
• Performance analysis 📊
• Command-line interface to solvers and benchmarks 💻

---

🦋 SYSTEM REQUIREMENTS 🦋

Installing Lis requires a C compiler. If you wish to use the Fortran interface, a Fortran compiler is needed, and the algebraic multigrid preconditioner requires a Fortran 90 compiler. For parallel computing environments, an OpenMP or an MPI library is necessary. Lis supports both the Harwell-Boeing and Matrix Market formats for importing and exporting user data.

lowkey important: no C compiler, no Lis. the Fortran interface and the AMG preconditioner each have their own extra compiler requirements, so don't skip those 👀

---

💅 REFERENCES 💅

• Akira Nishida (2010). "Experience in Developing an Open Source Scalable Software Infrastructure in Japan". Computational Science and Its Applications - ICCSA 2010. Lecture Notes in Computer Science 6017. Springer. pp. 87-98. doi:10.1007/978-3-642-12165-4_36. ISBN 3-642-12164-0.
• Hisashi Kotakemori, Hidehiko Hasegawa, Tamito Kajiyama, Akira Nukada, Reiji Suda, and Akira Nishida (2008). "Performance Evaluation of Parallel Sparse Matrix-Vector Products on SGI Altix 3700". OpenMP Shared Memory Parallel Programming. Lecture Notes in Computer Science 4315. Springer. pp. 153-163. doi:10.1007/978-3-540-68555-5_13. ISBN 3-540-68554-5.
• Hisashi Kotakemori, Hidehiko Hasegawa, and Akira Nishida (2005). "Performance Evaluation of a Parallel Iterative Method Library using OpenMP". Proceedings of the 8th International Conference on High Performance Computing in Asia Pacific Region (HPC Asia 2005). Beijing: IEEE. pp. 432-436. doi:10.1109/HPCASIA.2005.74. ISBN 0-7695-2486-9.
• Akihiro Fujii, Akira Nishida, and Yoshio Oyanagi (2005). "Evaluation of Parallel Aggregate Creation Orders : Smoothed Aggregation Algebraic Multigrid Method". High Performance Computational Science and Engineering. Springer. pp. 99-122. doi:10.1007/0-387-24049-7_6. ISBN 1-4419-3684-X.

citations stay citations, bestie — DOIs and ISBNs are sacred 💀 don't come for them

---

🌈 SEE ALSO 🌈

• lsolve(1), esolve(1), hpcg_kernel(1), hpcg_spmvtest(1), spmvtest1(1), spmvtest2(1), spmvtest2b(1), spmvtest3(1), spmvtest3b(1), spmvtest4(1), spmvtest5(1)
• http://www.ssisc.org/lis/
• http://math.nist.gov/MatrixMarket/

---

and that's the whole page, bestie — go forth and solve some linear systems iteratively ✨🫶

sign-off moment 🎀: this was lis(3) from the Man Page, dated 25 Oct 2016. iconic, historic, we love her 💖