解析¶
- 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
此函数可能引发的异常。