解析#
- 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 : path-like object 或 file-like objectPYTHON：类路径对象或PYTHON：类文件对象
路径或类似文件的对象，其中包含 VOTABLE XML文件。如果是文件，则必须是可读的。
- columns : sequence 的
str，可选PYTHON：PYTHON的序列：字符串，可选 要包含在输出中的字段名列表。默认值是包括所有字段。
- invalid :
str，可选Python：字符串，可选 以下值之一：
“exception”：遇到无效值时引发异常（默认）
“mask”：屏蔽无效值
- verify{'ignore'，'warn'，'exception'}，可选
什么时候？
'exception'，则在文件违反规范时引发错误，否则将发出警告 ('warn')或者默默地继续 ('ignore'). 警告可以使用标准的Python机制进行控制。见warnings模块以获取更多信息。如果未提供，则使用配置设置astropy.io.votable.verify，默认为“忽略”。在 4.0 版本发生变更:
verify取代了pedantic参数，它将在将来被弃用。在 5.0 版本发生变更: 这个
pedantic参数已弃用。在 6.0 版本发生变更: 这个
pedantic参数已删除。- chunk_size :
int，可选PYTHON：int，可选 在转换为数组之前要读取的行数。数字越大，速度越快，但会消耗更多内存。
- table_number :
int，可选PYTHON：int，可选 要读入的文件中的表数。如果
None将读取所有表。如果是一个数字，0表示文件中的第一个表，只有那个编号的表才会被解析和读入。不应与一起使用table_id.- table_id :
str，可选Python：字符串，可选 要读入的文件中表的ID。不应与一起使用
table_number.- filename :
str，可选Python：字符串，可选 在错误消息中使用的文件名、URL或其他标识符。如果 文件名 没有，而且 来源 是一个字符串（即路径），则 来源 将用作错误消息的文件名。因此， 文件名 仅当源是类似文件的对象时才需要。
- unit_format :
str,astropy.units.format.Base亚类或None，可选pPython：url，astropy.units. form.Base subtitle或pPython：无，可选 分析单位属性时使用的单位格式。 如果是字符串，则必须是单元格式化程序的名称。内置格式包括
generic,fits,cds，而且vounit. 可以通过传递Base亚类。 如果None（默认），则要使用的单位格式将是VOTable规范指定的单位格式（即cdsVOTable最高1.3版本，以及vounit在规范的最新版本中）。- datatype_mapping :
dict，可选Python：Dict，可选 数据类型名称的映射 (
str)转换为有效的可投票数据类型名称(字符串)。例如，如果正在读取的文件包含数据类型“unsignedInt”(votable中的无效数据类型)，请包括映射{{"unsignedInt": "long"}}。
- 返回:
- votable :
VOTableFileobjectVOTableFile对象
- votable :
参见
astropy.io.votable.exceptions此函数可能引发的异常。