astroquery:docs

Vizier

class astroquery.vizier.core.Vizier(columns=None, column_filters=None, keywords=None)[source] [edit on github]

Bases: astroquery.query.BaseQuery

Attributes Summary

ROW_LIMIT int(x=0) -> int or long
TIMEOUT int(x=0) -> int or long
VIZIER_SERVER str(object=’‘) -> string
column_filters Set constraints on one or more columns of the output
columns The columns that must be returned in the output
keywords The set of keywords to filter the Vizier search

Methods Summary

find_catalogs(*args, **kwds) Search Vizier for catalogs based on a set of keywords, e.g.
get_catalogs(*args, **kwds) Queries the service and returns a table object.
get_catalogs_async(*args, **kwds) Query the Vizier service for a specific catalog
query_constraints(*args, **kwds) Queries the service and returns a table object.
query_constraints_async(*args, **kwds) Send a query to Vizier in which you specify constraints with keyword/value pairs.
query_object(*args, **kwds) Queries the service and returns a table object.
query_object_async(*args, **kwds) Serves the same purpose as astroquery.vizier.Vizier.query_object but only returns the HTTP response rather than the parsed result.
query_region(*args, **kwds) Queries the service and returns a table object.
query_region_async(*args, **kwds) Serves the same purpose as astroquery.vizier.Vizier.query_region but only returns the HTTP response rather than the parsed result.

Attributes Documentation

ROW_LIMIT = 50
TIMEOUT = 60
VIZIER_SERVER = 'vizier.u-strasbg.fr'
column_filters[source]

Set constraints on one or more columns of the output

columns[source]

The columns that must be returned in the output

keywords[source]

The set of keywords to filter the Vizier search

Methods Documentation

static find_catalogs(*args, **kwds)[source] [edit on github]

Search Vizier for catalogs based on a set of keywords, e.g. author name

Parameters :

keywords : list or string

List of keywords, or space-separated set of keywords. From Vizier: “names or words of title of catalog. The words are and’ed, i.e. only the catalogues characterized by all the words are selected.”

Returns :

Dictionary of the “Resource” name and the VOTable resource object. :

“Resources” are generally publications; one publication may contain :

many tables. :

static get_catalogs(*args, **kwds) [edit on github]

Queries the service and returns a table object.

Query the Vizier service for a specific catalog

Parameters :

catalog : str or list, optional

The catalog(s) that will be retrieved

Returns :

An `astropy.table.Table` object :

static get_catalogs_async(*args, **kwds)[source] [edit on github]

Query the Vizier service for a specific catalog

Parameters :

catalog : str or list, optional

The catalog(s) that will be retrieved

Returns :

response : response

Returned if asynchronous method used

static query_constraints(*args, **kwds) [edit on github]

Queries the service and returns a table object.

Send a query to Vizier in which you specify constraints with keyword/value pairs. See the vizier constraints page for details.

Parameters :

catalog : str or list, optional

The catalog(s) which must be searched for this identifier. If not specified, all matching catalogs will be searched.

keywords : dict

A dictionary of keywords to query on.

kwargs : dict

Any key/value pairs besides “catalog” and “keywords” will be parsed as additional keywords. kwargs overrides anything specified in keywords.

Returns :

An `astropy.table.Table` object :

Examples

>>> from astroquery.vizier import Vizier
>>> # note that glon/glat constraints here *must* be floats
>>> result = Vizier.query_constraints(catalog='J/ApJ/723/492/table1',GLON='>49.0 & < 51.0', GLAT='<0.0')
>>> result[result.keys()[0]].pprint()
    GRSMC      GLON   GLAT   VLSR  ... RD09 _RA.icrs _DE.icrs
------------- ------ ------ ------ ... ---- -------- --------
G049.49-00.41  49.49  -0.41  56.90 ... RD09   290.95    14.50
G049.39-00.26  49.39  -0.26  50.94 ... RD09   290.77    14.48
G049.44-00.06  49.44  -0.06  62.00 ... RD09   290.61    14.62
G049.04-00.31  49.04  -0.31  66.25 ... RD09   290.64    14.15
G049.74-00.56  49.74  -0.56  67.95 ... RD09   291.21    14.65
G050.39-00.41  50.39  -0.41  41.17 ... RD09   291.39    15.29
G050.24-00.61  50.24  -0.61  41.17 ... RD09   291.50    15.06
G050.94-00.61  50.94  -0.61  40.32 ... RD09   291.85    15.68
G049.99-00.16  49.99  -0.16  46.27 ... RD09   290.97    15.06
G049.44-00.06  49.44  -0.06  46.27 ... RD09   290.61    14.62
G049.54-00.01  49.54  -0.01  56.05 ... RD09   290.61    14.73
G049.74-00.01  49.74  -0.01  48.39 ... RD09   290.71    14.91
G049.54-00.91  49.54  -0.91  43.29 ... RD09   291.43    14.31
G049.04-00.46  49.04  -0.46  58.60 ... RD09   290.78    14.08
G049.09-00.06  49.09  -0.06  46.69 ... RD09   290.44    14.31
G050.84-00.11  50.84  -0.11  50.52 ... RD09   291.34    15.83
G050.89-00.11  50.89  -0.11  59.45 ... RD09   291.37    15.87
G050.44-00.41  50.44  -0.41  64.12 ... RD09   291.42    15.34
G050.84-00.76  50.84  -0.76  61.15 ... RD09   291.94    15.52
G050.29-00.46  50.29  -0.46  14.81 ... RD09   291.39    15.18
static query_constraints_async(*args, **kwds)[source] [edit on github]

Send a query to Vizier in which you specify constraints with keyword/value pairs. See the vizier constraints page for details.

Parameters :

catalog : str or list, optional

The catalog(s) which must be searched for this identifier. If not specified, all matching catalogs will be searched.

keywords : dict

A dictionary of keywords to query on.

kwargs : dict

Any key/value pairs besides “catalog” and “keywords” will be parsed as additional keywords. kwargs overrides anything specified in keywords.

Returns :

response : requests.Response object

The response of the HTTP request.

Examples

>>> from astroquery.vizier import Vizier
>>> # note that glon/glat constraints here *must* be floats
>>> result = Vizier.query_constraints(catalog='J/ApJ/723/492/table1',GLON='>49.0 & < 51.0', GLAT='<0.0')
>>> result[result.keys()[0]].pprint()
    GRSMC      GLON   GLAT   VLSR  ... RD09 _RA.icrs _DE.icrs
------------- ------ ------ ------ ... ---- -------- --------
G049.49-00.41  49.49  -0.41  56.90 ... RD09   290.95    14.50
G049.39-00.26  49.39  -0.26  50.94 ... RD09   290.77    14.48
G049.44-00.06  49.44  -0.06  62.00 ... RD09   290.61    14.62
G049.04-00.31  49.04  -0.31  66.25 ... RD09   290.64    14.15
G049.74-00.56  49.74  -0.56  67.95 ... RD09   291.21    14.65
G050.39-00.41  50.39  -0.41  41.17 ... RD09   291.39    15.29
G050.24-00.61  50.24  -0.61  41.17 ... RD09   291.50    15.06
G050.94-00.61  50.94  -0.61  40.32 ... RD09   291.85    15.68
G049.99-00.16  49.99  -0.16  46.27 ... RD09   290.97    15.06
G049.44-00.06  49.44  -0.06  46.27 ... RD09   290.61    14.62
G049.54-00.01  49.54  -0.01  56.05 ... RD09   290.61    14.73
G049.74-00.01  49.74  -0.01  48.39 ... RD09   290.71    14.91
G049.54-00.91  49.54  -0.91  43.29 ... RD09   291.43    14.31
G049.04-00.46  49.04  -0.46  58.60 ... RD09   290.78    14.08
G049.09-00.06  49.09  -0.06  46.69 ... RD09   290.44    14.31
G050.84-00.11  50.84  -0.11  50.52 ... RD09   291.34    15.83
G050.89-00.11  50.89  -0.11  59.45 ... RD09   291.37    15.87
G050.44-00.41  50.44  -0.41  64.12 ... RD09   291.42    15.34
G050.84-00.76  50.84  -0.76  61.15 ... RD09   291.94    15.52
G050.29-00.46  50.29  -0.46  14.81 ... RD09   291.39    15.18
static query_object(*args, **kwds) [edit on github]

Queries the service and returns a table object.

Serves the same purpose as astroquery.vizier.Vizier.query_object but only returns the HTTP response rather than the parsed result.

Parameters :

object_name : str

The name of the identifier.

catalog : str or list, optional

The catalog(s) which must be searched for this identifier. If not specified, all matching catalogs will be searched.

Returns :

An `astropy.table.Table` object :

static query_object_async(*args, **kwds)[source] [edit on github]

Serves the same purpose as astroquery.vizier.Vizier.query_object but only returns the HTTP response rather than the parsed result.

Parameters :

object_name : str

The name of the identifier.

catalog : str or list, optional

The catalog(s) which must be searched for this identifier. If not specified, all matching catalogs will be searched.

Returns :

response : requests.Response object

The response of the HTTP request.

static query_region(*args, **kwds) [edit on github]

Queries the service and returns a table object.

Serves the same purpose as astroquery.vizier.Vizier.query_region but only returns the HTTP response rather than the parsed result.

Parameters :

coordinates : str or astropy.coordinates object

The target around which to search. It may be specified as a string in which case it is resolved using online services or as the appropriate astropy.coordinates object. ICRS coordinates may also be entered as a string.

radius : str or astropy.units.Quantity object

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

width : str or astropy.units.Quantity object.

Must be specified for a box region. Has the same format as radius above.

height : str or astropy.units.Quantity object.

Must be specified with the width for a box region that is a rectangle. Has the same format as radius above.

catalog : str or list, optional

The catalog(s) which must be searched for this identifier. If not specified, all matching catalogs will be searched.

Returns :

An `astropy.table.Table` object :

static query_region_async(*args, **kwds)[source] [edit on github]

Serves the same purpose as astroquery.vizier.Vizier.query_region but only returns the HTTP response rather than the parsed result.

Parameters :

coordinates : str or astropy.coordinates object

The target around which to search. It may be specified as a string in which case it is resolved using online services or as the appropriate astropy.coordinates object. ICRS coordinates may also be entered as a string.

radius : str or astropy.units.Quantity object

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

width : str or astropy.units.Quantity object.

Must be specified for a box region. Has the same format as radius above.

height : str or astropy.units.Quantity object.

Must be specified with the width for a box region that is a rectangle. Has the same format as radius above.

catalog : str or list, optional

The catalog(s) which must be searched for this identifier. If not specified, all matching catalogs will be searched.

Returns :

response : requests.Response object

The response of the HTTP request.

Page Contents