spectrumsearch¶
- pyvo.dal.spectrumsearch(baseurl, pos=None, *, diameter=None, band=None, time=None, format=None, **keywords)¶
submit a simple SSA query that requests spectra overlapping a given region
- Parameters:
- baseurlstr
the base URL for the SSA service
- pos
SkyCoord
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.
- diameter
Quantity
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.
- band
Quantity
class or sequence of two floats the bandwidth range the observations belong to. assuming meters if unit is not specified.
- time
Time
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 spectrum 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.
See also
SSAResults
pyvo.dal.query.DALServiceError
pyvo.dal.query.DALQueryError