Masked array operations

原文:https://docs.scipy.org/doc/numpy/reference/routines.ma.html

译者:飞龙 UsyiyiCN

校对:(虚位以待)

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,...) 返回数组的视图,其中axis1axis2互换。
ma.transpose(a [,axes]) 允许数组的尺寸。
ma.MaskedArray.swapaxes(axis1,axis2) 返回数组的视图,其中axis1axis2互换。
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元素的蒙版数组。