Masked array operations

Constants

ma.MaskType

bool_的别名

Creation

From existing data

ma.masked_array	MaskedArray的别名
ma.array（data [，dtype，copy，order，mask，...]）	可能带有掩码值的数组类。
ma.copy（self，\ * args，\ * \ * params）a.copy（order =）	返回数组的副本。
ma.frombuffer（buffer [，dtype，count，offset]）	将缓冲区解释为1维数组。
ma.fromfunction（function，shape，\ * \ * kwargs）	通过在每个坐标上执行函数来构造数组。
ma.MaskedArray.copy（[order]）	返回数组的副本。

Ones and zeros

ma.empty（shape [，dtype，order]）	返回给定形状和类型的新数组，而不初始化条目。
ma.empty_like（a [，dtype，order，subok]）	返回具有与给定数组相同的形状和类型的新数组。
ma.masked_all（shape [，dtype]）	与被掩没的所有元素的空的被掩没的数组。
ma.masked_all_like（arr）	使用现有数组的属性空掩码数组。
ma.ones（shape [，dtype，order]）	返回给定形状和类型的新数组，用数字填充。
ma.zeros（shape [，dtype，order]）	返回给定形状和类型的新数组，用零填充。

---

Inspecting the array

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）	返回掩码数组或掩码的掩码。
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.data	返回当前数据，作为原始基础数据的视图。
ma.MaskedArray.mask	面具
ma.MaskedArray.recordmask	返回记录的掩码。
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]）	返回给定轴上的元素数。

---

Manipulating a MaskedArray

Changing the shape

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，...]）

Modifying axes

ma.swapaxes（self，\ * args，...）	返回数组的视图，其中axis1和axis2互换。
ma.transpose（a [，axes]）	允许数组的尺寸。
ma.MaskedArray.swapaxes（axis1，axis2）	返回数组的视图，其中axis1和axis2互换。
ma.MaskedArray.transpose（\ * axes）	返回具有轴转置的数组的视图。

Changing the number of dimensions

ma.atleast_1d（\ * arys）	将输入转换为具有至少一个维度的数组。
ma.atleast_2d（\ * arys）	将输入视为具有至少两个维度的数组。
ma.atleast_3d（\ * arys）	将输入视为至少包含三个维度的数组。
ma.expand_dims（x，axis）	展开数组的形状。
ma.squeeze（a [，axis]）	从数组的形状中删除单维条目。
ma.MaskedArray.squeeze（[axis]）	从a形状删除单维条目。
ma.column_stack（tup）	将1-D数组作为列堆叠到2-D数组中。
ma.concatenate（arrays [，axis]）	沿给定轴连接数组的序列。
ma.dstack（tup）	按照深度顺序（沿第三轴）堆叠数组。
ma.hstack（tup）	水平（按列顺序）堆叠数组。
ma.hsplit（ary，indices_or_sections）	将数组水平（逐列）拆分为多个子数组。
ma.mr_	将切片对象转换为沿第一轴的连接。
ma.row_stack（tup）	垂直（按行）顺序堆叠数组。
ma.vstack（tup）	垂直（按行）顺序堆叠数组。

Joining arrays

ma.column_stack（tup）	将1-D数组作为列堆叠到2-D数组中。
ma.concatenate（arrays [，axis]）	沿给定轴连接数组的序列。
ma.append（a，b [，axis]）	将值附加到数组的末尾。
ma.dstack（tup）	按照深度顺序（沿第三轴）堆叠数组。
ma.hstack（tup）	水平（按列顺序）堆叠数组。
ma.vstack（tup）	垂直（按行）顺序堆叠数组。

---

Operations on masks

Creating a mask

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

Accessing a mask

ma.getmask（a）	返回掩码数组或掩码的掩码。
ma.getmaskarray（arr）	返回掩码数组的掩码，或者返回False的完全布尔数组。
ma.masked_array.mask	面具

Finding masked data

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数组的未屏蔽块相对应的切片的列表。

Modifying a mask

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()	强迫面具硬。
ma.MaskedArray.soften_mask()	强迫面罩柔软。
ma.MaskedArray.shrink_mask()	如果可能，减少掩码到nomask。
ma.MaskedArray.unshare_mask()	复制掩码并将sharedmask标志设置为False。

---

Conversion operations

> to a masked array

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，其中数据与值完全相等。
ma.masked_outside（x，v1，v2 [，copy]）	在给定间隔之外屏蔽数组。
ma.masked_values（x，value [，rtol，atol，...]）	使用浮点平等的掩码。
ma.masked_where（condition，a [，copy]）	屏蔽满足条件的数组。

> to a ndarray

ma.compress_cols（a）	抑制包含屏蔽值的2-D数组的整列。
ma.compress_rowcols（x [，axis]）	抑制包含屏蔽值的2-D数组的行和/或列。
ma.compress_rows（a）	抑制包含屏蔽值的2-D数组的所有行。
ma.compressed（x）	将所有非屏蔽数据作为1-D数组。
ma.filled（a [，fill_value]）	将输入作为数组，将掩码数据替换为填充值。
ma.MaskedArray.compressed()	将所有非屏蔽数据作为1-D数组。
ma.MaskedArray.filled（[fill_value]）	返回self的副本，掩码值填充给定值。

> to another object

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

Pickling and unpickling

ma.dump（a，F）	选择一个蒙版的数组到文件。
ma.dumps（a）	返回一个对应于掩蔽数组的pickling的字符串。
ma.load（F）	封装在cPickle.load周围，它接受类似文件的对象或文件名。
ma.loads（strg）	从当前字符串加载pickle。

Filling a masked array

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()	返回掩码数组的填充值。
ma.MaskedArray.set_fill_value（[value]）	设置掩码数组的填充值。
ma.MaskedArray.fill_value	灌装值。

---

Masked arrays arithmetics

Arithmetics

ma.anom（self [，axis，dtype]）	沿给定轴计算异常（与算术平均值的偏差）。
ma.anomalies（self [，axis，dtype]）	沿给定轴计算异常（与算术平均值的偏差）。
ma.average（a [，axis，weights，returned]）	返回给定轴上数组的加权平均值。
ma.conjugate（x [，out]）	按元素方式返回复共轭。
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，keepdims]）	返回给定轴上的数组元素的标准偏差。
ma.sum（self [，axis，dtype，out，keepdims]）	返回给定轴上的数组元素的总和。
ma.var（self [，axis，dtype，out，ddof，keepdims]）	计算沿指定轴的方差。
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，...]）	计算沿指定轴的方差。

Minimum/maximum

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]）	沿给定尺寸的返回（最大 - 最小）。
ma.MaskedArray.argmax（[axis，fill_value，out]）	返回沿给定轴的最大值的索引的数组。
ma.MaskedArray.argmin（[axis，fill_value，out]）	将指数的数组返回给定轴的最小值。
ma.MaskedArray.max（[axis，out，fill_value，...]）	沿给定轴返回最大值。
ma.MaskedArray.min（[axis，out，fill_value，...]）	沿给定轴返回最小值。
ma.MaskedArray.ptp（[axis，out，fill_value]）	沿给定尺寸的返回（最大 - 最小）。

Sorting

ma.argsort（a [，axis，kind，order，fill_value]）	返回沿指定轴对数组进行排序的索引数组。
ma.sort（a [，axis，kind，order，endwith，...]）	就地对数组进行排序
ma.MaskedArray.argsort（[axis，kind，order，...]）	返回沿指定轴对数组进行排序的索引数组。
ma.MaskedArray.sort（[axis，kind，order，...]）	就地对数组进行排序

Algebra

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）	返回具有轴转置的数组的视图。

Polynomial fit

ma.vander（x [，n]）	生成Vandermonde矩阵。
ma.polyfit（x，y，deg [，rcond，full，w，cov]）	最小二乘多项式拟合。

Clipping and rounding

ma.around	将数组舍入到给定的小数位数。
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（[decimal，out]）	返回四舍五入到给定小数位数的每个元素。

Miscellanea

ma.allequal（a，b [，fill_value]）	如果a和b的所有条目都相等，则返回True，使用fill_value作为其中一个或两者都被掩蔽的真值。
ma.allclose（a，b [，masked_equal，rtol，atol]）	如果两个数组在元素方面在公差内相等，则返回True。
ma.apply_along_axis（func1d，axis，arr，...）	沿着给定轴向1-D切片应用函数。
ma.arange（[start，] stop [，step，] [，dtype]）	在给定间隔内返回均匀间隔的值。
ma.choose（indices，choices [，out，mode]）	使用索引数组从一组选择中构造新的数组。
ma.ediff1d（arr [，to_end，to_begin]）	计算数组的连续元素之间的差异。
ma.indices（dimensions [，dtype]）	返回表示网格索引的数组。
ma.where（condition [，x，y]）	根据条件返回带有x或y元素的蒙版数组。