SCSResults¶

class pyvo.dal.SCSResults(votable, url=None, session=None)[source]¶

Bases: pyvo.dal.DALResults, pyvo.dal.adhoc.DatalinkResultsMixin

The list of matching catalog records resulting from a catalog (SCS) query. Each record contains a set of metadata that describes a source or observation within the requested circular region (i.e. a “cone”). The number of records in the results is available via the nrecs attribute or by passing it to the Python built-in ``len()` function.

This class supports iterable semantics; thus, individual records (in the form of SCSRecord instances) are typically accessed by iterating over an SCSResults instance.

>>> results = pyvo.conesearch(url, pos=[12.24, -13.1], radius=0.1)
>>> for src in results:
...     print("{0}: {1} {2}".format(src.id, src.ra, src.dec))

Alternatively, records can be accessed randomly via getrecord() or through a Python Database API (v2) Cursor (via cursor()). Column-based data access is possible via the getcolumn() method.

SCSResults is essentially a wrapper around an Astropy votable Table instance where the columns contain the various metadata describing the images. One can access that VOTable directly via the votable attribute. Thus, when one retrieves a whole column via getcolumn(), the result is a Numpy array. Alternatively, one can manipulate the results as an Astropy Table via the following conversion:

>>> table = results.votable.to_table()

SCSResults supports the array item operator [...] in a read-only context. When the argument is numerical, the result is an SCSRecord instance, representing the record at the position given by the numerical index. If the argument is a string, it is interpreted as the name of a column, and the data from the column matching that name is returned as a Numpy array.

initialize the cursor. This constructor is not typically called by directly applications; rather an instance is obtained from calling a DALQuery’s execute().

Parameters

votablestr: the service response parsed into an astropy.io.votable.tree.VOTableFile instance.
urlstr: the URL that produced the response
sessionobject: optional session to use for network requests

Raises

DALFormatError: if the response VOTable does not contain a response table

Navigation

SCSResults¶