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 |