+ Yj|Rt^RIt^RIHt^RIt^RIHtHtHtH t H t H t H t H t Ht^RIHtHtHt^RIHt.ROtRtRtR ]/R ltRR lt!R R4tR tR#)z Matrix Market I/O in Python. See http://math.nist.gov/MatrixMarket/formats.html for information about the Matrix Market format. N)warn) asarrayrealimagconjzerosndarray concatenateonescan_cast) coo_arrayissparse coo_matrix)_NoValueMMFilecf\V\4'dVPR4#\V4#)latin1) isinstancebytesdecodestr)ss&O/home/luca/screen-checking/.venv/lib/python3.14/site-packages/scipy/io/_mmio.pyasstrrs'!Uxx!! q6Mc,\PV4#)a Return size and storage parameters from Matrix Market file-like 'source'. Parameters ---------- source : str or file-like Matrix Market filename (extension .mtx) or open file-like object Returns ------- rows : int Number of matrix rows. cols : int Number of matrix columns. entries : int Number of non-zero entries of a sparse matrix or rows*cols for a dense matrix. format : str Either 'coordinate' or 'array'. field : str Either 'real', 'complex', 'pattern', or 'integer'. symmetry : str Either 'general', 'symmetric', 'skew-symmetric', or 'hermitian'. Examples -------- >>> from io import StringIO >>> from scipy.io import mminfo >>> text = '''%%MatrixMarket matrix coordinate real general ... 5 5 7 ... 2 3 1.0 ... 3 4 2.0 ... 3 5 3.0 ... 4 1 4.0 ... 4 2 5.0 ... 4 3 6.0 ... 4 4 7.0 ... ''' ``mminfo(source)`` returns the number of rows, number of columns, format, field type and symmetry attribute of the source file. >>> mminfo(StringIO(text)) (5, 5, 7, 'coordinate', 'real', 'general') )rinfo)sources&rmminfor!s` ;;v rspmatrixc6\4PWR7#)a Reads the contents of a Matrix Market file-like 'source' into a matrix. Parameters ---------- source : str or file-like Matrix Market filename (extensions .mtx, .mtz.gz) or open file-like object. spmatrix : bool, optional (default: True) If ``True``, return sparse matrix. Otherwise return sparse array. .. deprecated:: 1.18.0 The default value for `spmatrix` is changing to False in v1.20. That means the default return value will be a sparse array. Unless you use * instead of @, ** for matrix power, or you depend on 2D shapes from e.g. ``A.sum(axis=0)`` it may not matter to you. See :ref:`Migration from spmatrix to sparray `. Returns ------- a : ndarray or coo_array or coo_matrix Dense or sparse array depending on the matrix format in the Matrix Market file. Examples -------- >>> from io import StringIO >>> from scipy.io import mmread >>> text = '''%%MatrixMarket matrix coordinate real general ... 5 5 7 ... 2 3 1.0 ... 3 4 2.0 ... 3 5 3.0 ... 4 1 4.0 ... 4 2 5.0 ... 4 3 6.0 ... 4 4 7.0 ... ''' ``mmread(source)`` returns the data as sparse matrix in COO format. >>> m = mmread(StringIO(text), spmatrix=False) >>> m >>> m.toarray() array([[0., 0., 0., 0., 0.], [0., 0., 1., 0., 0.], [0., 0., 0., 2., 3.], [4., 5., 6., 7., 0.], [0., 0., 0., 0., 0.]]) )r)rread)rrs&$rmmreadr"Vsl 8=== 33rc<\4PWW#WE4R#)a Writes the sparse or dense array `a` to Matrix Market file-like `target`. Parameters ---------- target : str or file-like Matrix Market filename (extension .mtx) or open file-like object. a : array like Sparse or dense 2-D array. comment : str, optional Comments to be prepended to the Matrix Market file. field : None or str, optional Either 'real', 'complex', 'pattern', or 'integer'. precision : None or int, optional Number of digits to display for real or complex values. symmetry : None or str, optional Either 'general', 'symmetric', 'skew-symmetric', or 'hermitian'. If symmetry is None the symmetry type of 'a' is determined by its values. Examples -------- >>> from io import BytesIO >>> import numpy as np >>> from scipy.sparse import coo_array >>> from scipy.io import mmwrite Write a small NumPy array to a matrix market file. The file will be written in the ``'array'`` format. >>> a = np.array([[1.0, 0, 0, 0], [0, 2.5, 0, 6.25]]) >>> target = BytesIO() >>> mmwrite(target, a) >>> print(target.getvalue().decode('latin1')) %%MatrixMarket matrix array real general % 2 4 1 0 0 2.5 0 0 0 6.25 Add a comment to the output file, and set the precision to 3. >>> target = BytesIO() >>> mmwrite(target, a, comment='\n Some test data.\n', precision=3) >>> print(target.getvalue().decode('latin1')) %%MatrixMarket matrix array real general % % Some test data. % 2 4 1.00e+00 0.00e+00 0.00e+00 2.50e+00 0.00e+00 0.00e+00 0.00e+00 6.25e+00 Convert to a sparse matrix before calling ``mmwrite``. This will result in the output format being ``'coordinate'`` rather than ``'array'``. >>> target = BytesIO() >>> mmwrite(target, coo_array(a), precision=3) >>> print(target.getvalue().decode('latin1')) %%MatrixMarket matrix coordinate real general % 2 4 3 1 1 1.00e+00 2 2 2.50e+00 2 4 6.25e+00 Write a complex Hermitian array to a matrix market file. Note that only six values are actually written to the file; the other values are implied by the symmetry. >>> z = np.array([[3, 1+2j, 4-3j], [1-2j, 1, -5j], [4+3j, 5j, 2.5]]) >>> z array([[ 3. +0.j, 1. +2.j, 4. -3.j], [ 1. -2.j, 1. +0.j, -0. -5.j], [ 4. +3.j, 0. +5.j, 2.5+0.j]]) >>> target = BytesIO() >>> mmwrite(target, z, precision=2) >>> print(target.getvalue().decode('latin1')) %%MatrixMarket matrix array complex hermitian % 3 3 3.0e+00 0.0e+00 1.0e+00 -2.0e+00 4.0e+00 3.0e+00 1.0e+00 0.0e+00 0.0e+00 5.0e+00 2.5e+00 0.0e+00 N)rwrite)targetacommentfield precisionsymmetrys&&&&&&rmmwriter+sP HNN6giBrc a]tRt^toR*t]R4t]R4t]R4t]R4t ]R4t ]R4t ]R4t Rt R t] ]3t]R 4tR tR tR tRtRt]]]]]3t]R4tRtRtRtRt]]]]3t]R4t]R]R]R]R]R/t] R4t!] R4t"]R4t#] R+Rl4t$] R4t%] R4t&R t'R!](/R"lt)R,R$lt*R%t+R&t,R't-R,R(lt.R)t/Vt0R##)-rcVP#N)_rowsselfs&rrows MMFile.rows zzrcVP#r.)_colsr0s&rcols MMFile.cols r4rcVP#r.)_entriesr0s&rentriesMMFile.entries s }}rcVP#r.)_formatr0s&rformat MMFile.formats ||rcVP#r.)_fieldr0s&rr( MMFile.fields {{rcVP#r.) _symmetryr0s&rr*MMFile.symmetrys ~~rcbVPVPVPVP39#r.)rESYMMETRY_SYMMETRICSYMMETRY_SKEW_SYMMETRICSYMMETRY_HERMITIANr0s&r has_symmetryMMFile.has_symmetrys2~~$"9"9"&">">"&"9"9";; ;r coordinatearrayc`WP9dRV RVP 2p\V4hR#)zunknown format type , must be one of N) FORMAT_VALUES ValueError)r1r?msgs&& r_validate_formatMMFile._validate_format(s7 ++ +(0A$BTBTAUVCS/ ! ,rintegerunsigned-integerrcomplexpatternc`WP9dRV RVP 2p\V4hR#)zunknown field type rPN) FIELD_VALUESrR)r1r(rSs&& r_validate_fieldMMFile._validate_field7s7 )) )'w.?@Q@Q?RSCS/ ! *rgeneral symmetriczskew-symmetric hermitianc\WP9d\RV RVP 24hR#)zunknown symmetry type rPN)SYMMETRY_VALUESrR)r1r*s&&r_validate_symmetryMMFile._validate_symmetryEsA // /5hZ@//3/C/C.DFG G 0rintpuint64dDcR#r.rjrrreader MMFile.readerR rcR#r.rjrjrrwriter MMFile.writerWrmrc VPV4wr#VP4pRVP44wrVrxp VPR4'g \ R4hVP 4R8Xg\ RV,4hVP 4R8XdVP pM!VP 4R8Xd VPpV'dFVP4'd/VP4^,R 9dVP4pKLVP4'gVP4pK(VP4p WpP 8XdM\V 4^8Xg"\ RVPR 4,4h\\V 4wrW,p MD\V 4^8Xg"\ R VPR 4,4h\\V 4wrp WWVP 4V P 43V'dVP4## T'dTP4ii;i) aK Return size, storage parameters from Matrix Market file-like 'source'. Parameters ---------- source : str or file-like Matrix Market filename (extension .mtx) or open file-like object Returns ------- rows : int Number of matrix rows. cols : int Number of matrix columns. entries : int Number of non-zero entries of a sparse matrix or rows*cols for a dense matrix. format : str Either 'coordinate' or 'array'. field : str Either 'real', 'complex', 'pattern', or 'integer'. symmetry : str Either 'general', 'symmetric', 'skew-symmetric', or 'hermitian'. c3T"TFp\VP44xK R#5ir.)rstrip).0parts& r MMFile.info..~s>tzz|$$s&(z%%MatrixMarketz%source is not in Matrix Market formatmatrixzProblem reading file header: rNrMzHeader line not of length 2: asciizHeader line not of length 3: %%)_openreadlinesplit startswithrRlower FORMAT_ARRAYFORMAT_COORDINATElstriprslenrmapintclose)r1rstreamclose_itlinemmidrxr?r(r* split_liner2r7r;s&& rr MMFile.info\s6 ::f-/ ??$D>> 2D&??#344 !HII<<>X- !@4!GHH||~(**<///;;==T[[]1%5%B!??,Djjll(J***:!+$%D%)[[%9&:;; j1 +:!+$%D%)[[%9&:;;&)#z&:#GNN$& x s B>H,H,*AH,/C#H,,Ic *\P!V4pT^,R8XEd8\PP T4'g\PP TR,4'd TR,pMk\PP TR,4'd TR,pM5\PP TR,4'd TR,pTP R4'd^RIpTPY4pTR 3#TP R4'd^RIpTPTR 4pTR 3#\Y4pTR 3#TR RR8wd TR,p\Y4pTR 3# \dTR3u#i;i) aReturn an open file stream for reading based on source. If source is a file name, open it (after trying to find it with mtx and gzipped mtx extensions). Otherwise, just return source. Parameters ---------- filespec : str or file-like String giving file name or file-like object mode : str, optional Mode with which to open file, if `filespec` is a file name. Returns ------- fobj : file-like Open file-like object. close_it : bool True if the calling function should close this file when done, false otherwise. Frz.mtxz.mtx.gzz.mtx.bz2z.gzNz.bz2rbT) osfspath TypeErrorpathisfileendswithgzipopenbz2BZ2File)filespecmoderrrs&& rr} MMFile._opens^4 #yy*H 7c>77>>(++77>>(6/22'&0HWW^^HY$677')3HWW^^HZ$788'*4H  ''82t|""6**Xt4t|h-t| }&#f,()Ft|A #U? " #sFFFcaa SPwpo VS 8wd\P#RpRpSPPR9p\ S4'dqSP 4oSP4wrVWV8P4WV8P48wd\P#SP4oV3RlpMVV 3RlpV!4Fwrp V'dV 'd V^8wdRpMcV'd W8wdRp\P!RR7;_uu_4V'd W)8wdRpRRR4V'dV\V 48wdRpV'dKV'dKV'dKM V'd\P#V'd\P#V'd\P#\P# +'giL;i)TFDc3<"SP4F.wwrpW8dSW3,pW#R3xK W8XgK(W"R3xK0 R#5i)FTN)items)ijaijajir&s r symm_iterator+MMFile._get_symmetry..symm_iteratorsG%&WWYMVaSug"//".. &/s 4A Ac3<"\S4F=p\VS4F*pSV,V,SV,V,r2W#W8H3xK, K? R#5ir.)range)rrrrr&ns rrr sHqA"1a[#$Q47AaDGS"00)"sAAFignore)overN)shaperSYMMETRY_GENERALdtypecharr tocoononzerosumtodoknperrstaterrHrIrJ) r&missymmisskewishermrowcolrrr is_diagonalrs f @r _get_symmetryMMFile._get_symmetrys[ww1 6** *% A;; AJS  SYOO$55... A / 1(5 #S{+#(cj"F[[h//#+!&0cT#Y."FFff(7 ,, , 11 1 ,, ,&&&!0/s $G G" c \PRV,\PR\PR\PRW3,/P VR4#)z%%.%ie z%i z%u z%%.%ie %%.%ie N)r FIELD_REAL FIELD_INTEGERFIELD_UNSIGNED FIELD_COMPLEXget)r(r)s&&r_field_templateMMFile._field_template+sW!!: #9$$f%%v$$&7*'+ #eT"  #rc *VP!R/VBR#)Nrj) _init_attrs)r1kwargss&,r__init__MMFile.__init__5s "6"rrc VPV4wr4VPV4VPV4pV'dVP4T\Jd;Rp\ P P\43p\T\TR7RpT'd"\T\4'd \T4pT# T'dTP4ii;i)aT Reads the contents of a Matrix Market file-like 'source' into a matrix. Parameters ---------- source : str or file-like Matrix Market filename (extensions .mtx, .mtz.gz) or open file object. spmatrix : bool, optional (default: True) If ``True``, return sparse matrix. Otherwise return sparse array. .. deprecated:: 1.18.0 The default value for `spmatrix` is changing to False in v1.20. That means the default return value will be a sparse array. Unless you use * instead of @, ** for matrix power, or you depend on 2D shapes from e.g. ``A.sum(axis=0)`` it may not matter to you. See :ref:`Migration from spmatrix to sparray `. Returns ------- a : ndarray or coo_array or coo_matrix Dense or sparse array depending on the matrix format in the Matrix Market file. aThe default value for `spmatrix` is changing to `False` in v1.20. That means the default return type will be a sparse array. Unless you use * instead of @, ** for matrix power, or you depend on 2D shapes from e.g. `A.sum(axis=0)` it may not matter to you. See the spmatrix to sparray migration guide for details. https://docs.scipy.org/doc/scipy/reference/sparse.migration_to_sparray.html )skip_file_prefixesT)r} _parse_header _parse_bodyrrrrdirname__file__rDeprecationWarningrr r)r1rrrrdatarSprefixess&&$ rr! MMFile.read9s2 ::f-    v &##F+D  x C13H (X FH  433d#D # s "B>>CNc VPVR4wrxVPWrW4WV4V'dVP4R#VP4R# T'dTP4iTP4i;i)a Writes sparse or dense array `a` to Matrix Market file-like `target`. Parameters ---------- target : str or file-like Matrix Market filename (extension .mtx) or open file-like object. a : array like Sparse or dense 2-D array. comment : str, optional Comments to be prepended to the Matrix Market file. field : None or str, optional Either 'real', 'complex', 'pattern', or 'integer'. precision : None or int, optional Number of digits to display for real or complex values. symmetry : None or str, optional Either 'general', 'symmetric', 'skew-symmetric', or 'hermitian'. If symmetry is None the symmetry type of 'a' is determined by its values. wbN)r}_writerflush) r1r%r&r'r(r)r*rrs &&&&&&& rr$ MMFile.writens\. ::fd3  KK79 G    sAA+Bc XVPPpVUu.uF q3R,NK pp\VP44\V4, pV'd\ R\ V4 RV 24hVF&p\ WVPVR,R44K( R#uupi)zZ Initialize each attributes with the corresponding keyword arg value or a default of None :NNzfound z, invalid keyword arguments, please only use N) __class__ __slots__setkeysrRtuplesetattrr)r1rattrsattr public_attrs invalid_keyss&, rrMMFile._init_attrss ((-23UTRU 36;;=)C ,== veL&9%:;;;G.JK KD D 48T : ;4sB'c lVPPV4wr#rErgVPW#WEWgR7R#))r2r7r;r?r(r*N)rrr)r1rr2r7r;r?r(r*s&& rrMMFile._parse_headers9 NN   ' 5GU dw$  9rc: VPVPVPVPVPVP 3wr#rErgVP PVR4pVPp W`P8Hp W`P8Hp W`P8Hp WpP8Hp WpP8HpW`P8HpWPP8XEd\!W#3VR7p^p^^ppV 'd^VVV3&VV^, 8d V^, pV'EdHVP#4pV'd%V^,R9gVP%4'gKGV 'd \'V4pMMV 'd \'V4pM9V 'd'\)\+\,VP/44!pM \-V4pVVVV3&V 'd9VV8wd2V 'd V)VVV3&M V'd\1V4VVV3&MVVVV3&VV^, 8d V^,pEK V^,pV 'g^pEKTpV 'gEK,^VVV3&VV^, 8gEKDV^, pEKPV 'd&V^V39dVV^, 8Xg \3R4hV#V^V39dVV8Xg \3R4hV#WPP48XEdWV^8Xd\7W#3VR7#\!VRR7p\!VRR7pV'd\9VRR7pMOV 'd\!VRR7pM9V 'd\!VRR7pM#V 'd\!VRR7pM \!VRR7p^pVEFpV'd%V^,R9gVP%4'gK2V^,V8d \3R 4hVP/4p\+\&VR ,4wVV&VV&V'g|V 'd\'V^,4VV&M]V 'd\'V^,4VV&M?V 'd#\)\+\,VR ,4!VV&M\-V^,4VV&V^, pEK VV8d \3R 4hV^,pV^,pV 'drVV8gpVV,pVV,pVV,p\;VV34p\;VV34pV 'd VR,pMV'dVP=4p\;VV34p\7VVV33W#3VR 7pV#\?V4h)N)rz$Parse error, did not read all lines.intcint8rerfrXfloatz5'entries' in header is smaller than number of entries:NN:rNNz4'entries' in header is larger than number of entries)rrrz) r2r7r;r?r(r*DTYPES_BY_FIELDrrKrrrrIrJ FIELD_PATTERNrrr~rsrrXrrrrrRrr r r conjugateNotImplementedError)r1rr2r7r;r?r(symmrrK is_integeris_unsigned_integer is_complexis_skewis_herm is_patternr&rrrrIJV entry_numberlmaskod_Iod_Jod_Vs&& rrMMFile._parse_bodys|48IItyy48LL$++48JJ 4O0GU$$((5(( 000 #':'::000 666111000 && &tl%0ADaqA!Q$tax<FA$(tAw)34::<<d)C(d)C!3udjjl#;G+$&9::JJL36sAbE?0,<!!*-ad),,*-ad),#*13uae3D*E,*/!+,! )*g% "566 FA FAQwwwD *D *BJD>>+DD *1q!f+d\GA&f- -rc\V\4'g@\V\4'g*\V\4'g\ VR4'EdVP p\ V4p\VP4^8wd \R4hVPwrVeW@P8Xd:\VPR4'g \R4hVPR4pMW@P8Xd.VPP R9dVPR4pMuW@P"8Xd-VPP R9dVPR4pM8\%V4'g\R \'V4 24hR pVPwrVPP p Vf V R 9d^pM^pVfxVPP(p V R 8Xd+\VPR4'g \R4hR pM0V R8XdRpM&V R8XdRpMV R8XdRpM\+RV ,4hVfVP-V4pVP.P1V4VP.P3V4VP.P5V4RV RV RV R2p VP7V P9R44VP;R4F)p RV R2p VP7V P9R44K+ VP=WE4pWpP 8XEdRW3,p VP7V P9R44W@PVPVP>39Ed.W`P@8XdX\CV 4FFp\CV4F4pWVV3,,p VP7V P9R44K6 KH R#W`PD8Xd`\CV 4FNp\CV^,V4F4pWVV3,,p VP7V P9R44K6 KP R#\CV 4FFp\CW4F4pWVV3,,p VP7V P9R44K6 KH R#W@P"8XdW`P@8Xdo\CV 4F]p\CV4FKpVVV3,pV\GV4\IV43,p VP7V P9R44KM K_ R#\CV 4F]p\CW4FKpVVV3,pV\GV4\IV43,p VP7V P9R44KM K_ R#W@PJ8Xd \R4h\+RV 24hVPM4pW`P@8wdhVPNVPP8p\SVPTV,VPNV,VPPV,33VPR7pRWVPV3,p VP7V P9R44VP=WE^, 4pW@PJ8Xdf\YVPN^,VPP^,4F1wppRVV3,p VP7V P9R44K3 R#W@PVPVP>39d\YVPN^,VPP^,VPT4F@wpppRVV3,VV,,p VP7V P9R44KB R#W@P"8Xd\YVPN^,VPP^,VPT4FVwpppRVV3,VVPFVPH3,,p VP7V P9R44KX R#\+RV 24h) __array__zExpected 2 dimensional arrayNrezBmmwrite does not support integer dtypes larger than native 'intp'.fdrgrrhzunknown matrix type: rMfFrrVfrcrXurWzunexpected dtype kind z%%MatrixMarket matrix   rr{z%i %i z*pattern type inconsisted with dense formatzUnknown field type )rz %i %i %i z%i %i )-rlistrrhasattrrrrrrRrr r OverflowErrorastyperrrr typekindrrrrTr\rcr$encoderrrrrrIrrrrrrr rnnzzip)r1rr&r'r(r)r*repr2r7typecoderrrtemplaterrrcoolower_triangle_maskrr rgs&&&&&&& rr MMFile._write2s a  *Q"8"8 a  71k#:#:##C A177|q  !?@@JD ...#AGGV44+-PQQ(Aoo-ww||4/HHSM000ww||4/HHSMA;; #8a !BCCCJD77<<  4  =77<?"-) !=!=="4[!&q1ud!3A#+1g#5D"LLX)>?"4) #4[!&qA#+1g#5D"LLX)>?"0) ,,,444"4[!&tA"#AqD'C#+tCy$s).D#DD"LLX)>?"-) #4[!&qA"#AqD'C#+tCy$s).D#DD"LLX)>?"0) ,,, !MNN "5eW =>>'')C000&)gg&8#*=!>!$)>rrj)r/r6r:r>rBrE)rNNN)1__name__ __module__ __qualname____firstlineno__rpropertyr2r7r;r?r(r*rKrrrQ classmethodrTrrrrrr[r\rrHrIrJrbrcr staticmethodrkrorr}rrrrr!r$rrrr__static_attributes____classdictcell__) __classdict__s@rrrsI;; %L& 5M"" M'NJMM!>:}!#L"" !$.$');.0BDOGG %f%x!3$c$c +O    KK\;;|='='@###1x1j F<$9EPW?W?rc.p^RIpVPVP4^RIpVPVP 4\ V4p\W4'*# \dLHi;i \dL9i;i)z Check whether `stream` is compatible with numpy.fromfile. Passing a gzipped file object to ``fromfile/fromstring`` doesn't work with Python 3. N)rappendGzipFile ImportErrorrrrr)rbad_clsrrs& r_is_fromfile_compatibler1syG t}}% s{{#GnG&* **       s"AA/ A,+A,/ A=<A=)rr"r+rr )__doc__rwarningsrnumpyrrrrrrrr r r scipy.sparser r rscipy._lib.deprecationr__all__rrr"r+rr1rjrrr8sf ###98+ 3 0j64x64vhCXL ?L ?^+r