conesearch¶
-
astroquery.vo_conesearch.conesearch.
conesearch
(center, radius, verb=1, catalog_db=None, pedantic=None, verbose=True, cache=True, timeout=None, query_all=False)[source]¶ Perform Cone Search and returns the result of the first successful query.
Parameters: center : str,
astropy.coordinates
object, list, or tuplePosition of the center of the cone to search. It may be specified as an object from the astropy:astropy-coordinates package, string as accepted by
parse_coordinates()
, or tuple/list. If given as tuple or list, it is assumed to be(RA, DEC)
in the ICRS coordinate frame, given in decimal degrees.radius : float or
Quantity
Radius of the cone to search:
- If float is given, it is assumed to be in decimal degrees.
- If astropy quantity is given, it is internally converted to degrees.
verb : {1, 2, 3}
Verbosity indicating how many columns are to be returned in the resulting table. Support for this parameter by a Cone Search service implementation is optional. If the service supports the parameter:
- Return the bare minimum number of columns that the provider considers useful in describing the returned objects.
- Return a medium number of columns between the minimum and maximum (inclusive) that are considered by the provider to most typically useful to the user.
- Return all of the columns that are available for describing the objects.
If not supported, the service should ignore the parameter and always return the same columns for every request.
catalog_db
May be one of the following, in order from easiest to use to most control:
None
: A database ofastroquery.vo_conesearch.conf.conesearch_dbname
catalogs is downloaded fromastroquery.vo_conesearch.conf.vos_baseurl
. The first catalog in the database to successfully return a result is used.- catalog name: A name in the database of
astroquery.vo_conesearch.conf.conesearch_dbname
catalogs atastroquery.vo_conesearch.conf.vos_baseurl
is used. For a list of acceptable names, useastroquery.vo_conesearch.vos_catalog.list_catalogs()
. - url: The prefix of a URL to a IVOA Service for
astroquery.vo_conesearch.conf.conesearch_dbname
. Must end in either ‘?’ or ‘&’. VOSCatalog
object: A specific catalog manually downloaded and selected from the database (see General VO Services Access).- Any of the above 3 options combined in a list, in which case they are tried in order.
pedantic : bool or
None
When
True
, raise an error when the result violates the spec, otherwise issue a warning. Warnings may be controlled usingwarnings
module. When not provided, uses the configuration settingastroquery.vo_conesearch.conf.pedantic
, which defaults toFalse
.verbose : bool
Verbose output.
cache : bool
Use caching for VO Service database. Access to actual VO websites referenced by the database still needs internet connection.
timeout : number or
None
Timeout limit in seconds for each service being queries. If
None
, use default.query_all : bool
This is used by
search_all()
.Returns: obj :
astropy.io.votable.tree.Table
First table from first successful VO service request.
Raises: ConeSearchError
When invalid inputs are passed into Cone Search.
VOSError
If VO service request fails.