MArray adds masks to your favorite Python Array API Standard compatible array library.

Install with pip:

pip install marray

or conda:

conda install -c conda-forge marray-python

Use the from...import...as syntax to get a masked array namespace.

# use with any Array API compatible library, installed separately
from marray import numpy as mxp
import numpy as xp  # optional (if the non-masked namespace is desired)

The resulting mxp namespace has all the features of xp that are specified in the Array API standard, but they are modified to be mask-aware. Typically, the signatures of functions in the mxp namespace match those in the standard; the one notable exception is the addition of a mask keyword argument of asarray.

mxp.asarray([1, 2, 3], mask=[False, True, False])
# MArray(array([1, 2, 3]), array([False,  True, False]))

In the spirit of the Zen of Python, this is the one and only obvious way to set the mask of an array.

Documentation provided by attributes of xp are exposed in the mxp namespace and are accessible via help. For more information, please see the tutorial.