MaskedColumn#

class astropy.table.MaskedColumn(data=None, name=None, mask=None, fill_value=None, dtype=None, shape=(), length=0, description=None, unit=None, format=None, meta=None, copy=None, copy_indices=True)[源代码]#

基类：Column, _MaskedColumnGetitemShim, MaskedArray

定义在表对象中使用的屏蔽数据列。

参数:

data : list ， ndarray ，或 NonePYTHON：LIST、ndarray或PYTHON：无: 列数据值
name : strPython ：字符串: 表中引用的列名和键
mask : list ， ndarray 或 NonePYTHON：LIST、ndarray或PYTHON：无: 布尔掩码，True表示缺少或无效的数据
fill_value : float ， int ， str ，或 NonePYTHON：FLOAT、PYTHON：INT、PYTHON：STR或PYTHON：NONE: 填充屏蔽列元素时使用的值
dtype : dtypeastropy:-like占星术：-就像: 列的数据类型
shape : tuple 或()Python：元组或(): 列数据中单个行元素的维度
length : int 或0PYTHON：INT或0: 列数据中的行元素数
description : str 或 NonePYTHON：字符串或PYTHON：无: 列的完整描述
unit : str 或 NonePYTHON：字符串或PYTHON：无: 物理单位
format : str ， None ，或 callable()PYTHON：STR、PYTHON：NONE或PYTHON：Callable(): 用于输出列值的格式字符串。这可能是一种“旧风格” (format % value )或者“新风格” (str.format )格式规范字符串或接受单个值并返回字符串的函数或任何可调用对象。
meta : dict-like or None类似词典的或: 与列关联的元数据

实例

MaskedColumn与列类似，只是它包括 mask 和 fill_value 属性。它可以用两种不同的方式创建：

提供一个 data 有价值但没有 shape 或 length （根据数据推断）。

实例：
```
col = MaskedColumn(data=[1, 2], name='name')
col = MaskedColumn(data=[1, 2], name='name', mask=[True, False])
col = MaskedColumn(data=[1, 2], name='name', dtype=float, fill_value=99)
```
这个 mask 参数将转换为布尔数组，并指定哪些元素被认为丢失或无效。

这个 dtype 参数可以是可接受的固定大小数据类型初始值设定项的任何值数字.dtype（）方法。看到了吗 https://numpy.org/doc/stable/reference/arrays.dtypes.html . 示例包括：
- Python非字符串类型（float、int、bool）
- Numpy非字符串类型（例如。np.浮动32, np.int64, np.bool_)
- 数字.dtype数组协议类型字符串（例如“i4”、“f8”、“S15”）
如果没有 dtype 值，然后使用 np.array(data) .什么时候？ data 则 shape 和 length 参数被忽略。
提供 length 任选地 shape ，但不是 data

实例：
```
col = MaskedColumn(name='name', length=5)
col = MaskedColumn(name='name', dtype=int, length=10, shape=(3,4))
```
默认值 dtype 是 np.float64 . 这个 shape 参数是列中单个单元格的数组形状。

要访问 Column 将数据作为原始数据 numpy.ma.MaskedArray 对象，则可以使用 data 或 value 属性(等同)：

col.data
col.value

属性摘要

`data`	此列保存的纯MaskedArray数据。
`fill_value`	掩码数组的填充值是标量。
`info`	用于存储诸如名称、描述、格式等元信息的容器。
`name`	此列的名称。

方法总结

`convert_unit_to`(new_unit[, equivalencies])	将列的值从当前单位转换为给定单位。
`copy`([order, data, copy_data])	返回当前实例的副本。
`filled`([fill_value])	返回self的副本，并用给定值填充屏蔽值。
`insert`(obj, values[, mask, axis])	在给定索引之前沿给定轴插入值，并返回一个新的 `MaskedColumn` 对象。
`more`([max_lines, show_name, show_unit])	使用分页界面交互浏览列。
`pformat`([max_lines, show_name, show_unit, ...])	返回列值的格式化字符串表示形式的列表。
`pprint`([max_lines, show_name, show_unit, ...])	打印列值的格式化字符串表示形式。

属性文档

data#: 此列保存的纯MaskedArray数据。

fill_value#

info#

用于存储诸如名称、描述、格式等元信息的容器。

当对象用作表中的mixin列时，这是必需的，但也可以作为存储元信息的通用方法。在本例中，它只添加 mask_val 属性。

name#: 此列的名称。

方法文件

convert_unit_to(new_unit, equivalencies=[])[源代码]#

将列的值从当前单位转换为给定单位。

要更改与此列关联的单位而不实际更改数据值，只需设置 unit 财产。

参数:

new_unit : str 或 astropy.units.UnitBase 实例PYTHON：STR或AXTYPY.units.UnitBase实例: 要转换为的单位。
equivalencies : list 的 tuplePYTHON：PYTHON列表：元组: 如果单位不能直接转换，可尝试的等价对列表。看见等价物。

加薪:

astropy.units.UnitsError: 如果单位不一致

copy(order='C', data=None, copy_data=True)#

返回当前实例的副本。

如果 data 然后提供的视图（参考） data 使用，并且 copy_data 被忽略。

参数:

order'C'、'F'、'A'、'K'，可选: 控制副本的内存布局。'“c”表示“c”顺序，“f”表示“f”顺序，“a”表示“f”如果 a Fortran是连续的，否则为“c”。k'表示与 a 尽可能接近。（请注意，此功能和：numpy.copy是非常相似，但是它们的order=参数有不同的默认值。）默认值是'C'。
data : array ，可选可选数组: 如果提供，则使用 data 而不是实例数据。这允许复制实例属性和meta。
copy_data : bool ，可选可选的布尔: 复制内部numpy数组，而不是使用引用。默认值为True。

返回:

col : Column 或 MaskedColumn列或掩码列: 当前列的副本（与原始列的类型相同）

filled(fill_value=None)[源代码]#

返回self的副本，并用给定值填充屏蔽值。

参数:

fill_value标量；可选: 用于无效项的值 (None 默认情况下）。如果 None , the fill_value 而是使用数组的属性。

返回:

filled_column : Column柱: 一份 self 被替换为 fill_value （是函数参数还是 self ）

insert(obj, values, mask=None, axis=0)[源代码]#

在给定索引之前沿给定轴插入值，并返回一个新的 MaskedColumn 对象。

参数:

obj : int ， slice 或 sequence 的 intPYTHON：INT、SLICE或PYTHON：PYSTORY OF PYSTORY：INT: 定义一个或多个索引的对象， values 插入。
values : array_likeNumpy：ARRAY_LIKE: 要插入的值。如果 values 和柱子上的不同， values 转换为匹配类型。 values 它的形状应该使它能被适当地播放。
mask : bool 或 array_likeBool或umPy：ARRAY_LIKE: 要插入的掩码值。如果未提供，并且值也没有掩码，则使用False。
axis : int ，可选PYTHON：int，可选: 插入轴 values . 如果 axis 如果为“无”，则列数组在插入之前被展平。默认值为0，这将插入一行。

返回:

out ： MaskedColumnMaskedColumn: 列的副本 values 和 mask 插入。请注意，插入操作没有发生在适当的位置：返回一个新的屏蔽列。

more(max_lines=None, show_name=True, show_unit=False)#

使用分页界面交互浏览列。

支持的密钥：

f, <space> : forward one page
b : back one page
r : refresh same page
n : next row
p : previous row
< : go to beginning
> : go to end
q : quit browsing
h : print this help

参数:

max_lines : intPython ：整型: 表输出中的最大行数。
show_name : bool布尔: 包括列名的标题行。默认值为True。
show_unit : bool布尔: 包括单位的标题行。默认值为False。

pformat(max_lines=-1, show_name=True, show_unit=False, show_dtype=False, html=False)#

返回列值的格式化字符串表示形式的列表。

如果 max_lines=None 则使用屏幕终端的高度来设置 max_lines . 如果无法确定终端高度，则默认情况将使用 astropy.conf.max_lines 配置项。如果为负值， max_lines 则不应用行限制（默认）。

参数:

max_lines : int 或 NonePYTHON：INT或PYTHON：NONE: 输出的最大行数（标题+数据行）。-1（默认）意味着没有限制， None 暗示使用当前终端的高度。
show_name : bool布尔: 包括列名。默认值为True。
show_unit : bool布尔: 包括单位的标题行。默认值为False。
show_dtype : bool布尔: 包括列数据类型。默认值为False。
html : bool布尔: 将输出格式化为HTML表。默认值为False。

返回:

lines : listPython ：列表: 具有标题和格式化列值的行的列表

pprint(max_lines=None, show_name=True, show_unit=False, show_dtype=False)#

打印列值的格式化字符串表示形式。

如果 max_lines=None （默认）然后使用屏幕终端的高度来设置 max_lines . 如果无法确定终端高度，则默认情况将使用 astropy.conf.max_lines 配置项。如果为负值， max_lines 则没有应用行限制。

参数:

max_lines : intPython ：整型: 输出中的最大值数
show_name : bool布尔: 包括列名。默认值为True。
show_unit : bool布尔: 包括单位的标题行。默认值为False。
show_dtype : bool布尔: 包括列数据类型。默认值为True。