Skip to main content

Functions and classes to access online astronomical data resources

Project description

Documentation | Blog | View on Github | Download Stable ZIP | Download Stable TAR

Latest PyPI version Documentation Status Github Actions CI Status Coverage results Zenodo

Accessing Online Astronomical Data

Astroquery is an astropy affiliated package that contains a collection of tools to access online Astronomical data. Each web service has its own sub-package. For example, to interface with the SIMBAD website, use the simbad sub-package:

>>> from astroquery.simbad import Simbad
>>> theta1c = Simbad.query_object('tet01 Ori C')
>>> theta1c.pprint()
   main_id          ra           dec      ... coo_wavelength     coo_bibcode       matched_id
                   deg           deg      ...
------------- ------------- ------------- ... -------------- ------------------- -------------
* tet01 Ori C 83.8186095697 -5.3897005033 ...              O 2020yCat.1350....0G * tet01 Ori C

Installation and Requirements

Astroquery works with Python 3.7 or later. As an astropy affiliate, astroquery requires astropy version 4.2.1 or later.

astroquery uses the requests module to communicate with the internet. BeautifulSoup and html5lib’ are needed for HTML parsing for some services. The keyring module is also required for accessing services that require a login. These can all be installed using pip or anaconda. Running the tests requires curl to be installed.

The latest version of astroquery can be pip installed (note the --pre for picking up released developer versions, and -U for upgrade):

$ python -m pip install -U --pre astroquery

To install all the mandatory and optional dependencies add the [all] identifier to the pip command above (or use [docs] or [test] for the dependencies required to build the documentation or run the tests):

$ python -m pip install -U --pre astroquery[all]

To install the ‘bleeding edge’ version:

$ python -m pip install git+https://github.com/astropy/astroquery.git

or cloned and installed from source:

$ # If you have a github account:
$ git clone git@github.com:astropy/astroquery.git
$ # If you do not:
$ git clone https://github.com/astropy/astroquery.git
$ cd astroquery
$ python -m pip install .

Using astroquery

Importing astroquery on its own doesn’t get you much: you need to import each sub-module specifically. See the documentation for a list of Available Services. The API shows the standard suite of tools common to most modules, e.g. query_object and query_region.

To report bugs and request features, please use the issue tracker. Code contributions are very welcome, though we encourage you to follow the API and contributing guidelines as much as possible.

Citing Astroquery

If you use astroquery, please cite the paper we published in The Astronomical Journal.

The BibTeX entry is available from the package itself:

import astroquery
astroquery.__citation__

In addition you may also want to refer to specific versions of the package. We create a separate Zenodo DOI for each version, they can be looked up at the following Zenodo page

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

astroquery-0.4.8.dev9474.tar.gz (6.6 MB view details)

Uploaded Source

Built Distribution

astroquery-0.4.8.dev9474-py3-none-any.whl (5.4 MB view details)

Uploaded Python 3

File details

Details for the file astroquery-0.4.8.dev9474.tar.gz.

File metadata

  • Download URL: astroquery-0.4.8.dev9474.tar.gz
  • Upload date:
  • Size: 6.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.11.3 pkginfo/1.7.0 requests/2.28.2 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.1

File hashes

Hashes for astroquery-0.4.8.dev9474.tar.gz
Algorithm Hash digest
SHA256 1112a3b761c9dc581b0ed88213aa045ead00914eb1186d9f3a5c1a15551fe82d
MD5 8fc985d70001af01b37839e6f792820e
BLAKE2b-256 a62871ea91ccef3b09f79cfaefd80194fbad9422d3541792585b7ae477ca75af

See more details on using hashes here.

File details

Details for the file astroquery-0.4.8.dev9474-py3-none-any.whl.

File metadata

  • Download URL: astroquery-0.4.8.dev9474-py3-none-any.whl
  • Upload date:
  • Size: 5.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.11.3 pkginfo/1.7.0 requests/2.28.2 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.1

File hashes

Hashes for astroquery-0.4.8.dev9474-py3-none-any.whl
Algorithm Hash digest
SHA256 683f3d58fefb0501cbdaa2525a64225a7641266f9b2f609ec49f4761328a3ce0
MD5 1791c1c4f6ff8ff6da9c62bc2904176c
BLAKE2b-256 bccb97e6e8e7d003c08a8732711651723f38bf8ff7dc9862b32582359b36c673

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page