操作掩码数组

meta:

name: keywords content: 操作掩码数组
name: description content: 这里介绍的是使用numpy来操作掩码数组的一些API方法。

操作掩码数组

常量

方法	描述
ma.MaskType	numpy.bool_的别名

创建

从现有数据

方法	描述
ma.masked_array	numpy.ma.core.MaskedArray 的别名
ma.array(data[, dtype, copy, order, mask, …])	具有可能被屏蔽的值的数组类。
ma.copy(self, args, *params) a.copy(order=)	返回数组的副本。
ma.frombuffer(buffer[, dtype, count, offset])	将缓冲区解释为一维数组。
ma.fromfunction(function, shape, **kwargs)	通过在每个坐标上执行一个函数来构造一个数组。
ma.MaskedArray.copy([order])	返回数组的副本。

Ones 和 zeros

方法	描述
ma.empty(shape[, dtype, order])	返回给定形状和类型的新数组，而无需初始化条目。
ma.empty_like(prototype[, dtype, order, …])	返回形状和类型与给定数组相同的新数组。
ma.masked_all(shape[, dtype])	清空所有元素都被屏蔽的掩码数组。
ma.masked_all_like(arr)	清空具有现有数组属性的掩码数组。
ma.ones(shape[, dtype, order])	返回给定形状和类型的新数组，并填充为1。
ma.zeros(shape[, dtype, order])	返回给定形状和类型的新数组，并用0填充。

检查数组

方法	描述
ma.all(self[, axis, out, keepdims])	如果所有元素的评估结果为True，则返回True。
ma.any(self[, axis, out, keepdims])	如果评估的任何元素为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.MaskedArray.all(self[, axis, out, keepdims])	如果所有元素的评估结果为True，则返回True。
ma.MaskedArray.any(self[, axis, out, keepdims])	如果评估的任何元素为True，则返回True。
ma.MaskedArray.count(self[, axis, keepdims])	沿给定轴计算数组的非掩码元素。
ma.MaskedArray.nonzero(self)	返回不为零的未屏蔽元素的索引。
ma.shape(obj)	返回数组的形状。
ma.size(obj[, axis])	返回沿给定轴的元素数。

方法	描述
ma.MaskedArray.data	返回基础数据，作为掩码数组的视图。
ma.MaskedArray.mask	当前的掩码。
ma.MaskedArray.recordmask	如果没有命名字段，则获取或设置数组的掩码。

操作 MaskedArray

改变形状

方法	描述
ma.ravel(self[, order])	返回self的一维版本，作为视图。
ma.reshape(a, new_shape[, order])	返回一个数组，其中包含具有相同形状的相同数据。
ma.resize(x, new_shape)	返回具有指定大小和形状的新的掩码数组。
ma.MaskedArray.flatten([order])	返回折叠成一维的数组副本。
ma.MaskedArray.ravel(self[, order])	返回self的一维版本，作为视图。
ma.MaskedArray.reshape(self, s, *kwargs)	在不更改数据的情况下为数组赋予新的形状。
ma.MaskedArray.resize(self, newshape[, …])

修改轴

方法	描述
ma.swapaxes(self, *args, …)	返回轴1和轴2互换的数组视图。
ma.transpose(a[, axes])	排列数组的尺寸。
ma.MaskedArray.swapaxes(axis1, axis2)	返回轴1和轴2互换的数组视图。
ma.MaskedArray.transpose(*axes)	返回轴已转置的数组视图。

更改尺寸数量

方法	描述
ma.atleast_1d(args, *kwargs)	将输入转换为至少一维的数组。
ma.atleast_2d(args, *kwargs)	将输入视为至少具有二维的数组。
ma.atleast_3d(args, *kwargs)	将输入查看为至少具有三个维度的数组。
ma.expand_dims(a, axis)	扩展数组的形状。
ma.squeeze(a[, axis])	从数组形状中删除一维条目。
ma.MaskedArray.squeeze([axis])	从a的形状中删除一维条目。
ma.stack(args, *kwargs)	沿新轴连接一系列数组。
ma.column_stack(args, *kwargs)	将一维数组作为列堆叠到二维数组中。
ma.concatenate(arrays[, axis])	沿给定轴连接一系列数组。
ma.dstack(args, *kwargs)	沿深度方向（沿第三轴）按顺序堆叠数组。
ma.hstack(args, *kwargs)	水平（按列）顺序堆叠数组。
ma.hsplit(args, *kwargs)	水平（按列）将一个数组拆分为多个子数组。
ma.mr_	沿第一个轴将切片对象平移为串联。
ma.row_stack(args, *kwargs)	垂直（行）按顺序堆叠数组。
ma.vstack(args, *kwargs)	垂直（行）按顺序堆叠数组。

连接数组

方法	描述
ma.stack(args, *kwargs)	沿新轴连接一系列数组。
ma.column_stack(args, *kwargs)	将一维数组作为列堆叠到二维数组中。
ma.concatenate(arrays[, axis])	沿给定轴连接一系列数组。
ma.append(a, b[, axis])	将值附加到数组的末尾。
ma.dstack(args, *kwargs)	沿深度方向（沿第三轴）按顺序堆叠数组。
ma.hstack(args, *kwargs)	水平（按列）顺序堆叠数组。
ma.vstack(args, *kwargs)	垂直（行）按顺序堆叠数组。

在掩码数组上操作

创建一个“掩面”

方法	描述
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.flatnotmasked_contiguous(a)	沿给定轴在掩码数组中查找连续的未掩码数据。
ma.flatnotmasked_edges(a)	查找第一个和最后一个未屏蔽值的索引。
ma.notmasked_contiguous(a[, axis])	沿给定轴在掩码数组中查找连续的未掩码数据。
ma.notmasked_edges(a[, axis])	查找沿轴的第一个和最后一个未被遮掩的值索引。
ma.clump_masked(a)	返回与一维数组的掩码块相对应的切片列表。
ma.clump_unmasked(a)	返回与一维数组的未掩码块对应的切片列表。

修改掩码

方法	描述
ma.mask_cols(a[, axis])	对包含掩码值的2D数组的掩码列进行掩码。
ma.mask_or(m1, m2[, copy, shrink])	将两个掩码与logical_or运算符结合使用。
ma.mask_rowcols(a[, axis])	对包含掩码值的2D数组的行和/或列进行掩码。
ma.mask_rows(a[, axis])	对包含掩码值的2D数组的行进行掩码。
ma.harden_mask(self)	强制让掩码变硬。
ma.soften_mask(self)	强制让掩码变软。
ma.MaskedArray.harden_mask(self)	强制让掩码变硬。
ma.MaskedArray.soften_mask(self)	强制让掩码变软。
ma.MaskedArray.shrink_mask(self)	尽可能将掩码减小为无掩码。
ma.MaskedArray.unshare_mask(self)	复制掩码，并将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])	掩盖发生无效值（NaNs或infs）的数组。
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。
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)	将所有非掩码数据作为一维数组返回。
ma.filled(a[, fill_value])	以数组形式返回输入，其中掩码数据被填充值替换。
ma.MaskedArray.compressed(self)	将所有非屏蔽数据作为一维数组返回。
ma.MaskedArray.filled(self[, fill_value])	返回self的副本，其中掩码值填充有给定值。

输出到其他对象

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

酸洗和解酸

方法	描述
ma.dump(a, F)	将掩码数组腌制到文件中。
ma.dumps(a)	返回与蒙版数组的酸洗相对应的字符串。
ma.load(F)	cPickle.load周围的包装器，它可以接受类似文件的对象或文件名。
ma.loads(strg)	从当前字符串中加载一个泡菜。

填充掩码数组

方法	描述
ma.common_fill_value(a, b)	返回两个掩码数组的通用填充值（如果有）。
ma.default_fill_value(obj)	返回参数对象的默认填充值。
ma.maximum_fill_value(obj)	返回可以由对象的dtype表示的最小值。
ma.maximum_fill_value(obj)	返回可以由对象的dtype表示的最小值。
ma.set_fill_value(a, fill_value)	如果a是掩码数组，则设置a的填充值。
ma.MaskedArray.get_fill_value(self)	掩码数组的填充值为标量。
ma.MaskedArray.set_fill_value(self[, 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, …])	返回皮尔逊积矩相关系数。
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, keepdims])	返回沿给定轴的数组元素的标准偏差。
ma.sum(self[, axis, dtype, out, keepdims])	返回给定轴上数组元素的总和。
ma.var(self[, axis, dtype, out, ddof, keepdims])	计算沿指定轴的方差。
ma.MaskedArray.anom(self[, axis, dtype])	沿给定轴计算异常（与算术平均值的偏差）。
ma.MaskedArray.cumprod(self[, axis, dtype, out])	返回给定轴上数组元素的累积乘积。
ma.MaskedArray.cumsum(self[, axis, dtype, out])	返回给定轴上数组元素的累积和。
ma.MaskedArray.mean(self[, axis, dtype, …])	返回沿给定轴的数组元素的平均值。
ma.MaskedArray.prod(self[, axis, dtype, …])	返回给定轴上数组元素的乘积。
ma.MaskedArray.std(self[, axis, dtype, out, …])	返回沿给定轴的数组元素的标准偏差。
ma.MaskedArray.sum(self[, axis, dtype, out, …])	返回给定轴上数组元素的总和。
ma.MaskedArray.var(self[, axis, dtype, out, …])	计算沿指定轴的方差。

最小/最大

方法	描述
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.MaskedArray.argmax(self[, axis, …])	返回沿给定轴的最大值的索引数组。
ma.MaskedArray.argmin(self[, axis, …])	将索引数组沿给定轴返回最小值。
ma.MaskedArray.max(self[, axis, out, …])	沿给定轴返回最大值。
ma.MaskedArray.min(self[, axis, out, …])	沿给定轴返回最小值。
ma.MaskedArray.ptp(self[, axis, out, …])	沿给定维度（即

排序

方法	描述
ma.argsort(a[, axis, kind, order, endwith, …])	返回索引的ndarray，该索引沿指定的轴对数组进行排序。
ma.sort(a[, axis, kind, order, endwith, …])	就地对数组排序
ma.MaskedArray.argsort(self[, axis, kind, …])	返回索引的ndarray，该索引沿指定的轴对数组进行排序。
ma.MaskedArray.sort(self[, axis, kind, …])	就地对数组排序

代数

方法	描述
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(a, args, *kwargs)	将数组舍入到给定的小数位数。
ma.clip(a, a_min, a_max[, out])	裁剪（限制）数组中的值。
ma.round(a[, decimals, out])	返回a的副本，四舍五入到“小数”位。
ma.MaskedArray.clip([min, max, out])	返回其值限制为[min, max]的数组。
ma.MaskedArray.round(self[, decimals, out])	返回四舍五入到给定小数位数的每个元素。

杂项

方法	描述
ma.allequal(a, b[, fill_value])	如果a和b的所有条目都相等，则使用fill_value作为其中一个或两个都被屏蔽的真值，返回True。
ma.allclose(a, b[, masked_equal, rtol, atol])	如果两个数组在公差范围内按元素方式相等，则返回True。
ma.apply_along_axis(func1d, axis, arr, …)	将函数应用于沿给定轴的一维切片。
ma.arange([start,] stop[, step,][, dtype])	返回给定间隔内的均匀间隔的值。
ma.choose(indices, choices[, out, mode])	使用索引数组从一组选择中构造一个新数组。
ma.ediff1d(arr[, to_end, to_begin])	计算数组的连续元素之间的差异。
ma.indices(dimensions[, dtype, sparse])	返回表示网格索引的数组。
ma.where(condition[, x, y])	根据条件返回带有x或y元素的掩码数组。