call_vo_service¶
-
astropy.vo.client.vos_catalog.
call_vo_service
(service_type, catalog_db=None, pedantic=None, verbose=True, cache=True, kwargs={})[source] [edit on github]¶ Makes a generic VO service call.
Parameters: service_type : str
Name of the type of service, e.g., ‘conesearch_good’. Used in error messages and to select a catalog database if
catalog_db
is not provided.catalog_db
May be one of the following, in order from easiest to use to most control:
None
: A database ofservice_type
catalogs is downloaded fromastropy.vo.Conf.vos_baseurl
. The first catalog in the database to successfully return a result is used.- catalog name: A name in the database of
service_type
catalogs atastropy.vo.Conf.vos_baseurl
is used. For a list of acceptable names, uselist_catalogs()
. - url: The prefix of a URL to a IVOA Service for
service_type
. 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 file violates the spec, otherwise issue a warning. Warnings may be controlled usingwarnings
module. When not provided, uses the configuration settingastropy.io.votable.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.
kwargs : dictionary
Keyword arguments to pass to the catalog service. No checking is done that the arguments are accepted by the service, etc.
Returns: obj :
astropy.io.votable.tree.Table
First table from first successful VO service request.
Raises: VOSError
If VO service request fails.