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`	A setting and associated value stored in the astropy configuration files.
`VIZIER_SERVER`	A setting and associated value stored in the astropy configuration files.
`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 = <ConfigurationItem: name='timeout' value=60 at 0x5fd8cd0>¶

VIZIER_SERVER = <ConfigurationItem: name='vizier_server' value='vizier.u-strasbg.fr' at 0x5fd8c50>¶

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.

Navigation

Vizier¶

Page Contents