表

class astropy.io.votable.tree.Table(votable, ID=None, name=None, ref=None, ucd=None, utype=None, nrows=None, id=None, config=None, pos=None, **extra)

基类：Element, _IDProperty, _NameProperty, _UcdProperty, _DescriptionProperty

TABLE 元素：可选地包含数据。

它包含以下可公开访问且可变的属性：

数组 ：数据本身的Numpy掩码数组，其中每一行都是votable数据的一行，列是根据表的<FIELD>元素命名和类型化的。掩码与数据数组平行，但可变长度字段除外。对于这些字段，numpy数组的列类型是“object” ("O" )，另一个掩码数组存储在那里。

如果表不包含数据，（例如，它的封闭 Resource 有 type =='meta'） 数组 长度将为零。

关键字参数对应于具有相同名称的设置成员，如下所述。

属性摘要

fields	列表 Field 对象描述每个数据列的类型。
format	[required] 表的序列化格式。
groups	列表 Group 描述列和参数如何分组的对象。
infos	列表 Info 表的对象。
links	列表 Link 表的对象（通过URI指向其他文档或服务器的指针）。
nrows	[immutable] 在XML文件中指定的表中的行数。
params	表的参数列表（常量值列）。
ref

方法总结

create_arrays([nrows, config])	创建一个新数组来保存基于当前字段集的数据，并将它们存储在 数组 和成员变量。
from_table(votable, table)	创建一个 Table 给定的实例 astropy.table.Table 实例。
get_field_by_id(ref[, before])	根据给定的ID查找FIELD或PARAM元素。
get_field_by_id_or_name(ref[, before])	根据给定的ID或名称查找FIELD或PARAM元素。
get_fields_by_utype(ref[, before])	按给定的utype查找FIELD或PARAM元素，并返回发出所有匹配项的迭代器。
get_group_by_id(ref[, before])	根据给定的ID查找组元素。
get_groups_by_utype(ref[, before])	按给定的utype查找GROUP元素并返回一个迭代器，该迭代器发出所有匹配项。
is_empty \()	如果此表不包含任何实际数据，因为解析器跳过了它（通过使用 table_number 夸克）。
iter_fields_and_params \()	递归迭代表中的所有FIELD和PARAM元素。
iter_groups \()	递归迭代表中的所有组元素。
iter_info \()
parse(iterator, config)	供内部使用。
to_table([use_names_over_ids])	将此VO表转换为 astropy.table.Table 实例。
to_xml(w, **kwargs)	供内部使用。

属性文档

fields

列表 Field 对象描述每个数据列的类型。

format

[required] 表的序列化格式。必须是：

'表格数据' (TABLEDATA) ，'二进制' (BINARY) ，'二进制2' (BINARY2) “适合” (FITS) .

注意，“fits”格式需要一个外部文件，因此不能写出。默认情况下，任何以“fits”格式读入的文件都将以“tabledata”格式读取。

看见 astropy:votable-serialization 。

groups

列表 Group 描述列和参数如何分组的对象。目前，此信息仅用于往返和信息用途。

infos

列表 Info 表的对象。允许操作后诊断。

links

列表 Link 表的对象（通过URI指向其他文档或服务器的指针）。

nrows

[immutable] 在XML文件中指定的表中的行数。

params

表的参数列表（常量值列）。必须仅包含 Param 物体。

ref

方法文件

create_arrays(nrows=0, config=None)

创建一个新数组来保存基于当前字段集的数据，并将它们存储在 数组 和成员变量。现有数组中的任何数据都将丢失。

诺尔斯 ，如果提供，则是要分配的行数。

classmethod from_table(votable, table)

创建一个 Table 给定的实例 astropy.table.Table 实例。

get_field_by_id(ref, before=None)

根据给定的ID查找FIELD或PARAM元素。

get_field_by_id_or_name(ref, before=None)

根据给定的ID或名称查找FIELD或PARAM元素。

get_fields_by_utype(ref, before=None)

按给定的utype查找FIELD或PARAM元素，并返回发出所有匹配项的迭代器。

get_group_by_id(ref, before=None)

根据给定的ID查找GROUP元素。由组的“ref”属性使用

get_groups_by_utype(ref, before=None)

按给定的utype查找GROUP元素并返回一个迭代器，该迭代器发出所有匹配项。

is_empty()

如果此表不包含任何实际数据，因为解析器跳过了它（通过使用 table_number 夸克）。

iter_fields_and_params()

递归迭代表中的所有FIELD和PARAM元素。

iter_groups()

递归迭代表中的所有组元素。

iter_info()

parse(iterator, config)

内部使用。解析元素子元素的XML内容。

参数

iteratorXML可迭代

返回的XML元素的迭代器 get_xml_iterator .

config双关语

影响某些元素的读取方式的配置字典。

返回

self ： Element元素

返回self作为方便。

to_table(use_names_over_ids=False)

将此VO表转换为 astropy.table.Table 实例。

参数

use_names_over_ids可选的布尔

什么时候？ True 使用 name 属性作为 astropy.table.Table 实例。由于名称不能保证是唯一的，这可能会导致某些列通过在末尾附加数字来重命名。否则（默认），使用ID属性作为列名。

.. 警告：

当通过 astropy.table.Table 实例。

to_xml(w, **kwargs)

内部使用。将元素输出到XML。

参数

wastropy.utils.xml.写入程序.XMLWriter对象

要写入的XML编写器。

**kwargs双关语

控制输出的任何配置参数。