IrsaClass

class astroquery.ipac.irsa.IrsaClass[source]

Bases: BaseQuery

Attributes Summary

GATOR_LIST_URL

IRSA_URL

ROW_LIMIT

TIMEOUT

Methods Summary

list_catalogs([cache])

Return a dictionary of the catalogs in the IRSA Gator tool.

print_catalogs([cache])

Display a table of the catalogs in the IRSA Gator tool.

query_region(*args, **kwargs)

Queries the service and returns a table object.

query_region_async([coordinates, catalog, ...])

This function serves the same purpose as query_region(), but returns the raw HTTP response rather than the results in a Table.

Attributes Documentation

GATOR_LIST_URL = 'https://irsa.ipac.caltech.edu/cgi-bin/Gator/nph-scan'
IRSA_URL = 'https://irsa.ipac.caltech.edu/cgi-bin/Gator/nph-query'
ROW_LIMIT = 500
TIMEOUT = 60

Methods Documentation

list_catalogs(cache=False)[source]

Return a dictionary of the catalogs in the IRSA Gator tool.

Parameters:
cachebool

Use local cache when set to True. Default is False.

Returns:
catalogsdict

A dictionary of catalogs where the key indicates the catalog name to be used in query functions, and the value is the verbose description of the catalog.

print_catalogs(cache=False)[source]

Display a table of the catalogs in the IRSA Gator tool.

query_region(*args, **kwargs)

Queries the service and returns a table object.

This function serves the same purpose as query_region(), but returns the raw HTTP response rather than the results in a Table.

Parameters:
coordinatesstr, astropy.coordinates object

Gives the position of the center of the cone or box if performing a cone or box search. The string can give coordinates in various coordinate systems, or the name of a source that will be resolved on the server (see here for more details). Required if spatial is 'Cone' or 'Box'. Optional if spatial is 'Polygon'.

catalogstr

The catalog to be used. To list the available catalogs, use print_catalogs().

spatialstr

Type of spatial query: 'Cone', 'Box', 'Polygon', and 'All-Sky'. If missing then defaults to 'Cone'.

radiusstr or Quantity object, [optional for spatial is 'Cone']

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. Defaults to 10 arcsec.

widthstr, Quantity object [Required for spatial is 'Polygon'.]

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used.

polygonlist, [Required for spatial is 'Polygon']

A list of (ra, dec) pairs (as tuples), in decimal degrees, outlining the polygon to search in. It can also be a list of astropy.coordinates object or strings that can be parsed by astropy.coordinates.ICRS.

get_query_payloadbool, optional

If True then returns the dictionary sent as the HTTP request. Defaults to False.

selcolsstr, optional

Target column list with value separated by a comma(,)

verbosebool, optional.

If True then displays warnings when the returned VOTable does not conform to the standard. Defaults to False.

cachebool, optional

Use local cache when set to True.

Returns:
tableA Table object.
query_region_async(coordinates=None, *, catalog=None, spatial='Cone', radius=<Quantity 10. arcsec>, width=None, polygon=None, get_query_payload=False, selcols=None, verbose=False, cache=True)[source]

This function serves the same purpose as query_region(), but returns the raw HTTP response rather than the results in a Table.

Parameters:
coordinatesstr, astropy.coordinates object

Gives the position of the center of the cone or box if performing a cone or box search. The string can give coordinates in various coordinate systems, or the name of a source that will be resolved on the server (see here for more details). Required if spatial is 'Cone' or 'Box'. Optional if spatial is 'Polygon'.

catalogstr

The catalog to be used. To list the available catalogs, use print_catalogs().

spatialstr

Type of spatial query: 'Cone', 'Box', 'Polygon', and 'All-Sky'. If missing then defaults to 'Cone'.

radiusstr or Quantity object, [optional for spatial is 'Cone']

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. Defaults to 10 arcsec.

widthstr, Quantity object [Required for spatial is 'Polygon'.]

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used.

polygonlist, [Required for spatial is 'Polygon']

A list of (ra, dec) pairs (as tuples), in decimal degrees, outlining the polygon to search in. It can also be a list of astropy.coordinates object or strings that can be parsed by astropy.coordinates.ICRS.

get_query_payloadbool, optional

If True then returns the dictionary sent as the HTTP request. Defaults to False.

selcolsstr, optional

Target column list with value separated by a comma(,)

verbosebool, optional.

If True then displays warnings when the returned VOTable does not conform to the standard. Defaults to False.

cachebool, optional

Use local cache when set to True.

Returns:
responserequests.Response

The HTTP response returned from the service