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=False, copy_indices=True)[源代码]¶
基类:
Column
,_MaskedColumnGetitemShim
,MaskedArray
定义在表对象中使用的屏蔽数据列。
- 参数
- data列表、ndarray或无
列数据值
- nameSTR
表中引用的列名和键
- mask列表、ndarray或None
布尔掩码,True表示缺少或无效的数据
- fill_value浮点型、整型、字符串或无
填充屏蔽列元素时使用的值
- 数据类型 :
dtype
-喜欢类似数据类型 列的数据类型
- shape元组或()
列数据中单个行元素的维度
- lengthint或0
列数据中的行元素数
- descriptionSTR或无
列的完整描述
- unitSTR或无
物理单位
- format字符串、无或可调用
用于输出列值的格式字符串。这可能是一种“旧风格” (
format % value
)或者“新风格” (str.format
)格式规范字符串或接受单个值并返回字符串的函数或任何可调用对象。- meta喜欢还是不喜欢
与列关联的元数据
实例
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
属性摘要
此列保存的纯MaskedArray数据。
掩码数组的填充值是标量。
用于存储诸如名称、描述、格式等元信息的容器。
此列的名称。
方法总结
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
实例str或 要转换为的单位。
- equivalencies元组列表
如果单位不能直接转换,可尝试的等价对列表。看见 astropy:unit_equivalencies 。
- new_unit STR或
- 加薪
- 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可选数组
如果提供,则使用
data
而不是实例数据。这允许复制实例属性和meta。- copy_data可选的布尔
复制内部numpy数组,而不是使用引用。默认值为True。
- 返回
- col列或掩码列
当前列的副本(与原始列的类型相同)
- filled(fill_value=None)[源代码]¶
返回self的副本,并用给定值填充屏蔽值。
- 参数
- 返回
- filled_column柱
一份
self
被替换为fill_value
(是函数参数还是self
)
- insert(obj, values, mask=None, axis=0)[源代码]¶
在给定索引之前沿给定轴插入值,并返回一个新的
MaskedColumn
对象。- 参数
- obj整型、整型切片或整型序列
定义一个或多个索引的对象,
values
插入。- values类似阵列的
要插入的值。如果
values
和柱子上的不同,values
转换为匹配类型。values
它的形状应该使它能被适当地播放。- mask布尔或类似数组
要插入的掩码值。如果未提供,并且值也没有掩码,则使用False。
- axis可选的
插入轴
values
. 如果axis
如果为“无”,则列数组在插入之前被展平。默认值为0,这将插入一行。
- 返回
- out :
MaskedColumn
MaskedColumn
列的副本
values
和mask
插入。请注意,插入操作没有发生在适当的位置:返回一个新的屏蔽列。
- out :
- 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利息
表输出中的最大行数。
- show_name布尔
包括列名的标题行。默认值为True。
- show_unit布尔
包括单位的标题行。默认值为False。
- pformat(max_lines=None, show_name=True, show_unit=False, show_dtype=False, html=False)¶
返回列值的格式化字符串表示形式的列表。
如果没有值
max_lines
然后使用屏幕终端的高度来设置max_lines
. 如果无法确定端子高度,则将使用astropy.conf.max_lines
配置项。如果负值为max_lines
则没有应用行限制。- 参数
- max_lines利息
最大输出行数(标题+数据行)
- show_name布尔
包括列名。默认值为True。
- show_unit布尔
包括单位的标题行。默认值为False。
- show_dtype布尔
包括列数据类型。默认值为False。
- html布尔
将输出格式化为HTML表。默认值为False。
- 返回
- lines列表
具有标题和格式化列值的行的列表
- pprint(max_lines=None, show_name=True, show_unit=False, show_dtype=False)¶
打印列值的格式化字符串表示形式。
如果没有值
max_lines
然后使用屏幕终端的高度来设置max_lines
. 如果无法确定端子高度,则将使用astropy.conf.max_lines
配置项。如果负值为max_lines
则没有应用行限制。- 参数
- max_lines利息
输出中的最大值数
- show_name布尔
包括列名。默认值为True。
- show_unit布尔
包括单位的标题行。默认值为False。
- show_dtype布尔
包括列数据类型。默认值为True。