a ߙfb@sdZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl mZddlmZmZddlmZd gZGd d d eZGd d d eZGdddeZddZddd ZdS)an This module contains convenience functions for getting a coordinate object for a named object by querying SESAME and getting the first returned result. Note that this is intended to be a convenience, and is very simple. If you need precise coordinates for an object you should find the appropriate reference for that measurement and input the coordinates manually. N)units)SkyCoord)data) download_fileget_file_contents) ScienceStateget_icrs_coordinatesc@s$eZdZdZddgZeddZdS) sesame_urlz8 The URL(s) to Sesame's web-queryable database. z.http://cdsweb.u-strasbg.fr/cgi-bin/nph-sesame/z1http://vizier.cfa.harvard.edu/viz-bin/nph-sesame/cCs|S)Nclsvaluer r ?lib/python3.9/site-packages/astropy/coordinates/name_resolve.pyvalidate$szsesame_url.validateN__name__ __module__ __qualname____doc__Z_value classmethodrr r r rr s r c@s eZdZdZdZeddZdS)sesame_databasez This specifies the default database that SESAME will query when using the name resolve mechanism in the coordinates subpackage. Default is to search all databases, but this can be 'all', 'simbad', 'ned', or 'vizier'. allcCs|dvrtd|d|S)N)rZsimbadZnedZvizierzUnknown database '') ValueErrorr r r rr3szsesame_database.validateNrr r r rr*src@s eZdZdS)NameResolveErrorN)rrrr r r rr:srcCs8td}||}|dur dS|\}}||fSdS)a Given a string response from SESAME, parse out the coordinates by looking for a line starting with a J, meaning ICRS J2000 coordinates. Parameters ---------- resp_data : str The string HTTP response from SESAME. Returns ------- ra : str The string Right Ascension parsed from the HTTP response. dec : str The string Declination parsed from the HTTP response. z %J\s*([0-9\.]+)\s*([\+\-\.0-9]+)N)NN)recompilesearchgroups) resp_dataZpattrZmatchedradecr r r_parse_response>s    r#Fc Cs|r$ddlm}||r$||St}|d}g}g}tD]R}tj |j } | |vrH| | t j|d} | jtj ||d} | | qHg} |D]}ztt||dd} WqWqtjjy} z"| | WYd} ~ qWYd} ~ qd} ~ 0tjyV} z6d tjjd d | _| | WYd} ~ qWYd} ~ qd} ~ 00qd d t|| D}tdt j|t| \}}|dus|dur|dkrd|d|}nd|d|d|}t|t ||t!j"t!j"fdd}|S)a Retrieve an ICRS object by using an online name resolving service to retrieve coordinates for the specified name. By default, this will search all available databases until a match is found. If you would like to specify the database, use the science state ``astropy.coordinates.name_resolve.sesame_database``. You can also specify a list of servers to use for querying Sesame using the science state ``astropy.coordinates.name_resolve.sesame_url``. This will try each one in order until a valid response is returned. By default, this list includes the main Sesame host and a mirror at vizier. The configuration item `astropy.utils.data.Conf.remote_timeout` controls the number of seconds to wait for a response from the server before giving up. Parameters ---------- name : str The name of the object to get coordinates for, e.g. ``'M42'``. parse : bool Whether to attempt extracting the coordinates from the name by parsing with a regex. For objects catalog names that have J-coordinates embedded in their names eg: 'CRTS SSS100805 J194428-420209', this may be much faster than a sesame query for the same object name. The coordinates extracted in this way may differ from the database coordinates by a few deci-arcseconds, so only use this option if you do not need sub-arcsecond accuracy for coordinates. cache : bool, str, optional Determines whether to cache the results or not. Passed through to `~astropy.utils.data.download_file`, so pass "update" to update the cached value. Returns ------- coord : `astropy.coordinates.ICRS` object The object's coordinates in the ICRS frame. r)jparserrz {db}?{name})namedbF)cacheZ show_progressNz%Request took longer than the allowed z.1fz secondscSs g|]\}}|d|jqS)z: )reason).0urler r r sz(get_icrs_coordinates..zWAll Sesame queries failed. Unable to retrieve coordinates. See errors per URL below: Az%Unable to find coordinates for name 'z' using z' in database z using Zicrs)r!r"Zunitframe)#r$rZ to_skycoordrgetupperr urllibparseZurlparseZnetlocappendospathjoinformatZquoterrerrorZURLErrorsocketZtimeoutrZconfZremote_timeoutr(ziprlinesepr#ruZdegree)r%r3r'r$Zdatabaser&ZurlsZdomainsr*ZdomainZfmt_url exceptionsr r+Zmessagesr!r"errZscr r rr ZsZ*             $   )FF)rr5rr:Zurllib.requestr2Z urllib.parseZ urllib.errorZastropyrr=Zsky_coordinaterZ astropy.utilsrZastropy.utils.datarrZastropy.utils.stater__all__r r Exceptionrr#r r r r rs"