This is the documentation for PyVO, an affiliated package for the astropy package.

PyVO lets you find and retrieve astronomical data available from archives that support standard IVOA virtual observatory service protocols.


If you need to access data which is not available via the Virtual Observatory standards, try the astropy affiliated package astroquery (and, of course, ask the data providers to do the right thing and use the proper standards for their publication).


pip install pyvo

Source Installation

git clone
cd pyvo
python install


  • astropy
  • requests

Getting started

Data Access

Most of the interesting functionality of pyVO is through the various data access service interfaces (SCS for catalogs, SIA for images, SSAP for spectra, TAP for tables). All of these behave in a similar way.

First, there is a class describing a specific type of service:

>>> import pyvo as vo
>>> service = vo.dal.TAPService("")

Once you have a service object, you can run queries with parameters specific to the service type. In this example, a database query is enough:

>>> resultset ="SELECT TOP 1 * FROM ivoa.obscore")
<Table masked=True length=1>
dataproduct_type dataproduct_subtype calib_level ... s_pixel_scale em_ucd
                                                 ...      arcs
     object             object          int16    ...    float64    object
---------------- ------------------- ----------- ... ------------- ------
           image                               1 ...            --

What is returned by the search method is a to get a resultset object, which esseintially works like a numpy record array. It can be processed either by columns:

>>> row = resultset[0]
>>> column = resultset["dataproduct_type"]

or by rows.

>>> for row in resultset:
>>>   calib_level = row["calib_level"]