papyri
{ } Raw JSON

bundles / scipy latest / scipy / io / _fast_matrix_market / mmread

function

scipy.io._fast_matrix_market:mmread

source: /scipy/io/_fast_matrix_market/__init__.py :298

Signature

def   mmread ( source ,  * ,  spmatrix = True )

Summary

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.

Returns

a : ndarray or coo_array

Dense or sparse array depending on the matrix format in the Matrix Market file.

Notes

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 array in COO format. 
m = mmread(StringIO(text), spmatrix=False)
✓
m
✗
m.toarray()
✓
This method is threaded. The default number of threads is equal to the number of CPUs in the system. Use `threadpoolctl <https://github.com/joblib/threadpoolctl>`_ to override: 
import threadpoolctl
with threadpoolctl.threadpool_limits(limits=2):
    m = mmread(StringIO(text), spmatrix=False)
⚠

Aliases

  • scipy.io.mmread

Referenced by

This package