The pyvo.dal Package

The pyvo.dal module encapsulates the implementation of the DAL services. The query sub-module provides DAL behaviors through a set of base classes and common exception classes. The implementations for the specific types of services are handle the sub-modules scs, sia, ssa, sla, tap

pyvo.dal.query Module

A module for walking through the query response of VO data access layer (DAL) queries and general VOTable-based datasets.

Most data queries in the VO return a table as a result, usually formatted as a VOTable. Each row of the table describes a single physical or virtual dataset which can be retrieved. For uniformity, datasets are described via standard metadata defined by a data model specific to the type of data being queried. The fields of the data model are identified most generally by their VOClient alias as defined in this interface, or at a lower level by the Utype or UCD of the specific standard and version of the standard being queried. While the data model differs depending upon the type of data being queried, the form of the query response is the same for all classes of data, allowing a common query response interface to be used.

An exception to this occurs when querying an astronomical catalog or other externally defined table. In this case there is no VO defined standard data model. Usually the field names are used to uniquely identify table columns.

Classes

DALAccessError([reason, url, protocol, version]) a base class for failures while accessing a DAL service
DALProtocolError([reason, cause, url, ...]) a base exception indicating that a DAL service responded in an
DALFormatError([cause, url, reason, ...]) an exception indicating that a DAL response contains fatal format errors.
DALServiceError([reason, code, cause, url, ...]) an exception indicating a failure communicating with a DAL
DALQueryError([reason, label, url, ...]) an exception indicating an error by a working DAL service while processing
DALService(baseurl[, protocol, version, resmeta]) an abstract base class representing a DAL service located a particular
DALQuery(baseurl[, protocol, version]) a class for preparing a query to a particular service. Query constraints
DALResults(votable[, url, protocol, version]) Results from a DAL query.
Record(results, index[, fielddesc]) one record from a DAL query result. The column values are accessible

Class Inheritance Diagram

digraph inheritance939a74041c { rankdir=LR; size="8.0, 12.0"; "DALAccessError" [URL="../../api/pyvo.dal.query.DALAccessError.html#pyvo.dal.query.DALAccessError",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a base class for failures while accessing a DAL service"]; "DALFormatError" [URL="../../api/pyvo.dal.query.DALFormatError.html#pyvo.dal.query.DALFormatError",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="an exception indicating that a DAL response contains fatal format errors."]; "DALProtocolError" -> "DALFormatError" [arrowsize=0.5,style="setlinewidth(0.5)"]; "DALProtocolError" [URL="../../api/pyvo.dal.query.DALProtocolError.html#pyvo.dal.query.DALProtocolError",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a base exception indicating that a DAL service responded in an"]; "DALAccessError" -> "DALProtocolError" [arrowsize=0.5,style="setlinewidth(0.5)"]; "DALQuery" [URL="../../api/pyvo.dal.query.DALQuery.html#pyvo.dal.query.DALQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing a query to a particular service. Query constraints"]; "DALQueryError" [URL="../../api/pyvo.dal.query.DALQueryError.html#pyvo.dal.query.DALQueryError",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="an exception indicating an error by a working DAL service while processing"]; "DALAccessError" -> "DALQueryError" [arrowsize=0.5,style="setlinewidth(0.5)"]; "DALResults" [URL="../../api/pyvo.dal.query.DALResults.html#pyvo.dal.query.DALResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="Results from a DAL query. It provides random access to records in "]; "DALService" [URL="../../api/pyvo.dal.query.DALService.html#pyvo.dal.query.DALService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="an abstract base class representing a DAL service located a particular "]; "DALServiceError" [URL="../../api/pyvo.dal.query.DALServiceError.html#pyvo.dal.query.DALServiceError",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="an exception indicating a failure communicating with a DAL"]; "DALProtocolError" -> "DALServiceError" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Record" [URL="../../api/pyvo.dal.query.Record.html#pyvo.dal.query.Record",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="one record from a DAL query result. The column values are accessible "]; }

pyvo.dal.scs Module

A module for searching remote source and observation catalogs

A Simple Cone Search (SCS) service allows a client to search for records in a source or observation catalog whose positions are within some minimum distance of a search position (i.e. within a specified “cone” on the sky). This module provides an interface for accessing such services. It is implemented as a specialization of the DAL Query interface.

The search() function provides a simple interface to a service, returning an SCSResults instance as its results which represents the matching records from the catalog. The SCSResults supports access to and iterations over the individual records; these are provided as SCSRecord instances, which give easy access to key metadata in the response, including the ICRS position of the matched source or observation.

This module also features the SCSQuery class that provides an interface for building up and remembering a query. The SCSService class can represent a specific service available at a URL endpoint.

Functions

search(url, pos[, radius, verbosity]) submit a simple Cone Search query that requests objects or observations

Classes

SCSService(baseurl[, resmeta, version]) a representation of a Cone Search service
SCSQuery(baseurl[, version]) a class for preparing an query to a Cone Search service. Query constraints
SCSResults(votable[, url, version]) The list of matching catalog records resulting from a catalog (SCS) query.
SCSRecord(results, index) a dictionary-like container for data in a record from the results of an

Class Inheritance Diagram

digraph inheritance930fe4e733 { rankdir=LR; size="8.0, 12.0"; "DALQuery" [URL="../../api/pyvo.dal.query.DALQuery.html#pyvo.dal.query.DALQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing a query to a particular service. Query constraints"]; "DALResults" [URL="../../api/pyvo.dal.query.DALResults.html#pyvo.dal.query.DALResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="Results from a DAL query. It provides random access to records in "]; "DALService" [URL="../../api/pyvo.dal.query.DALService.html#pyvo.dal.query.DALService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="an abstract base class representing a DAL service located a particular "]; "Record" [URL="../../api/pyvo.dal.query.Record.html#pyvo.dal.query.Record",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="one record from a DAL query result. The column values are accessible "]; "SCSQuery" [URL="../../api/pyvo.dal.scs.SCSQuery.html#pyvo.dal.scs.SCSQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing an query to a Cone Search service. Query constraints"]; "DALQuery" -> "SCSQuery" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SCSRecord" [URL="../../api/pyvo.dal.scs.SCSRecord.html#pyvo.dal.scs.SCSRecord",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a dictionary-like container for data in a record from the results of an"]; "Record" -> "SCSRecord" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SCSResults" [URL="../../api/pyvo.dal.scs.SCSResults.html#pyvo.dal.scs.SCSResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="The list of matching catalog records resulting from a catalog (SCS) query. "]; "DALResults" -> "SCSResults" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SCSService" [URL="../../api/pyvo.dal.scs.SCSService.html#pyvo.dal.scs.SCSService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a representation of a Cone Search service"]; "DALService" -> "SCSService" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

pyvo.dal.sia Module

A module for searching for images in a remote archive.

A Simple Image Access (SIA) service allows a client to search for images in an archive whose field of view overlaps with a given rectangular region on the sky. The service responds to a search query with a table in which each row represents an image that is available for download. The columns provide metadata describing each image and one column in particular provides the image’s download URL (also called the access reference, or acref). Some SIA services act as a cut-out service; in this case, the query result is a table of images whose field of view matches the requested region and which will be created when accessed via the download URL.

This module provides an interface for accessing an SIA service. It is implemented as a specialization of the DAL Query interface.

The search() function support the simplest and most common types of queries, returning an SIAResults instance as its results which represents the matching imagess from the archive. The SIAResults supports access to and iterations over the individual records; these are provided as SIARecord instances, which give easy access to key metadata in the response, such as the position of the image’s center, the image format, the size and shape of the image, and its download URL.

For more complex queries, the SIAQuery class can be helpful which allows one to build up, tweak, and reuse a query. The SIAService class can represent a specific service available at a URL endpoint.

Functions

search(url, pos, size[, format, intersect, ...]) submit a simple SIA query that requests images overlapping a given region

Classes

SIAService(baseurl[, resmeta, version]) a representation of an SIA service
SIAQuery(baseurl[, version]) a class for preparing an query to an SIA service. Query constraints
SIAResults(votable[, url]) The list of matching images resulting from an image (SIA) query.
SIARecord(results, index) a dictionary-like container for data in a record from the results of an

Class Inheritance Diagram

digraph inheritancec3b496f6dc { rankdir=LR; size="8.0, 12.0"; "DALQuery" [URL="../../api/pyvo.dal.query.DALQuery.html#pyvo.dal.query.DALQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing a query to a particular service. Query constraints"]; "DALResults" [URL="../../api/pyvo.dal.query.DALResults.html#pyvo.dal.query.DALResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="Results from a DAL query. It provides random access to records in "]; "DALService" [URL="../../api/pyvo.dal.query.DALService.html#pyvo.dal.query.DALService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="an abstract base class representing a DAL service located a particular "]; "Record" [URL="../../api/pyvo.dal.query.Record.html#pyvo.dal.query.Record",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="one record from a DAL query result. The column values are accessible "]; "SIAQuery" [URL="../../api/pyvo.dal.sia.SIAQuery.html#pyvo.dal.sia.SIAQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing an query to an SIA service. Query constraints"]; "DALQuery" -> "SIAQuery" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SIARecord" [URL="../../api/pyvo.dal.sia.SIARecord.html#pyvo.dal.sia.SIARecord",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a dictionary-like container for data in a record from the results of an"]; "Record" -> "SIARecord" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SIAResults" [URL="../../api/pyvo.dal.sia.SIAResults.html#pyvo.dal.sia.SIAResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="The list of matching images resulting from an image (SIA) query. "]; "DALResults" -> "SIAResults" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SIAService" [URL="../../api/pyvo.dal.sia.SIAService.html#pyvo.dal.sia.SIAService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a representation of an SIA service"]; "DALService" -> "SIAService" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

pyvo.dal.ssa Module

A module for searching for spectra in a remote archive.

A Simple Spectral Access (SSA) service allows a client to search for spectra in an archive whose field of view overlaps with a given cone on the sky. The service responds to a search query with a table in which each row represents an image that is available for download. The columns provide metadata describing each image and one column in particular provides the image’s download URL (also called the access reference, or acref). Some SSA services can create spectra on-the-fly from underlying data (e.g. image cubes); in this case, the query result is a table of images whose aperture matches the requested cone and which will be created when accessed via the download URL.

This module provides an interface for accessing an SSA service. It is implemented as a specialization of the DAL Query interface.

The search() function support the simplest and most common types of queries, returning an SSAResults instance as its results which represents the matching imagess from the archive. The SSAResults supports access to and iterations over the individual records; these are provided as SSARecord instances, which give easy access to key metadata in the response, such as the position of the spectrum’s aperture, the spectrum format, its frequency range, and its download URL.

For more complex queries, the SSAQuery class can be helpful which allows one to build up, tweak, and reuse a query. The SSAService class can represent a specific service available at a URL endpoint.

Functions

search(url, pos, size[, format]) submit a simple SSA query that requests spectra overlapping a

Classes

SSAService(baseurl[, resmeta, version]) a representation of an SSA service
SSAQuery(baseurl[, version, request]) a class for preparing an query to an SSA service. Query constraints
SSAResults(votable[, url]) The list of matching images resulting from a spectrum (SSA) query.
SSARecord(results, index) a dictionary-like container for data in a record from the results of an

Class Inheritance Diagram

digraph inheritancebe7c463795 { rankdir=LR; size="8.0, 12.0"; "DALQuery" [URL="../../api/pyvo.dal.query.DALQuery.html#pyvo.dal.query.DALQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing a query to a particular service. Query constraints"]; "DALResults" [URL="../../api/pyvo.dal.query.DALResults.html#pyvo.dal.query.DALResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="Results from a DAL query. It provides random access to records in "]; "DALService" [URL="../../api/pyvo.dal.query.DALService.html#pyvo.dal.query.DALService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="an abstract base class representing a DAL service located a particular "]; "Record" [URL="../../api/pyvo.dal.query.Record.html#pyvo.dal.query.Record",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="one record from a DAL query result. The column values are accessible "]; "SSAQuery" [URL="../../api/pyvo.dal.ssa.SSAQuery.html#pyvo.dal.ssa.SSAQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing an query to an SSA service. Query constraints"]; "DALQuery" -> "SSAQuery" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SSARecord" [URL="../../api/pyvo.dal.ssa.SSARecord.html#pyvo.dal.ssa.SSARecord",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a dictionary-like container for data in a record from the results of an"]; "Record" -> "SSARecord" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SSAResults" [URL="../../api/pyvo.dal.ssa.SSAResults.html#pyvo.dal.ssa.SSAResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="The list of matching images resulting from a spectrum (SSA) query. "]; "DALResults" -> "SSAResults" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SSAService" [URL="../../api/pyvo.dal.ssa.SSAService.html#pyvo.dal.ssa.SSAService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a representation of an SSA service"]; "DALService" -> "SSAService" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

pyvo.dal.sla Module

A module for searching for spectral line metadata in a remote database.

A Simple Line Access (SLA) service allows a client to search for metadata describing atomic and molecular transitions that can result in spectral line emission and absorption. The service responds to a search query with a table in which each row represents a transition that matches the query constraints. The columns provide the metadata describing the transition. This module provides an interface for accessing an SLA service. It is implemented as a specialization of the DAL Query interface.

The search() function support the simplest and most common types of queries, returning an SLAResults instance as its results which represents the matching imagess from the archive. The SLAResults supports access to and iterations over the individual records; these are provided as SLARecord instances, which give easy access to key metadata in the response, such as the transition title.

For more complex queries, the SLAQuery class can be helpful which allows one to build up, tweak, and reuse a query. The SLAService class can represent a specific service available at a URL endpoint.

Functions

search(url, wavelength, \*\*keywords) submit a simple SLA query that requests spectral lines within a

Classes

SLAService(baseurl[, resmeta, version]) a representation of an spectral line catalog (SLA) service
SLAQuery(baseurl[, version, request]) a class for preparing an query to an SLA service. Query constraints
SLAResults(votable[, url]) The list of matching spectral lines resulting from a spectal line catalog (SLA) query.
SLARecord(results, index) a dictionary-like container for data in a record from the results of an

Class Inheritance Diagram

digraph inheritance328608fd3e { rankdir=LR; size="8.0, 12.0"; "DALQuery" [URL="../../api/pyvo.dal.query.DALQuery.html#pyvo.dal.query.DALQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing a query to a particular service. Query constraints"]; "DALResults" [URL="../../api/pyvo.dal.query.DALResults.html#pyvo.dal.query.DALResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="Results from a DAL query. It provides random access to records in "]; "DALService" [URL="../../api/pyvo.dal.query.DALService.html#pyvo.dal.query.DALService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="an abstract base class representing a DAL service located a particular "]; "Record" [URL="../../api/pyvo.dal.query.Record.html#pyvo.dal.query.Record",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="one record from a DAL query result. The column values are accessible "]; "SLAQuery" [URL="../../api/pyvo.dal.sla.SLAQuery.html#pyvo.dal.sla.SLAQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing an query to an SLA service. Query constraints"]; "DALQuery" -> "SLAQuery" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SLARecord" [URL="../../api/pyvo.dal.sla.SLARecord.html#pyvo.dal.sla.SLARecord",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a dictionary-like container for data in a record from the results of an"]; "Record" -> "SLARecord" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SLAResults" [URL="../../api/pyvo.dal.sla.SLAResults.html#pyvo.dal.sla.SLAResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="The list of matching spectral lines resulting from a spectal line "]; "DALResults" -> "SLAResults" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SLAService" [URL="../../api/pyvo.dal.sla.SLAService.html#pyvo.dal.sla.SLAService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a representation of an spectral line catalog (SLA) service"]; "DALService" -> "SLAService" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

pyvo.dal.tap Module

A module for accessing remote source and observation catalogs

Functions

search(url, query[, language, maxrec, uploads]) submit a Table Access query that returns rows matching the criteria given.
escape(term) escapes a term for use in ADQL

Classes

TAPService(baseurl) a representation of a Table Access Protocol service
TAPQuery(baseurl, query[, mode, language, ...]) initialize the query object with the given parameters
AsyncTAPJob(url) initialize the job object with the given url and fetch the remote values
TAPResults(votable[, url, protocol, version]) initialize the cursor. This constructor is not typically called

Class Inheritance Diagram

digraph inheritance4435ac0b88 { rankdir=LR; size="8.0, 12.0"; "AsyncTAPJob" [URL="../../api/pyvo.dal.tap.AsyncTAPJob.html#pyvo.dal.tap.AsyncTAPJob",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top"]; "DALQuery" [URL="../../api/pyvo.dal.query.DALQuery.html#pyvo.dal.query.DALQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing a query to a particular service. Query constraints"]; "DALResults" [URL="../../api/pyvo.dal.query.DALResults.html#pyvo.dal.query.DALResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="Results from a DAL query. It provides random access to records in "]; "DALService" [URL="../../api/pyvo.dal.query.DALService.html#pyvo.dal.query.DALService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="an abstract base class representing a DAL service located a particular "]; "TAPQuery" [URL="../../api/pyvo.dal.tap.TAPQuery.html#pyvo.dal.tap.TAPQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top"]; "DALQuery" -> "TAPQuery" [arrowsize=0.5,style="setlinewidth(0.5)"]; "TAPResults" [URL="../../api/pyvo.dal.tap.TAPResults.html#pyvo.dal.tap.TAPResults",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top"]; "DALResults" -> "TAPResults" [arrowsize=0.5,style="setlinewidth(0.5)"]; "TAPService" [URL="../../api/pyvo.dal.tap.TAPService.html#pyvo.dal.tap.TAPService",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a representation of a Table Access Protocol service"]; "DALService" -> "TAPService" [arrowsize=0.5,style="setlinewidth(0.5)"]; }