The pyvo.namesolver Package

Note

the Astropy package provides object-to-position resolution (see Object Name Resolution: Finding Positions of Sources for an example), so future versions of PyVO will migrate to use the Astropy implementation. Thus, the pyvo.nameresolver module will be deprecated.

Direct support for Astropy coordinate types by the data access services is also planned for future versions of PyVO.

The support for the CDS Sesame Service within the pyvo.nameresolver.sesame will be evolved appropriately for accessing other source information available from the service.

The current default implementation available in the pyvo.nameresolver module is that provided by the sesame sub-module.

pyvo.nameresolver.sesame Module

The CDS Sesame service interface. This service provides basic information about sources–most importantly, its position in the sky–given any of their official names. One can resolve names into J2000 positions via the functions object2pos() (returning R.A.-Dec. decimal tuples) and object2sexapos() (returning positions formated into sexagesimal strings). More metadata about the source is available via the resolve() function.

Full access to the Sesame service capabilities (documented at http://cdsweb.u-strasbg.fr/doc/sesame.htx) is available via the SesameQuery class. Sesame can consult three object databases: Simbad, NED, and Vizier; Simbad is consulted by default.

The Sesame service is mirrored at multiple locations; the service endpoints are listed in this module the endpoints dictionary where the keys are short labels indicating the location. The default one that will be used is given by the symbol default_endpoint. The function set_default_endpoint() will set the default endpoint given its name.

Functions

resolve(names[, db, include, mirror]) resolve one or more object names each to an ObjectData
object2pos(names[, db, mirror]) resolve one or more object names each to a position.
object2sexapos(names[, db, mirror]) resolve one or more object names each to a sesagesimal-formatted
set_default_endpoint(name) set the endpoint for the sesame service that will be used by default

Classes

SesameQuery([baseurl]) a class for preparing a query to a sesame service. Query constraints
ObjectData(etreeEl) a container for the target metadata returned from a resolver. The

Class Inheritance Diagram

digraph inheritance2ce86df422 { rankdir=LR; size="8.0, 12.0"; "ObjectData" [URL="../../api/pyvo.nameresolver.sesame.ObjectData.html#pyvo.nameresolver.sesame.ObjectData",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a container for the target metadata returned from a resolver. The "]; "SesameQuery" [URL="../../api/pyvo.nameresolver.sesame.SesameQuery.html#pyvo.nameresolver.sesame.SesameQuery",fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5)",target="_top",tooltip="a class for preparing a query to a sesame service. Query constraints "]; }