mattress 0.0.6

all your matrix representations belong here!

mattress

This project provides tatami matrix representations in Python.

Install

Package is published to PyPI

pip install mattress

Usage

Dense matrices

To convert a numpy dense matrix to tatami representation -

import numpy as np
from mattress import tatamize

x = np.random.rand(1000, 100)

tatamat = tatamize(y)

Methods

Methods are available to access the matrix by row, column

tatamat.row(0)
tatamat.column(1)

Also works if the matrix is row-major order.

x = np.ones((2, 3), order='F')
tatamat = tatamize(y)

Is your matrix sparse?

from scipy.sparse import rand
m = rand(3, 4, density=0.25, format="csr", random_state=42)
tatamat = tatamize(m)

Developer Notes

Steps to setup dependencies -

• initialize git submodules in extern/tatami & extern/tatami_hdf5

First one needs to build the extern library, this would generate a shared object file to src/mattress/core-[*].so

python setup.py build_ext --inplace

For typical development workflows, run this for tests

python setup.py build_ext --inplace && tox

To rebuild the ctypes bindings with the wrap.py helper

wrap.py src/mattress/lib --py src/mattress/cpphelpers.py --cpp src/mattress/lib/bindings.cpp

Note

This project has been set up using PyScaffold 4.5. For details and usage information on PyScaffold see https://pyscaffold.org/.