SSAService¶
-
class
pyvo.dal.ssa.
SSAService
(baseurl)[source]¶ Bases:
pyvo.dal.query.DALService
a representation of an SSA service
instantiate an SSA service
Parameters: baseurl : str
the base URL for submitting search queries to the service.
Methods Summary
create_query
([pos, diameter, band, time, …])create a query object that constraints can be added to and then search
(pos, diameter[, band, time, format])submit a simple SSA query to this service with the given constraints. Methods Documentation
-
create_query
(pos=None, diameter=None, band=None, time=None, format=None, request='queryData', **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 :
SkyCoord
class or sequence of two floatsthe position of the center of the circular search region. assuming icrs decimal degrees if unit is not specified.
diameter :
Quantity
class or scalar floatthe diameter of the circular region around pos in which to search. assuming icrs decimal degrees if unit is not specified.
band :
Quantity
class or sequence of two floatsthe bandwidth range the observations belong to. assuming meters if unit is not specified.
time :
Time
class or sequence of two stringsthe datetime range the observations were made in. assuming iso 8601 if format is not specified.
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.
**keywords :
additional case insensitive parameters can be given via arbitrary case insensitive keyword arguments. Where there is overlap with the parameters set by the other arguments to this function, these keywords will override.
Returns: SSAQuery
the query instance
See also
-
search
(pos, diameter, band=None, time=None, format='all', **keywords)[source]¶ submit a simple SSA query to this service with the given constraints.
This method is provided for a simple but typical SSA queries. For more complex queries, one should create an SSAQuery object via create_query()
Parameters: pos :
SkyCoord
class or sequence of two floatsthe position of the center of the circular search region. assuming icrs decimal degrees if unit is not specified.
diameter :
Quantity
class or scalar floatthe diameter of the circular region around pos in which to search. assuming icrs decimal degrees if unit is not specified.
band :
Quantity
class or sequence of two floatsthe bandwidth range the observations belong to. assuming meters if unit is not specified.
time :
Time
class or sequence of two stringsthe datetime range the observations were made in. assuming iso 8601 if format is not specified.
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.
**keywords :
additional case insensitive parameters can be given via arbitrary case insensitive keyword arguments. Where there is overlap with the parameters set by the other arguments to this function, these keywords will override.
Returns: SSAResults
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
-