遮罩陣列運算

常數

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	傳回與給定陣列具有相同形狀和類型的全 0 陣列。

---

檢查陣列

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 的一維版本。
ma.reshape(a, new_shape[, order])	傳回包含相同資料但具有新形狀的陣列。
ma.resize(x, new_shape)	傳回具有指定大小和形狀的新遮罩陣列。
ma.MaskedArray.flatten([order])	傳回摺疊成一維的陣列副本。
ma.MaskedArray.ravel([order])	以視圖形式傳回 self 的一維版本。
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 移除長度為一的軸。
ma.MaskedArray.squeeze([axis])	從 a 移除長度為一的軸。
ma.stack	沿著新軸加入陣列序列。
ma.column_stack	將一維陣列堆疊為二維陣列的欄。
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	將一維陣列堆疊為二維陣列的欄。
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)	傳回對應於一維陣列的遮罩叢集的切片清單。
ma.clump_unmasked(a)	傳回對應於一維陣列的非遮罩叢集的切片清單。

修改遮罩

ma.mask_cols(a[, axis])	遮罩包含遮罩值的二維陣列的欄。
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。
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])	將輸入以 ndarray 形式傳回，並以 fill_value 取代遮罩值。
ma.MaskedArray.compressed()	以一維陣列形式傳回所有非遮罩資料。
ma.MaskedArray.filled([fill_value])	傳回 self 的副本，其中遮罩值以給定值填充。

> 轉換為另一個物件

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 的填充值，如果 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, ...])	傳回皮爾森積差相關係數。
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, ...])	傳回遮罩陣列的排序副本。
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 的副本，四捨五入到 'decimals' 位數。
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])	兩個 1 維序列的交叉相關。
ma.ediff1d(arr[, to_end, to_begin])	計算陣列中連續元素之間的差異。
ma.flatten_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 的副本，四捨五入到 'decimals' 位數。
ma.take(a, indices[, axis, out, mode])
ma.where(condition[, x, y])	根據條件，傳回一個包含來自 x 或 y 元素的遮罩陣列。