TableElement#

class astropy.io.votable.tree.TableElement(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" )，另一个掩码数组存储在那里。

如果TableElement不包含任何数据(例如，它的封闭 Resource 有 type ==‘meta’) array 将具有零长度。

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

属性摘要

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

方法总结

`create_arrays`([nrows, config])	创建一个新数组来保存基于当前字段集的数据，并将它们存储在数组和成员变量。
`from_table`(votable, table)	创建 `TableElement` 实例从给定的 `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”格式读取。

看见数据序列化格式。

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

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

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

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

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

ref#

方法文件

create_arrays(nrows=0, config=None)[源代码]#

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

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

classmethod from_table(votable, table)[源代码]#: 创建 TableElement 实例从给定的 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内容。

参数:

iterator : xml iterableXMLpython：可迭代的: 返回的XML元素的迭代器 get_xml_iterator .
config : dictPython ：词典: 影响某些元素的读取方式的配置字典。

返回:

self ： Element元素: 返回self作为方便。

to_table(use_names_over_ids=False)[源代码]#

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

参数:

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

to_xml(w, **kwargs)[源代码]#

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

参数:

w : astropy.utils.xml.writer.XMLWriter objectastropy.utils.xml.写入程序.XMLWriter对象: 要写入的XML编写器。
**kwargs : dictPython ：词典: 控制输出的任何配置参数。