The pyvo Package¶
PyVO is a package providing access to remote data and services of the Virtual observatory (VO) using Python.
The pyvo module currently provides these main capabilities:
- find archives that provide particular data of a particular type and/or relates to a particular topic
- search an archive for datasets of a particular type
- do simple searches on catalogs or databases
- get information about an object via its name
Submodules provide additional functions and classes for greater control over access to these services.
This module also exposes the exception classes raised by the above functions, of which DALAccessError is the root parent exception.
API Summary¶
Functions¶
conesearch() |
equivalent to pyvo.dal.scs.search() |
imagesearch() |
equivalent to pyvo.dal.sia.search() |
spectrumsearch() |
equivalent to pyvo.dal.ssa.search() |
linesearch() |
equivalent to pyvo.dal.sla.search() |
tablesearch() |
equivalent to pyvo.dal.tap.search() |
object2pos() |
equivalent to pyvo.nameresolver.sesame.object2pos() |
object2sexapos() |
equivalent to pyvo.nameresolver.sesame.object2sexapos() |
regsearch() |
equivalent to pyvo.registry.vao.search() |
resolve() |
equivalent to pyvo.nameresolver.sesame.resolve() |
Exceptions¶
DALAccessError |
a base class for all failures while accessing a DAL service |
DALProtocolError |
a base exception indicating that a DAL service responded in an erroneous way. |
DALFormatError |
an exception indicating that a DAL response contains fatal format errors. |
DALServiceError |
an exception indicating a failure communicating with a DAL service. |
DALQueryError |
an exception indicating an error by a working DAL service while processing a query. |
API Details¶
Functions¶
-
pyvo.
regsearch
([keywords=None, servicetype=None, waveband=None])¶ equivalent to
pyvo.registry.regtap.search()
-
pyvo.
conesearch
(url[, radius=1.0, verbosity=2])¶ equivalent to
pyvo.dal.scs.search()
-
pyvo.
imagesearch
(url, pos, size[, format='all', intersect='overlaps', verbosity=2])¶ equivalent to
pyvo.dal.sia.search()
-
pyvo.
spectrumsearch
(url, pos, size[, format='all'])¶ equivalent to
pyvo.dal.ssa.search()
-
pyvo.
linesearch
(url, wavelength)¶ equivalent to
pyvo.dal.sla.search()
-
pyvo.
tablesearch
(url, query[, language="ADQL", maxrec=None, uploads=None])¶ equivalent to
pyvo.dal.tap.search()
-
pyvo.
resolve
(names[, db, include, mirror])[source]¶ resolve one or more object names to an ObjectData instance contain metadata about the object; equivalent to
pyvo.nameresolver.sesame.resolve()
-
pyvo.
object2pos
(names[, db, mirror])[source]¶ resolve one or more object names each to a position; equivalent to
pyvo.nameresolver.sesame.object2pos()
-
pyvo.
object2sexapos
(names[, db, mirror])[source]¶ resolve one or more object names each to a sexagesimal-formatted position; equivalent to
pyvo.nameresolver.sesame.object2pos()