SIAService¶
-
class
pyvo.dal.sia.
SIAService
(baseurl, resmeta=None, version='1.0')[source]¶ Bases:
pyvo.dal.query.DALService
a representation of an SIA service
instantiate an SIA service
Parameters: baseurl : str
the base URL for submitting search queries to the service.
resmeta : str
an optional dictionary of properties about the service
Methods Summary
create_query
([pos, size, format, intersect, ...])create a query object that constraints can be added to and then search
(pos, size[, format, intersect, verbosity])submit a simple SIA query to this service with the given constraints. Methods Documentation
-
create_query
(pos=None, size=None, format=None, intersect=None, verbosity=None, **keywords)[source]¶ create a query object that constraints can be added to and then executed. The input arguments will initialize the query with the given values.
Parameters: pos : 2-element tuple of floats
a 2-element tuple giving the ICRS RA and Dec of the center of the search region in decimal degrees
size : 2-element tuple of floats
a 2-element tuple giving the full rectangular size of the search region along the RA and Dec directions in decimal degrees
format : str
the image format(s) of interest. “all” indicates all available formats; “graphic” indicates graphical images (e.g. jpeg, png, gif; not FITS); “metadata” indicates that no images should be returned–only an empty table with complete metadata; “image/*” indicates a particular image format where * can have values like “fits”, “jpeg”, “png”, etc.
intersect : str
a token indicating how the returned images should intersect with the search region; recognized values include:
COVERS select images that completely cover the search region ENCLOSED select images that are complete enclosed by the region OVERLAPS select any image that overlaps with the search region CENTER select images whose center is within the search region verbosity : int
an integer value that indicates the volume of columns to return in the result table. 0 means the minimum set of columsn, 3 means as many columns as are available.
**keywords :
additional parameters can be given via arbitrary keyword arguments. These can be either standard parameters (with names drown from the
SIAQuery.std_parameters
list) or paramters custom to the service. Where there is overlap with the parameters set by the other arguments to this function, these keywords will override.Returns: SIAQuery
the query instance
See also
-
search
(pos, size, format='all', intersect='overlaps', verbosity=2, **keywords)[source]¶ submit a simple SIA query to this service with the given constraints.
This method is provided for a simple but typical SIA queries. For more complex queries, one should create an SIAQuery object via create_query()
Parameters: pos : 2-element tuple of floats
the ICRS RA and Dec of the center of the search region in decimal degrees
size : a float or a 2-element sequence of floats
the full rectangular size of the search region along the RA and Dec directions in decimal degrees
format : str
the image format(s) of interest. “all” (default) indicates all available formats; “graphic” indicates graphical images (e.g. jpeg, png, gif; not FITS); “metadata” indicates that no images should be returned–only an empty table with complete metadata; “image/*” indicates a particular image format where * can have values like “fits”, “jpeg”, “png”, etc.
intersect : str
a token indicating how the returned images should intersect with the search region; recognized values include:
COVERS select images that completely cover the search region ENCLOSED select images that are complete enclosed by the region OVERLAPS select any image that overlaps with the search region CENTER select images whose center is within the search region verbosity : str
an integer value that indicates the volume of columns to return in the result table. 0 means the minimum set of columsn, 3 means as many columns as are available.
**keywords :
additional parameters can be given via arbitrary keyword arguments. These can be either standard parameters (with names drown from the
SIAQuery.std_parameters
list) or paramters custom to the service. Where there is overlap with the parameters set by the other arguments to this function, these keywords will override.Returns: SIAResults
a container holding a table of matching catalog records
Raises: DALServiceError
for errors connecting to or communicating with the service
DALQueryError
if the service responds with an error, including a query syntax error.
-