掩码数组运算

常量

ma.MaskType

bool 的别名

创建

从现有数据创建

ma.masked_array	MaskedArray 的别名
ma.array (data[, dtype, copy, order, mask, ...])	一个具有可能掩码值的数组类.
ma.copy (self, args, \params) a.copy(order=)	返回数组的副本.
ma.frombuffer (buffer[, dtype, count, ...])	将缓冲区解释为一维数组.
ma.fromfunction (function, shape, \dtype)	通过对每个坐标执行一个函数来构造一个数组.
ma.MaskedArray.copy ([order])	返回数组的副本.
ma.diagflat	创建一个二维数组,将展平的输入作为对角线.

全1和全0

ma.empty (shape[, dtype, order, device, like])	返回给定形状和类型的新数组,而不初始化条目.
ma.empty_like (prototype[, dtype, order, ...])	返回一个与给定数组具有相同形状和类型的新数组.
ma.masked_all (shape[, dtype])	所有元素都被屏蔽的空屏蔽数组.
ma.masked_all_like (arr)	具有现有数组属性的空屏蔽数组.
ma.ones (shape[, dtype, order])	返回一个给定形状和类型的新数组,填充为 1.
ma.ones_like	返回一个与给定数组具有相同形状和类型的 1 数组.
ma.zeros (shape[, dtype, order, like])	返回一个给定形状和类型的新数组,填充为零.
ma.zeros_like	返回一个与给定数组具有相同形状和类型的零数组.

---

检查数组

ma.all (self[, axis, out, keepdims])	如果所有元素都计算为 True,则返回 True.
ma.any (self[, axis, out, keepdims])	如果 a 的任何元素计算为 True,则返回 True.
ma.count (self[, axis, keepdims])	计算给定轴上数组的非屏蔽元素.
ma.count_masked (arr[, axis])	沿给定轴计算屏蔽元素的数量.
ma.getmask (a)	返回掩码数组的掩码,或者 nomask.
ma.getmaskarray (arr)	返回掩码数组的掩码,或者由 False 组成的完整布尔数组.
ma.getdata (a[, subok])	将屏蔽数组的数据作为 ndarray 返回.
ma.nonzero (self)	返回非掩码且非零元素的索引.
ma.shape (obj)	返回数组的形状.
ma.size (obj[, axis])	返回沿给定轴的元素数.
ma.is_masked (x)	确定输入是否具有掩码值.
ma.is_mask (m)	如果 m 是有效的标准掩码,则返回 True.
ma.isMaskedArray (x)	测试输入是否为 MaskedArray 的实例.
ma.isMA (x)	测试输入是否为 MaskedArray 的实例.
ma.isarray (x)	测试输入是否为 MaskedArray 的实例.
ma.isin (element, test_elements[, ...])	计算 element in test_elements ,仅对 element 进行广播.
ma.in1d (ar1, ar2[, assume_unique, invert])	测试数组的每个元素是否也存在于第二个数组中.
ma.unique (ar1[, return_index, return_inverse])	查找数组的唯一元素.
ma.MaskedArray.all ([axis, out, keepdims])	如果所有元素都计算为 True,则返回 True.
ma.MaskedArray.any ([axis, out, keepdims])	如果 a 的任何元素计算为 True,则返回 True.
ma.MaskedArray.count ([axis, keepdims])	计算给定轴上数组的非屏蔽元素.
ma.MaskedArray.nonzero ()	返回非掩码且非零元素的索引.
ma.shape (obj)	返回数组的形状.
ma.size (obj[, axis])	返回沿给定轴的元素数.

ma.MaskedArray.data	返回底层数据,作为掩码数组的视图.
ma.MaskedArray.mask	当前掩码.
ma.MaskedArray.recordmask	获取或设置数组的掩码,如果它没有命名字段.

---

操作 MaskedArray

改变形状

ma.ravel (self[, order])	以视图的形式返回 self 的 1D 版本.
ma.reshape (a, new_shape[, order])	返回一个包含相同数据但具有新形状的数组.
ma.resize (x, new_shape)	返回具有指定大小和形状的新掩码数组.
ma.MaskedArray.flatten ([order])	返回折叠成一维的数组副本.
ma.MaskedArray.ravel ([order])	以视图的形式返回 self 的 1D 版本.
ma.MaskedArray.reshape (s, \kwargs)	在不更改其数据的情况下为数组赋予新形状.
ma.MaskedArray.resize (newshape[, refcheck, ...])

修改轴

ma.swapaxes (self, args, ...)	返回一个 axis1 和 axis2 互换的数组视图.
ma.transpose (a[, axes])	置换数组的维度.
ma.MaskedArray.swapaxes (axis1, axis2)	返回一个 axis1 和 axis2 互换的数组视图.
ma.MaskedArray.transpose (axes)	返回一个轴转置的数组视图.

改变维度数量

ma.atleast_1d	将输入转换为至少具有一个维度的数组.
ma.atleast_2d	将输入视为至少具有两个维度的数组.
ma.atleast_3d	将输入视为至少具有三个维度的数组.
ma.expand_dims (a, axis)	展开数组的形状.
ma.squeeze	从 a 中删除长度为 1 的轴.
ma.MaskedArray.squeeze ([axis])	从 a 中删除长度为 1 的轴.
ma.stack	沿新轴连接一系列数组.
ma.column_stack	将 1-D 数组作为列堆叠到 2-D 数组中.
ma.concatenate (arrays[, axis])	沿给定轴连接一系列数组.
ma.dstack	沿深度方向(沿第三个轴)顺序堆叠数组.
ma.hstack	按水平方向(按列)顺序堆叠数组.
ma.hsplit	将数组水平(按列)分割成多个子数组.
ma.mr_	将切片对象转换为沿第一轴的串联.
ma.vstack	按垂直方向(按行)顺序堆叠数组.

连接数组

ma.concatenate (arrays[, axis])	沿给定轴连接一系列数组.
ma.stack	沿新轴连接一系列数组.
ma.vstack	按垂直方向(按行)顺序堆叠数组.
ma.hstack	按水平方向(按列)顺序堆叠数组.
ma.dstack	沿深度方向(沿第三个轴)顺序堆叠数组.
ma.column_stack	将 1-D 数组作为列堆叠到 2-D 数组中.
ma.append (a, b[, axis])	将值追加到数组的末尾.

---

掩码的操作

创建掩码

ma.make_mask (m[, copy, shrink, dtype])	从数组创建一个布尔掩码.
ma.make_mask_none (newshape[, dtype])	返回给定形状的布尔掩码,并用 False 填充.
ma.mask_or (m1, m2[, copy, shrink])	使用 logical_or 运算符组合两个掩码.
ma.make_mask_descr (ndtype)	从给定的 dtype 构建一个 dtype 描述列表.

访问掩码

ma.getmask (a)	返回掩码数组的掩码,或者 nomask.
ma.getmaskarray (arr)	返回掩码数组的掩码,或者由 False 组成的完整布尔数组.
ma.masked_array.mask	当前掩码.

查找被掩码的数据

ma.ndenumerate (a[, compressed])	多维索引迭代器.
ma.flatnotmasked_contiguous (a)	在屏蔽数组中查找连续的未屏蔽数据.
ma.flatnotmasked_edges (a)	查找第一个和最后一个未屏蔽值的索引.
ma.notmasked_contiguous (a[, axis])	在给定轴上查找掩码数组中的连续非掩码数据.
ma.notmasked_edges (a[, axis])	查找沿轴的第一个和最后一个未屏蔽值的索引.
ma.clump_masked (a)	返回对应于 1-D 数组的掩码块的切片列表.
ma.clump_unmasked (a)	返回对应于 1-D 数组的未掩码块的切片列表.

修改掩码

ma.mask_cols (a[, axis])	屏蔽 2D 数组中包含掩码值的列.
ma.mask_or (m1, m2[, copy, shrink])	使用 logical_or 运算符组合两个掩码.
ma.mask_rowcols (a[, axis])	屏蔽包含屏蔽值的二维数组的行和/或列.
ma.mask_rows (a[, axis])	屏蔽包含屏蔽值的二维数组的行.
ma.harden_mask (self)	强制掩码为硬掩码,防止通过赋值取消掩码.
ma.soften_mask (self)	强制掩码为软掩码(默认值),允许通过赋值取消掩码.
ma.MaskedArray.harden_mask ()	强制掩码为硬掩码,防止通过赋值取消掩码.
ma.MaskedArray.soften_mask ()	强制掩码为软掩码(默认值),允许通过赋值取消掩码.
ma.MaskedArray.shrink_mask ()	尽可能将掩码缩减为 nomask.
ma.MaskedArray.unshare_mask ()	复制掩码并将 sharedmask 标志设置为 False .

---

转换操作

> 转换为掩码数组

ma.asarray (a[, dtype, order])	将输入转换为具有给定数据类型的掩码数组.
ma.asanyarray (a[, dtype])	将输入转换为掩码数组,保留子类.
ma.fix_invalid (a[, mask, copy, fill_value])	返回输入,其中无效数据被屏蔽并替换为填充值.
ma.masked_equal (x, value[, copy])	掩盖数组中等于给定值的位置.
ma.masked_greater (x, value[, copy])	掩盖数组中大于给定值的位置.
ma.masked_greater_equal (x, value[, copy])	掩盖数组中大于或等于给定值的位置.
ma.masked_inside (x, v1, v2[, copy])	掩盖数组中位于给定区间内的位置.
ma.masked_invalid (a[, copy])	掩盖数组中出现无效值(NaN 或 inf)的位置.
ma.masked_less (x, value[, copy])	掩盖数组中小于给定值的位置.
ma.masked_less_equal (x, value[, copy])	掩盖数组中小于或等于给定值的位置.
ma.masked_not_equal (x, value[, copy])	掩盖数组中不等于给定值的位置.
ma.masked_object (x, value[, copy, shrink])	屏蔽数组 x 中数据完全等于 value 的部分.
ma.masked_outside (x, v1, v2[, copy])	屏蔽给定区间外的数组.
ma.masked_values (x, value[, rtol, atol, ...])	使用浮点数相等性进行掩盖.
ma.masked_where (condition, a[, copy])	在满足条件的地方屏蔽数组.

> 转换为ndarray

ma.compress_cols (a)	移除包含掩码值的二维数组的整个列.
ma.compress_rowcols (x[, axis])	移除包含掩码值的二维数组的行和/或列.
ma.compress_rows (a)	移除包含掩码值的二维数组的整个行.
ma.compressed (x)	将所有未屏蔽的数据作为 1-D 数组返回.
ma.filled (a[, fill_value])	将输入值作为 ndarray 返回,其中被屏蔽的值由 fill_value 替换.
ma.MaskedArray.compressed ()	将所有未屏蔽的数据作为 1-D 数组返回.
ma.MaskedArray.filled ([fill_value])	返回自身的副本,屏蔽值用给定值填充.

> 转换为其他对象

ma.MaskedArray.tofile (fid[, sep, format])	以二进制格式将掩码数组保存到文件.
ma.MaskedArray.tolist ([fill_value])	将掩码数组的数据部分作为分层 Python 列表返回.
ma.MaskedArray.torecords ()	将掩码数组转换为灵活类型数组.
ma.MaskedArray.tobytes ([fill_value, order])	将数组数据作为包含数组中原始字节的字符串返回.

填充掩码数组

ma.common_fill_value (a, b)	返回两个掩码数组的公共填充值(如果存在).
ma.default_fill_value (obj)	返回参数对象的默认填充值.
ma.maximum_fill_value (obj)	返回对象 dtype 可以表示的最小值.
ma.minimum_fill_value (obj)	返回对象 dtype 可以表示的最大值.
ma.set_fill_value (a, fill_value)	如果a是masked array,则设置a的填充值.
ma.MaskedArray.get_fill_value ()	掩码数组的填充值是一个标量.
ma.MaskedArray.set_fill_value ([value])

ma.MaskedArray.fill_value

掩码数组的填充值是一个标量.

---

掩码数组的算术运算

算术

ma.anom (self[, axis, dtype])	计算给定轴上的异常(偏离算术平均值).
ma.anomalies (self[, axis, dtype])	计算给定轴上的异常(偏离算术平均值).
ma.average (a[, axis, weights, returned, ...])	返回数组在给定轴上的加权平均值.
ma.conjugate (x, /[, out, where, casting, ...])	返回复共轭,按元素计算.
ma.corrcoef (x[, y, rowvar, bias, ...])	返回 Pearson 乘积矩相关系数.
ma.cov (x[, y, rowvar, bias, allow_masked, ddof])	估计协方差矩阵.
ma.cumsum (self[, axis, dtype, out])	返回给定轴上数组元素的累积和.
ma.cumprod (self[, axis, dtype, out])	返回给定轴上数组元素的累积乘积.
ma.mean (self[, axis, dtype, out, keepdims])	返回给定轴上的数组元素的平均值.
ma.median (a[, axis, out, overwrite_input, ...])	计算沿指定轴的中位数.
ma.power (a, b[, third])	返回以第二个数组为幂逐元素提升的基数组.
ma.prod (self[, axis, dtype, out, keepdims])	返回给定轴上数组元素的乘积.
ma.std (self[, axis, dtype, out, ddof, ...])	返回给定轴上数组元素的标准差.
ma.sum (self[, axis, dtype, out, keepdims])	返回给定轴上的数组元素的和.
ma.var (self[, axis, dtype, out, ddof, ...])	沿指定轴计算方差.
ma.MaskedArray.anom ([axis, dtype])	计算给定轴上的异常(偏离算术平均值).
ma.MaskedArray.cumprod ([axis, dtype, out])	返回给定轴上数组元素的累积乘积.
ma.MaskedArray.cumsum ([axis, dtype, out])	返回给定轴上数组元素的累积和.
ma.MaskedArray.mean ([axis, dtype, out, keepdims])	返回给定轴上的数组元素的平均值.
ma.MaskedArray.prod ([axis, dtype, out, keepdims])	返回给定轴上数组元素的乘积.
ma.MaskedArray.std ([axis, dtype, out, ddof, ...])	返回给定轴上数组元素的标准差.
ma.MaskedArray.sum ([axis, dtype, out, keepdims])	返回给定轴上的数组元素的和.
ma.MaskedArray.var ([axis, dtype, out, ddof, ...])	沿指定轴计算方差.

最小值/最大值

ma.argmax (self[, axis, fill_value, out])	返回给定轴上最大值的索引数组.
ma.argmin (self[, axis, fill_value, out])	返回给定轴上最小值索引的数组.
ma.max (obj[, axis, out, fill_value, keepdims])	返回给定轴上的最大值.
ma.min (obj[, axis, out, fill_value, keepdims])	返回给定轴上的最小值.
ma.ptp (obj[, axis, out, fill_value, keepdims])	沿给定维度返回(最大值 - 最小值)(即峰峰值).
ma.diff (a, /[, n, axis, prepend, append])	计算沿给定轴的第 n 个离散差值.
ma.MaskedArray.argmax ([axis, fill_value, ...])	返回给定轴上最大值的索引数组.
ma.MaskedArray.argmin ([axis, fill_value, ...])	返回给定轴上最小值索引的数组.
ma.MaskedArray.max ([axis, out, fill_value, ...])	返回给定轴上的最大值.
ma.MaskedArray.min ([axis, out, fill_value, ...])	返回给定轴上的最小值.
ma.MaskedArray.ptp ([axis, out, fill_value, ...])	沿给定维度返回(最大值 - 最小值)(即峰峰值).

排序

ma.argsort (a[, axis, kind, order, endwith, ...])	返回一个ndarray,其中包含沿指定轴对数组进行排序的索引.
ma.sort (a[, axis, kind, order, endwith, ...])	返回masked array的排序副本.
ma.MaskedArray.argsort ([axis, kind, order, ...])	返回一个ndarray,其中包含沿指定轴对数组进行排序的索引.
ma.MaskedArray.sort ([axis, kind, order, ...])	对数组进行排序,就地排序

代数

ma.diag (v[, k])	提取对角线或构造对角数组.
ma.dot (a, b[, strict, out])	返回两个数组的点积.
ma.identity (n[, dtype])	返回单位数组.
ma.inner (a, b, /)	两个数组的内积.
ma.innerproduct (a, b, /)	两个数组的内积.
ma.outer (a, b)	计算两个向量的外积.
ma.outerproduct (a, b)	计算两个向量的外积.
ma.trace (self[, offset, axis1, axis2, ...])	返回数组对角线元素的和.
ma.transpose (a[, axes])	置换数组的维度.
ma.MaskedArray.trace ([offset, axis1, axis2, ...])	返回数组对角线元素的和.
ma.MaskedArray.transpose (axes)	返回一个轴转置的数组视图.

多项式拟合

ma.vander (x[, n])	生成范德蒙矩阵.
ma.polyfit (x, y, deg[, rcond, full, w, cov])	最小二乘多项式拟合.

裁剪和取整

ma.around	将数组四舍五入到给定的小数位数.
ma.clip	裁剪(限制)数组中的值.
ma.round (a[, decimals, out])	返回 a 的副本,四舍五入到“小数”位.
ma.MaskedArray.clip ([min, max, out])	返回一个值被限制在 [min, max] 范围内的数组.
ma.MaskedArray.round ([decimals, out])	返回每个元素四舍五入到给定小数位后的值.

集合运算

ma.intersect1d (ar1, ar2[, assume_unique])	返回两个数组共有的唯一元素.
ma.setdiff1d (ar1, ar2[, assume_unique])	具有唯一元素的1D数组的集合差.
ma.setxor1d (ar1, ar2[, assume_unique])	具有唯一元素的1-D数组的集合异或.
ma.union1d (ar1, ar2)	两个数组的并集.

杂项

ma.allequal (a, b[, fill_value])	如果 a 和 b 的所有条目都相等,则返回 True,其中使用 fill_value 作为真值,当其中一个或两个都被屏蔽时.
ma.allclose (a, b[, masked_equal, rtol, atol])	如果两个数组在元素方面在公差范围内相等,则返回 True.
ma.amax (a[, axis, out, keepdims, initial, where])	返回数组的最大值或沿轴的最大值.
ma.amin (a[, axis, out, keepdims, initial, where])	返回数组的最小值或沿轴的最小值.
ma.apply_along_axis (func1d, axis, arr, ...)	沿给定轴将函数应用于 1-D 切片.
ma.apply_over_axes (func, a, axes)	在多个轴上重复应用一个函数.
ma.arange ([start,] stop[, step,][, dtype, ...])	返回给定间隔内的均匀间隔的值.
ma.choose (indices, choices[, out, mode])	使用索引数组从一系列选择中构造一个新的数组.
ma.compress_nd (x[, axis])	从包含掩码值的多个维度中移除切片.
ma.convolve (a, v[, mode, propagate_mask])	返回两个一维序列的离散线性卷积.
ma.correlate (a, v[, mode, propagate_mask])	两个一维序列的互相关.
ma.ediff1d (arr[, to_end, to_begin])	计算数组中连续元素之间的差异.
ma.flatten_mask (mask)	返回 mask 的完全扁平化版本,其中嵌套字段被折叠.
ma.flatten_structured_array (a)	扁平化一个结构化数组.
ma.fromflex (fxarray)	从合适的灵活类型数组构建一个屏蔽数组.
ma.indices (dimensions[, dtype, sparse])	返回表示网格索引的数组.
ma.left_shift (a, n)	将整数的位向左移动.
ma.ndim (obj)	返回数组的维数.
ma.put (a, indices, values[, mode])	将存储索引位置设置为相应的值.
ma.putmask (a, mask, values)	基于条件和输入值更改数组的元素.
ma.right_shift (a, n)	将整数的位向右移动.
ma.round_ (a[, decimals, out])	返回 a 的副本,四舍五入到“小数”位.
ma.take (a, indices[, axis, out, mode])
ma.where (condition[, x, y])	返回一个屏蔽数组,其元素来自 x 或 y ,具体取决于条件.