解析

astropy.io.votable.parse(source, columns=None, invalid='exception', verify=None, chunk_size=256, table_number=None, table_id=None, filename=None, unit_format=None, datatype_mapping=None, _debug_python_based_parser=False)

解析A VOTABLE xml文件（或类似文件的对象），并返回 VOTableFile 对象。

参数

source类似路径或类似文件

路径或类似文件的对象，其中包含 VOTABLE XML文件。如果是文件，则必须是可读的。

columnsstr序列，可选

要包含在输出中的字段名列表。默认值是包括所有字段。

invalid可选的STR

以下值之一：

• “exception”：遇到无效值时引发异常（默认）

• “mask”：屏蔽无效值

verify{'ignore'，'warn'，'exception'}，可选

什么时候？ 'exception' ，则在文件违反规范时引发错误，否则将发出警告 ('warn' )或者默默地继续 ('ignore' ). 警告可以使用标准的Python机制进行控制。见 warnings 模块以获取更多信息。如果未提供，则使用配置设置 astropy.io.votable.verify ，默认为“忽略”。

在 4.0 版更改: verify 取代了 pedantic 参数，它将在将来被弃用。

在 5.0 版更改: 这个 pedantic 参数已弃用。

chunk_size可选的

在转换为数组之前要读取的行数。数字越大，速度越快，但会消耗更多内存。

table_number可选的

要读入的文件中的表数。如果 None 将读取所有表。如果是一个数字，0表示文件中的第一个表，只有那个编号的表才会被解析和读入。不应与一起使用 table_id .

table_id可选的STR

要读入的文件中表的ID。不应与一起使用 table_number .

filename可选的STR

在错误消息中使用的文件名、URL或其他标识符。如果 文件名 没有，而且 来源 是一个字符串（即路径），则 来源 将用作错误消息的文件名。因此， 文件名 仅当源是类似文件的对象时才需要。

unit_format结构，astropy.units.format.Base实例或无，可选

解析单位属性时要使用的单位格式。如果是字符串，则必须是单位格式化程序的名称。内置格式包括 generic ， fits ， cds ，以及 vounit 。自定义格式化程序可以通过将 UnitBase 实例。如果 None (默认)，要使用的单位格式将是由可投票规范指定的格式(即 cds 最高版本为VOVABLE 1.3，以及 vounit 在规范的较新版本中)。

datatype_mapping可选的

数据类型名称的映射 (str )转换为有效的可投票数据类型名称(字符串)。例如，如果正在读取的文件包含数据类型“unsignedInt”(votable中的无效数据类型)，请包括映射 {{"unsignedInt": "long"}} 。

返回

可听的 ： VOTableFile 对象VOTableFile对象

参见

astropy.io.votable.exceptions

此函数可能引发的异常。