SSAService

class pyvo.dal.SSAService(baseurl, *, capability_description=None, session=None)[source]

Bases: DALService

a representation of an SSA service

instantiate an SSA service

Parameters
baseurlstr

the base URL for submitting search queries to the service.

Attributes Summary

columns

the available columns on this service

description

the service description.

Methods Summary

create_query([pos, diameter, band, time, ...])

create a query object that constraints can be added to and then executed.

describe()

describe the general information about the DAL service

search([pos, diameter, band, time, format])

submit a SSA query to this service with the given constraints.

Attributes Documentation

columns

the available columns on this service

description

the service description.

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
posSkyCoord class or sequence of two floats

the position of the center of the circular search region. assuming icrs decimal degrees if unit is not specified.

diameterQuantity class or scalar float

the diameter of the circular region around pos in which to search. assuming icrs decimal degrees if unit is not specified.

bandQuantity class or sequence of two floats

the bandwidth range the observations belong to. assuming meters if unit is not specified.

timeTime class or sequence of two strings

the datetime range the observations were made in. assuming iso 8601 if format is not specified.

formatstr

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

SSAQuery
describe()[source]

describe the general information about the DAL service

search(pos=None, *, diameter=None, band=None, time=None, format=None, **keywords)[source]

submit a SSA query to this service with the given constraints.

Parameters
posSkyCoord class or sequence of two floats

the position of the center of the circular search region. assuming icrs decimal degrees if unit is not specified.

diameterQuantity class or scalar float

the diameter of the circular region around pos in which to search. assuming icrs decimal degrees if unit is not specified.

bandQuantity class or sequence of two floats

the bandwidth range the observations belong to. assuming meters if unit is not specified.

timeTime class or sequence of two strings

the datetime range the observations were made in. assuming iso 8601 if format is not specified.

formatstr

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 query syntax errors