σ ›ίΘ[c@`s0dZddlmZmZmZmZddlZddlZddl m Z ddl m Z ddl mZmZdd l mZdd lmZmZmZmZmZdd lmZdd lmZmZdd lmZddlmZddl m!Z!dddddddgZ"ddgZ#edddƒde fd„ƒYƒZ$edddƒdd„ƒZ%edddƒde fd „ƒYƒZ&eddd!ƒd"„ƒZ'eddd#ƒd$„ƒZ(eddd%ƒd&„ƒZ)eddd'ƒedƒd(„ƒƒZ*d)„Z+d*„Z,d+„Z-dS(,u+Support VO Simple Cone Search capabilities.i(tabsolute_importtdivisiontprint_functiontunicode_literalsNi(t vos_catalog(t AsyncBase(tConeSearchErrortVOSErrori(tunits(tICRStBaseCoordinateFramet LongitudetLatitudetSkyCoord(tQuantity(ttimefunctRunTimePredictor(tAstropyUserWarning(t deprecated(tdatauAsyncConeSearchu conesearchuAsyncSearchAllu search_allu list_catalogsupredict_searchuconesearch_timeru2.0t alternativeu3astroquery.vo_conesearch.conesearch.AsyncConeSearchtAsyncConeSearchcB`seZdZd„ZRS(uρPerform a Cone Search asynchronously and returns the result of the first successful query. .. note:: See `~astropy.vo.client.vo_async.AsyncBase` for more details. Parameters ---------- args, kwargs : see :func:`conesearch` Examples -------- >>> from astropy import coordinates as coord >>> from astropy import units as u >>> c = coord.ICRS(6.0223 * u.degree, -72.0814 * u.degree) >>> async_search = conesearch.AsyncConeSearch( ... c, 0.5 * u.degree, ... catalog_db='The PMM USNO-A1.0 Catalogue (Monet 1997) 1') Check search status: >>> async_search.running() True >>> async_search.done() False Get search results after a 30-second wait (not to be confused with `astropy.utils.data.Conf.remote_timeout` that governs individual Cone Search queries). If search is still not done after 30 seconds, `TimeoutError` is raised. Otherwise, Cone Search result is returned and can be manipulated as in :ref:`Simple Cone Search Examples `. If no ``timeout`` keyword given, it waits until completion: >>> async_result = async_search.get(timeout=30) >>> cone_arr = async_result.array.data >>> cone_arr.size 36184 cO`s tt|ƒjt||ŽdS(N(tsuperRt__init__t conesearch(tselftargstkwargs((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pyRNs(t__name__t __module__t__doc__R(((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pyR"s+u.astroquery.vo_conesearch.conesearch.conesearchc K`s“ddlm}t|ƒ\}}t|ƒ}tt|ƒ}|d krXtdƒ‚ni|d6|d6|d6|d 6}tj|j d ||S( uβ Perform Cone Search and returns the result of the first successful query. Parameters ---------- center : `~astropy.coordinates.SkyCoord`, `~astropy.coordinates.BaseCoordinateFrame`, or sequence of length 2 Position of the center of the cone to search. It may be specified as an object from the :ref:`astropy-coordinates` package, or as a length 2 sequence. If a sequence, it is assumed to be ``(RA, DEC)`` in the ICRS coordinate frame, given in decimal degrees. radius : float or `~astropy.units.quantity.Quantity` Radius of the cone to search: - If float is given, it is assumed to be in decimal degrees. - If astropy quantity is given, it is internally converted to degrees. verb : {1, 2, 3} Verbosity indicating how many columns are to be returned in the resulting table. Support for this parameter by a Cone Search service implementation is optional. If the service supports the parameter: 1. Return the bare minimum number of columns that the provider considers useful in describing the returned objects. 2. Return a medium number of columns between the minimum and maximum (inclusive) that are considered by the provider to most typically useful to the user. 3. Return all of the columns that are available for describing the objects. If not supported, the service should ignore the parameter and always return the same columns for every request. catalog_db May be one of the following, in order from easiest to use to most control: - `None`: A database of `astropy.vo.Conf.conesearch_dbname` catalogs is downloaded from `astropy.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 `astropy.vo.Conf.conesearch_dbname` catalogs at `astropy.vo.Conf.vos_baseurl` is used. For a list of acceptable names, use :func:`list_catalogs`. - *url*: The prefix of a URL to a IVOA Service for `astropy.vo.Conf.conesearch_dbname`. Must end in either '?' or '&'. - `~astropy.vo.client.vos_catalog.VOSCatalog` object: A specific catalog manually downloaded and selected from the database (see :ref:`vo-sec-client-vos`). - 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 :py:mod:`warnings` module. When not provided, uses the configuration setting `astropy.io.votable.Conf.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. Returns ------- obj : `astropy.io.votable.tree.Table` First table from first successful VO service request. Raises ------ ConeSearchError When invalid inputs are passed into Cone Search. VOSError If VO service request fails. i(tconfiiuVerbosity must be 1, 2, or 3uRAuDECuSRuVERBR(iii( tRt_validate_coordt _validate_srt_local_conversiontintRRtcall_vo_servicetconesearch_dbname( tcentertradiustverbRRtratdectsrR((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pyRRs_  "u2astroquery.vo_conesearch.conesearch.AsyncSearchAlltAsyncSearchAllcB`seZdZd„ZRS(uPerform a Cone Search asynchronously, storing all results instead of just the result from first successful query. .. note:: See `~astropy.vo.client.vo_async.AsyncBase` for more details. Parameters ---------- args, kwargs : see :func:`search_all` Examples -------- >>> from astropy import coordinates as coord >>> from astropy import units as u >>> c = coord.ICRS(6.0223 * u.degree, -72.0814 * u.degree) >>> async_search = conesearch.AsyncSearchAll(c, 0.5 * u.degree) Check search status: >>> async_search.running() True >>> async_search.done() False Get a dictionary of all search results after a 30-second wait (not to be confused with `astropy.utils.data.Conf.remote_timeout` that governs individual Cone Search queries). If search is still not done after 30 seconds, `TimeoutError` is raised. Otherwise, a dictionary is returned and can be manipulated as in :ref:`Simple Cone Search Examples `. If no ``timeout`` keyword given, it waits until completion: >>> async_allresults = async_search.get(timeout=30) >>> all_catalogs = list(async_allresults) >>> first_cone_arr = async_allresults[all_catalogs[0]].array.data >>> first_cone_arr.size 36184 cO`stj|t||ŽdS(N(RRt search_all(RRR((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pyRοs(RRRR(((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pyR-Δs*u.astroquery.vo_conesearch.conesearch.search_allc O`sήddlm}i}|jdd ƒ}d|krD|jdƒn|jdtƒ}|jdtƒ}tj|j|d|d|ƒ}xN|D]F\}} yt d| ||Ž} Wnt k rΘqX| || j `_. The predicted results are just *rough* estimates. Prediction is done using :func:`conesearch`. Prediction for `AsyncConeSearch` is not supported. Parameters ---------- url : str Cone Search access URL to use. args, kwargs : see :func:`conesearch` Extra keyword ``plot`` is allowed and only used by this function and not :func:`conesearch`. Returns ------- t_est : float Estimated time in seconds needed for the search. n_est : int Estimated number of objects the search will yield. Raises ------ AssertionError If prediction fails. ConeSearchError If input parameters are invalid. VOSError If VO service request fails. iu(conesearch must have exactly 2 argumentsuplotiu!Search radius must be > 0 degreesu catalog_dbi gš™™™™™©?gΰ?gπ?iu;Estimated runtime ({0} s) is non-physical with slope of {1}u1Estimated runtime is longer than timeout of {0} su:Estimated #objects ({0}) is non-physical with slope of {1}Nu radius (deg)t xlabeltextukx-tlabeluActualub--uFittmarkeruotcuru Predictedu#objectstlocubestt numpoints(%tlenRR2tFalseR"RRtnptaranget time_functdo_fitt predict_timetwarningstwarntformatRRRtremote_timeouttsortedtresultstarraytsizetpolyfittpoly1dR$troundtmatplotlib.pyplottpyplottappendtplottsubplotstscattert set_xlabelt set_ylabeltlegendtdraw(R7RRRYR'R(R,tcs_predtnum_datapointstsr_mintsr_maxtsr_steptsr_arrtt_coeffstt_esttkeytn_arrtn_coeffst n_fitfunctn_esttpltR>tsr_fittn_fittfigtax((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pytpredict_searchOsdA          &  (   u4astroquery.vo_conesearch.conesearch.conesearch_timercO`s t||ŽS(ueTime a single Cone Search using `astropy.utils.timer.timefunc` with a single try and a verbose timer. Parameters ---------- args, kwargs : see :func:`conesearch` Returns ------- t : float Run time in seconds. obj : `astropy.io.votable.tree.Table` First table from first successful VO service request. (R(RR((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pytconesearch_timerΦscC`s@y||ƒ}Wn%tk r7}tt|ƒƒ‚nX|SdS(uFTry ``func(x)`` and replace `ValueError` with ``ConeSearchError``.N(t ValueErrorRtstr(tfunctxtyte((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pyR#νs cC`st|tƒr$|jtƒj}nVt|tƒrE|jtƒ}n5tt|ddtjƒt |ddtjƒƒ}|j j|j jfS(uValidate coordinates.ituniti( t isinstanceR t transform_toR tframeR R tutdegreeR R*R+(R't icrscoord((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pyR!ψscC`s8t|tƒr$|jtjƒ}n |tj}|jS(uValidate search radius.(R{RttoR~Rtvalue(R(tsr_angle((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pyR"s (.Rt __future__RRRRRKtnumpyRFR Rtvo_asyncRt exceptionsRRRR~t coordinatesR R R R R Rt utils.timerRRtutils.exceptionsRtutils.decoratorsRtutilsRt__all__t__doctest_skip__RRR-R.R=RrRsR#R!R"(((s;lib/python2.7/site-packages/astropy/vo/client/conesearch.pytsJ"  (  . p-5%†