numpy.ma.MaskedArray.tolist()函数– Python

1. 简介

numpy.ma.MaskedArray.tolist()函数是 MaskedArray 类的一个方法，它返回一个 Python 列表，其中包含所有有效（即未被掩码屏蔽）的数组元素。如果数组本身没有掩码，则返回的列表与 tolist() 函数相同。如果数组具有掩码，则返回的列表中将不包括被掩码屏蔽的元素。

2. 语法

函数的语法格式如下：

numpy.ma.MaskedArray.tolist(filling_value=None)

3. 参数

函数有一个名为 filling_value 的可选参数。如果指定了 filling_value 参数，则列表中所有掩码元素都将被替换为 filling_value 参数指定的值。如果未指定 filling_value 参数，则掩码元素将被保留在列表中，但其值将为 numpy.ma.masked

4. 用法示例

示例 1：

import numpy as np

a = np.ma.array([1, 2, 3], mask=[True, False, False])
print(a.tolist())

输出结果：

[np.ma.masked, 2, 3]

示例 2：

import numpy as np

a = np.ma.array([1, 2, 3], mask=[True, False, False])
print(a.tolist(filling_value=-999))

输出结果：

[-999, 2, 3]

示例 3：

import numpy as np

a = np.array([1, 2, 3])
print(a.tolist())

输出结果：

[1, 2, 3]

5. 总结

numpy.ma.MaskedArray.tolist() 函数返回 MaskedArray 数组的有效元素列表。如果数组具有掩码，则掩码元素将被排除在列表之外。可选的 filling_value 参数将允许指定要替换掩码元素的值。如果数组未被掩码覆盖，则该函数与 tolist() 函数相同。