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)[源代码]

基类:astropy.io.votable.tree.Element, astropy.io.votable.tree._IDProperty, astropy.io.votable.tree._NameProperty, astropy.io.votable.tree._UcdProperty, astropy.io.votable.tree._DescriptionProperty

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

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

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

如果表不包含数据,(例如,它的封闭 Resourcetype =='meta') 数组 长度将为零。

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

属性摘要

fields 

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

format 

[required] 表的序列化格式。

groups 

列表 Group 描述列和参数如何分组的对象。

infos 

列表 Info 表的对象。

links 

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

nrows 

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

params 

表的参数列表(常量值列)。

ref 

方法总结

create_arrays \([nrows, config] )

创建一个新数组来保存基于当前字段集的数据,并将它们存储在 数组 和成员变量。

from_table \(投票表,表)

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

get_field_by_id \(参考 [, before] )

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

get_field_by_id_or_name \(参考 [, before] )

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

get_fields_by_utype \(参考 [, before] )

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

get_group_by_id \(参考 [, before] )

根据给定的ID查找组元素。

get_groups_by_utype \(参考 [, before] )

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

is_empty \()

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

iter_fields_and_params \()

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

iter_groups \()

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

iter_info \()

parse \(迭代器,配置)

供内部使用。

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 表的对象。允许操作后诊断。

列表 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双关语

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

返回
selfElement元素

返回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双关语

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