参考/API

astropy.io.votable公司包裹

这个包读取和写入虚拟天文台（VO）计划使用的数据格式，特别是VOTable XML格式。

功能

from_table(table[, table_id])	给定一个 Table 对象，返回 VOTableFile 只包含那个表的文件结构。
is_votable \(来源)	读取文件的头以确定它是否是VOTable文件。
parse(source[, columns, invalid, verify, ...])	解析A VOTABLE xml文件（或类似文件的对象），并返回 VOTableFile 对象。
parse_single_table(source, **kwargs)	解析一个 VOTABLE XML文件(或类似文件的对象)，只读取和返回第一个 TableElement 举个例子。
validate(source[, output, xmllint, filename])	打印给定文件的验证报告。
writeto(table, file[, tabledata_format])	写入 VOTableFile 到A VOTABLE xml文件。

Classes

Conf \()

的配置参数 astropy.io.votable .

astropy.io.votable公司.tree模块

Classes

CooSys([ID, equinox, epoch, system, id, ...])	COOSYS 元素：定义坐标系。
Element \()	表示可投票文件中的XML元素的所有类的基类。
Field(votable[, ID, name, datatype, ...])	FIELD 元素：描述特定数据列的数据类型。
FieldRef(table, ref[, ucd, utype, config, pos])	FIELDref 元素：用于 GROUP 要引用远程的元素 FIELD 元素。
Group(table[, ID, name, ref, ucd, utype, ...])	GROUP 元素：组 FIELD 和 PARAM 元素。
Info([ID, name, value, id, xtype, ref, ...])	INFO 元素：标准扩展的任意键值对。
Link([ID, title, value, href, action, id, ...])	LINK 元素：用于通过URI引用外部文档和服务器。
MivotBlock([content])	MIVOT块持有者：处理数据上的VO模型视图不在Astropy的范围内。
Param(votable[, ID, name, value, datatype, ...])	PARAM 元素：数据中的常量值列。
ParamRef(table, ref[, ucd, utype, config, pos])	PARAMref 元素：用于 GROUP 要引用远程的元素 PARAM 元素。
Resource([name, ID, utype, type, id, ...])	RESOURCE 图元组：图元 TABLE 和 RESOURCE 元素。
TableElement(votable[, ID, name, ref, ucd, ...])	TABLE 元素：可选地包含数据。
TimeSys([ID, timeorigin, timescale, ...])	TIMESYS 元素：定义时间系统。
VOTableFile([ID, id, config, pos, version])	VOTABLE 元素：表示整个文件。
Values(votable, field[, ID, null, ref, ...])	VALUES 元素：用于 FIELD 和 PARAM 元素来定义值的域。

astropy.io.votable公司.转换器模块

此模块处理各种VOTABLE数据类型到/来自的转换 TABLEDATA 和 BINARY 格式。

功能

get_converter(field[, config, pos])	为给定字段获取适当的转换器实例。
table_column_to_votable_datatype \(列)	给出了一个 astropy.table.Column 实例，返回创建与列类型对应的VOTable字段元素所需的属性。

Classes

Converter(field[, config, pos])

所有转换器的基类。

astropy.io.votable公司.ucd模块

此文件包含验证UCD字符串正确性的例程。

功能

check_ucd(ucd[, ...])	返回False if ucd 不是有效的 unified content descriptor .
parse_ucd(ucd[, ...])	将UCD解析为其组件。

astropy.io.votable公司.util模块

各种各样的公用事业和食谱之类的东西。

功能

coerce_range_list_param(p[, frames, numeric])	强制和/或验证对象 p 转换为有效的范围列表格式参数。
convert_to_writable_filelike(fd[, compressed])	返回适合流式输出的可写的类似文件的对象。

astropy.io.votable公司.validator包

验证可通过web访问的VOTable文件的大量集合，并将报告生成为HTML文件的目录树。

功能

make_validation_report([urls, destdir, ...])

验证可通过web访问的大量VOTable文件集合。

astropy.io.votable公司.xmlutil模块

各种与XML相关的实用程序。

功能

check_anyuri(uri[, config, pos])	提出一个 VOTableSpecError 如果 uri 不是有效的URI。
check_id(ID[, name, config, pos])	提出一个 VOTableSpecError 如果 ID 不是有效的XML ID.
check_mime_content_type(content_type[, ...])	提出一个 VOTableSpecError 如果 content_type 不是有效的MIME内容类型。
check_token(token, attr_name[, config, pos])	提出一个 ValueError 如果 令牌 不是有效的XML标记。
fix_id(ID[, config, pos])	给定一个任意字符串，创建一个可用作xml id的字符串。
validate_schema(filename[, version])	根据适当的VOTable架构验证给定的文件。

astropy.io.votable.dataorigin模块

提取VOTable中的数据源

引用

DataOrigin是IVOA注释中描述的词汇：https://www.ivoa.net/documents/DataOrigin/

笔记

该API从VOTable中的Info中检索元数据。这些信息可以在VOTable中的不同级别找到：

• 全球一级

• 资源水平

• 表级别

目录

• 查询信息：每个元素在VOTable中都被认为是唯一的。信息涉及出版商、执行日期、联系方式、请求等

• 数据集来源：基本来源信息。

实例

>>> from astropy.io.votable import parse
>>> from astropy.io.votable.dataorigin import extract_data_origin
>>> data_origin = extract_data_origin(parse("https://vizier.cds.unistra.fr/viz-bin/conesearch/II/246/out?RA=0&DEC=0&SR=0.1"))
>>> print(data_origin)
publisher: CDS
server_software: 7.4.5
service_protocol: ivo://ivoa.net/std/ConeSearch/v1.03
request: https://vizier.cds.unistra.fr/viz-bin/conesearch/II/246/out?RA=0&DEC=0&SR=0.1
request_date: 2025-03-03T12:54:26
contact: cds-question@unistra.fr
...
>>> uri_request = data_origin.query.request
>>> creators =  data_origin.origin[0].creator

功能

add_data_origin_info(vot_element, info_name, ...)	使用兼容的信息更新VOTable元素
extract_data_origin(vot_element)	在VO元素中提取DataOrigin

Classes

DataOrigin ()	存储有关查询执行的信息的数据类
DatasetOrigin([votable_element])	存储数据集基本出处的数据类。
QueryOrigin ()	存储生成VOTable的查询执行信息的数据类。