MatrixMarket(3pm)

✨ NAME ✨

PDL::CCS::IO::MatrixMarket — it's giving Matrix Market Exchange Format text I/O for PDL::CCS::Nd, bestie 💖 this is the page for MatrixMarket(3pm) and she EATS.

---

🎀 SYNOPSIS 🎀

okay so first you gotta load the goods:

use PDL;
use PDL::CCS::Nd;
use PDL::CCS::IO::MatrixMarket;

$ccs = PDL::CCS::Nd->newFromWhich($which,$nzvals);

ccs_writemm($ccs,"ccs.mm");     # write a sparse matrix market text file
$ccs2 = ccs_readmm("ccs.mm");   # read a sparse matrix market text file

$dense = random(10,10);         # ... also supported for dense piddles
writemm($dense, "file.mm");     # write a dense matrix market text file
$dense2 = readmm("file.mm");    # read a dense matrix market text file

and that's the whole vibe check 💅 sparse AND dense, she does both, no cap.

---

🌸 I/O Utilities 🌸

💖 ccs_writemm

Write a PDL::CCS::Nd object as a MatrixMarket sparse coordinate text file. slay.

ccs_writemm($ccs,$filename_or_fh)
ccs_writemm($ccs,$filename_or_fh,\%opts)

Options %opts:

• start => $i — index of first element (like perl $[); default=1 for MatrixMarket compatibility
• header => $bool — write embedded PDL::CCS::Nd header? (default=do)

✨ writemm

Write a dense PDL as a MatrixMarket array text file. iconic.

writemm($pdl,$filename_or_handle)
writemm($pdl,$filename_or_handle,\%opts)

Options %opts: (none yet) 🙈

🦋 ccs_readmm

Read a Matrix Market sparse coordinate text file as a PDL::CCS::Nd object using PDL::IO::Misc::rcols(). the way she just… reads it for you 😭

$ccs = ccs_readmm($filename_or_fh)
$ccs = ccs_readmm($filename_or_fh,\%opts)

Options %opts:

• start => $i — index of first element (like perl $[); default=1 for MatrixMarket compatibility
• header => $bool — attempt to read embedded CCS header from file (default=do)
• sorted => $bool — assume input data is sorted (default=0)
• nomagic => $bool — don't check for matrix market magic header (default:do)

🍓 readmm

Read a Matrix Market dense array text file as a dense pdl using PDL::IO::Misc::rcols(). obsessed fr fr.

$pdl = readmm($fname)
$pdl = readmm($fname,\%opts)

Options %opts:

• nomagic => $bool — don't check for matrix market magic header (default:do)

---

🌈 ACKNOWLEDGEMENTS 🌈

• Perl by Larry Wall. 👑
• PDL by Karl Glazebrook, Tuomas J. Lukka, Christian Soeller, and others.

---

👑 AUTHOR 👑

Bryan Jurish <moocow@cpan.org> 🫶

💜 Copyright Policy 💜

Copyright (C) 2015-2024, Bryan Jurish. All rights reserved.

This package is free software, and entirely without warranty. You may redistribute it and/or modify it under the same terms as Perl itself.

ngl "entirely without warranty" is doing a LOT of heavy lifting there but okay periodt 💀

---

🔥 SEE ALSO 🔥

perl, PDL, PDL::CCS::Nd, PDL::CCS::IO::FastRaw, PDL::CCS::IO::FITS, PDL::CCS::IO::LDAC, the matrix market format documentation at <http://math.nist.gov/MatrixMarket/formats.html> ...

---

and that's the whole page bestie 💖 this was perl v5.40.0, dated 2025-01-04, living under the name MatrixMarket(3pm) — go read some matrices, you got this ✨🦋🎀