TAPResults¶
- class pyvo.dal.TAPResults(votable, *, url=None, session=None)[source]¶
Bases:
DatalinkResultsMixin,DALResultsThe list of matching images resulting from an image (SIA) query. Each record contains a set of metadata that describes an available image matching the query constraints. The number of records in the results is available by passing it to the Python built-in
len()function.This class supports iterable semantics; thus, individual records (in the form of
Recordinstances) are typically accessed by iterating over anTAPResultsinstance.Alternatively, records can be accessed randomly via
getrecord()or through a Python Database API (v2) Cursor (viacursor()). Column-based data access is possible via thegetcolumn()method.TAPResultsis essentially a wrapper around an AstropyvotableTableElementinstance where the columns contain the various metadata describing the images. One can access that VOTable directly via thepyvo.dal.DALResults.votableattribute. Thus, when one retrieves a whole column viagetcolumn(), the result is a Numpy array. Alternatively, one can manipulate the results as an Astropyastropy.table.Tablevia the following conversion:table = results.to_tableSIAResultssupports the array item operator[...]in a read-only context. When the argument is numerical, the result is anRecordinstance, 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:
- votableastropy.io.votable.tree.VOTableFile
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
See also
Attributes Summary
return the info element as dictionary
return the query status
Methods Summary
getrecord(index)return a representation of a tap result record that follows dictionary semantics.
Attributes Documentation
- infos¶
return the info element as dictionary
- query_status¶
return the query status
Methods Documentation
- getrecord(index)[source]¶
return a representation of a tap result record that follows dictionary semantics. The keys of the dictionary are those returned by this instance’s fieldnames attribute. The returned record has additional image-specific properties
- Parameters:
- indexint
the integer index of the desired record where 0 returns the first record
- Returns:
- REc
a dictionary-like wrapper containing the result record metadata.
- Raises:
- IndexError
if index is negative or equal or larger than the number of rows in the result table.
See also