astro py:docs

- Index
- Modules

### Navigation

- next »
- « previous |
- Astropy v0.3 »
- Virtual Observatory Access (`astropy.vo`) »
- VO Simple Cone Search »
- call_vo_service

# call_vo_service

`astropy.vo.client.vos_catalog.``call_vo_service`(service_type, catalog_db=None, pedantic=None, verbose=True, cache=True, kwargs={})

  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 of `service_type` catalogs is downloaded from `astropy.vo.client.vos_catalog.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 at `astropy.vo.client.vos_catalog.BASEURL` is used. For a list of acceptable names, use `list_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 using `warnings` module. When not provided, uses the configuration setting `astropy.io.votable.table.PEDANTIC`, which defaults to `False`.

  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` object

  > First table from first successful VO service request.

  Raises:

  VOSError :

  > If VO service request fails.