astroquery/vo_conesearch/core.py
def query_region(self, coordinates, radius, *, verb=1,
                     get_query_payload=False, cache=True, verbose=False,
                     service_url=None, return_astropy_table=True,
                     use_names_over_ids=False):
        """
        Perform Cone Search and returns the result of the
        first successful query.

        Parameters
        ----------
        coordinates : str, `astropy.coordinates` object, list, or tuple
            Position of the center of the cone to search.
            It may be specified as an object from the
            :ref:`astropy:astropy-coordinates` package,
            string as accepted by
            :func:`~astroquery.utils.parse_coordinates`, or tuple/list.
            If given as tuple or list, 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.units.quantity.Quantity` is given,
                  it is internally converted to degrees.

        verb : {1, 2, 3}, optional
            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.

        get_query_payload : bool, optional
            Just return the dict of HTTP request parameters.

        cache : bool, optional
            Use caching for VO Service database. Access to actual VO
            websites referenced by the database still needs internet
            connection.

        verbose : bool, optional
            Verbose output, including VO table warnings.

        service_url : str or `None`
            URL for the Cone Search service. If not given, will use
            ``fallback_url`` from ``vo_conesearch`` configuration.

        return_astropy_table : bool
            Returned ``result`` will be `astropy.table.Table` rather
            than `astropy.io.votable.tree.Table`.

        use_names_over_ids : bool
            When `True` use the ``name`` attributes of columns as the names
            of columns in the `~astropy.table.Table` instance.  Since names
            are not guaranteed to be unique, this may cause some columns
            to be renamed by appending numbers to the end.  Otherwise
            (default), use the ID attributes as the column names.

        Returns
        -------
        result : `astropy.table.Table` or `astropy.io.votable.tree.Table`
            Table from successful VO service request.
            See ``return_astropy_table`` option for the kind of table returned.

        """
        request_payload = self._args_to_payload(coordinates, radius, verb)

        if get_query_payload:
            return request_payload

        url = _validate_url(service_url)
        response = self._request('GET', url, params=request_payload,
                                 timeout=conf.timeout, cache=cache)
        result = self._parse_result(response, url, pars=request_payload,
                                    verbose=verbose)

        # Convert to an astropy.table.Table object
        if result is not None and return_astropy_table:
            result = result.to_table(use_names_over_ids=use_names_over_ids)
            result.url = url  # To be consistent with votable option

        return result

        Perform Cone Search and returns the result of the
        first successful query.

        Parameters
        ----------
        coordinates : str, `astropy.coordinates` object, list, or tuple
            Position of the center of the cone to search.
            It may be specified as an object from the
            :ref:`astropy:astropy-coordinates` package,
            string as accepted by
            :func:`~astroquery.utils.parse_coordinates`, or tuple/list.
            If given as tuple or list, 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.units.quantity.Quantity` is given,
                  it is internally converted to degrees.

        verb : {1, 2, 3}, optional
            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.

        get_query_payload : bool, optional
            Just return the dict of HTTP request parameters.

        cache : bool, optional
            Use caching for VO Service database. Access to actual VO
            websites referenced by the database still needs internet
            connection.

        verbose : bool, optional
            Verbose output, including VO table warnings.

        service_url : str or `None`
            URL for the Cone Search service. If not given, will use
            ``fallback_url`` from ``vo_conesearch`` configuration.

        return_astropy_table : bool
            Returned ``result`` will be `astropy.table.Table` rather
            than `astropy.io.votable.tree.Table`.

        use_names_over_ids : bool
            When `True` use the ``name`` attributes of columns as the names
            of columns in the `~astropy.table.Table` instance.  Since names
            are not guaranteed to be unique, this may cause some columns
            to be renamed by appending numbers to the end.  Otherwise
            (default), use the ID attributes as the column names.

        Returns
        -------
        result : `astropy.table.Table` or `astropy.io.votable.tree.Table`
            Table from successful VO service request.
            See ``return_astropy_table`` option for the kind of table returned.

        
Perform Cone Search and returns the result of the
first successful query.

Parameters

coordinates : str, `astropy.coordinates` object, list, or tuple
Position of the center of the cone to search.

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.units.quantity.Quantity` is given,
it is internally converted to degrees.

verb : {1, 2, 3}, optional
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.

get_query_payload : bool, optional
Just return the dict of HTTP request parameters.

cache : bool, optional
Use caching for VO Service database. Access to actual VO
websites referenced by the database still needs internet
connection.

verbose : bool, optional
Verbose output, including VO table warnings.

service_url : str or `None`
URL for the Cone Search service.





Returns

result : `astropy.table.Table` or `astropy.io.votable.tree.Table`
Table from successful VO service request.
See ``return_astropy_table`` option for the kind of table returned.
Perform Cone Search and returns the result of the first successful query . Parameters coordinates : str ` astropy . coordinates ` object list or tuple Position of the center of the cone to search . 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 . units . quantity . Quantity ` is given it is internally converted to degrees . verb : { 1 2 3 } optional 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 . get_query_payload : bool optional Just return the dict of HTTP request parameters . cache : bool optional Use caching for VO Service database . Access to actual VO websites referenced by the database still needs internet connection . verbose : bool optional Verbose output including VO table warnings . service_url : str or ` None ` URL for the Cone Search service . Returns result : ` astropy . table . Table ` or ` astropy . io . votable . tree . Table ` Table from successful VO service request . See ` ` return_astropy_table ` ` option for the kind of table returned .
def query_region(self, coordinates, radius, *, verb=1,
                     get_query_payload=False, cache=True, verbose=False,
                     service_url=None, return_astropy_table=True,
                     use_names_over_ids=False):
        request_payload = self._args_to_payload(coordinates, radius, verb)
        if get_query_payload:
            return request_payload
        url = _validate_url(service_url)
        response = self._request('GET', url, params=request_payload,
                                 timeout=conf.timeout, cache=cache)
        result = self._parse_result(response, url, pars=request_payload,
                                    verbose=verbose)
        if result is not None and return_astropy_table:
            result = result.to_table(use_names_over_ids=use_names_over_ids)
            result.url = url  
        return result
def query_region ( self , coordinates , radius , * , verb = 1 , get_query_payload = False , cache = True , verbose = False , service_url = None , return_astropy_table = True , use_names_over_ids = False ) : request_payload = self . _args_to_payload ( coordinates , radius , verb ) if get_query_payload : return request_payload url = _validate_url ( service_url ) response = self . _request ( 'GET' , url , params = request_payload , timeout = conf . timeout , cache = cache ) result = self . _parse_result ( response , url , pars = request_payload , verbose = verbose ) if result is not None and return_astropy_table : result = result . to_table ( use_names_over_ids = use_names_over_ids ) result . url = url return result
Perform Cone Search and returns the result of the
first successful query.
Perform Cone Search and returns the result of the first successful query .
"""
        Perform Cone Search and returns the result of the
        first successful query.

        Parameters
        ----------
        coordinates : str, `astropy.coordinates` object, list, or tuple
            Position of the center of the cone to search.
            It may be specified as an object from the
            :ref:`astropy:astropy-coordinates` package,
            string as accepted by
            :func:`~astroquery.utils.parse_coordinates`, or tuple/list.
            If given as tuple or list, 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.units.quantity.Quantity` is given,
                  it is internally converted to degrees.

        verb : {1, 2, 3}, optional
            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.

        get_query_payload : bool, optional
            Just return the dict of HTTP request parameters.

        cache : bool, optional
            Use caching for VO Service database. Access to actual VO
            websites referenced by the database still needs internet
            connection.

        verbose : bool, optional
            Verbose output, including VO table warnings.

        service_url : str or `None`
            URL for the Cone Search service. If not given, will use
            ``fallback_url`` from ``vo_conesearch`` configuration.

        return_astropy_table : bool
            Returned ``result`` will be `astropy.table.Table` rather
            than `astropy.io.votable.tree.Table`.

        use_names_over_ids : bool
            When `True` use the ``name`` attributes of columns as the names
            of columns in the `~astropy.table.Table` instance.  Since names
            are not guaranteed to be unique, this may cause some columns
            to be renamed by appending numbers to the end.  Otherwise
            (default), use the ID attributes as the column names.

        Returns
        -------
        result : `astropy.table.Table` or `astropy.io.votable.tree.Table`
            Table from successful VO service request.
            See ``return_astropy_table`` option for the kind of table returned.

        """ # Convert to an astropy.table.Table object # To be consistent with votable option
self
coordinates
radius
verb
get_query_payload
cache
verbose
service_url
return_astropy_table
use_names_over_ids