Astroquery

Astroquery
Name	Astroquery
Developer	Astropy Project
Released	2013
Programming language	Python
Operating system	Cross-platform
License	BSD-3-Clause

Astroquery is an open-source Python library that provides a common interface to access astronomical web services, catalogues, and archives programmatically. It is commonly used by researchers at institutions such as European Southern Observatory, Space Telescope Science Institute, Max Planck Society, and National Aeronautics and Space Administration centers to retrieve data from projects like Sloan Digital Sky Survey, Gaia, and Hubble Space Telescope. Designed to interoperate with the Astropy Project ecosystem, it streamlines workflows involving services from European Space Agency, National Radio Astronomy Observatory, and survey archives including Two Micron All-Sky Survey and Pan-STARRS.

Overview

Astroquery exposes a uniform client API allowing astronomers to query heterogeneous services such as observatory archives, mission databases, and virtual observatory endpoints. Typical use cases include programmatic retrieval of spectra from European Southern Observatory archives, catalog cross-matching involving Gaia and Sloan Digital Sky Survey, and image cutouts from surveys like Pan-STARRS and Two Micron All-Sky Survey. The project is maintained within the broader scientific software community surrounding Astropy Project and is frequently cited in publications produced by teams at Harvard–Smithsonian Center for Astrophysics, Max Planck Institute for Astronomy, and university groups that rely on reproducible data access.

Architecture and Design

The design centers on modular provider-specific modules implemented in Python and integrated with utility features from Astropy Project such as unit handling and coordinate representations. A core set of base classes defines request and response patterns, authentication hooks, and caching strategies that mirror standards used by services at NASA/IPAC Infrared Science Archive, European Space Agency, and the International Virtual Observatory Alliance. Error handling follows patterns familiar to developers using Python (programming language) libraries, while the client implementations take into account service-specific protocols including HTTP GET/POST, RESTful APIs used by Sloan Digital Sky Survey, and legacy query interfaces exposed by facilities like UKIRT and National Radio Astronomy Observatory.

Extensibility is provided via a plugin-style layout: each module encapsulates the interaction with a single external provider such as Hubble Space Telescope or Gaia, with shared utilities for parsing tables provided by libraries commonly used by groups at California Institute of Technology and Massachusetts Institute of Technology. The architecture supports session persistence, rate-limiting accommodations for major facilities including European Southern Observatory and Space Telescope Science Institute, and optional integration with authentication frameworks like those at NASA and European Space Agency.

Supported Services and Modules

Astroquery maintains modules for a broad set of astronomical services spanning survey archives, mission science archives, and catalog services. Prominent modules interface with Sloan Digital Sky Survey, Gaia, Hubble Space Telescope archives at Space Telescope Science Institute, European Southern Observatory Science Archive Facility, and infrared resources such as Two Micron All-Sky Survey and Wide-field Infrared Survey Explorer. Radio and submillimeter archives accessed include services from National Radio Astronomy Observatory and facilities associated with the Atacama Large Millimeter/submillimeter Array partnership. Catalog and cross-match services such as those operated by Centre de Données astronomiques de Strasbourg and virtual observatory endpoints governed by the International Virtual Observatory Alliance are also supported.

Community contributors have developed connectors for mission-specific services like Kepler, TESS, and solar-system oriented resources used by teams at Jet Propulsion Laboratory. The set of modules evolves as new missions from institutions such as European Space Agency and National Aeronautics and Space Administration release APIs, or as survey projects at observatories like Pan-STARRS publish data access endpoints.

Usage and Examples

Typical usage involves importing a provider module and invoking query methods to search catalogs, retrieve images, or download files. Scripts used in analysis pipelines at institutions such as Harvard–Smithsonian Center for Astrophysics and Max Planck Institute for Astronomy commonly combine Astroquery with Astropy Project table and coordinate classes to perform tasks like cross-matching Gaia DR catalogs with Sloan Digital Sky Survey photometry, or fetching calibrated spectra from European Southern Observatory archives for follow-up by groups at Space Telescope Science Institute. Example workflows often integrate with data reduction packages used at European Southern Observatory or with visualization tools developed at California Institute of Technology.

Because Astroquery is a programmatic client, it is well suited for batch processing and reproducible research practices employed by research groups at Massachusetts Institute of Technology and university consortia. Notebooks used in teaching and collaborative projects at University of Cambridge and University of Oxford frequently demonstrate simple queries against services like Two Micron All-Sky Survey and Pan-STARRS for classroom exercises.

Development and Community

Development is coordinated through platforms favored by open-source scientific projects, with contributions from researchers at Astropy Project member institutions and external collaborators associated with European Southern Observatory, Space Telescope Science Institute, NASA, and universities worldwide. The project follows contribution workflows similar to those used by Astropy Project and other community-driven efforts, including issue tracking, tests, and continuous integration employed by teams at GitHub. Regular interaction occurs via mailing lists, issue trackers, and community events attended by scientists from Max Planck Society, Harvard–Smithsonian Center for Astrophysics, and various university departments.

Training materials, tutorials, and example notebooks are produced by contributors affiliated with institutions such as California Institute of Technology and Jet Propulsion Laboratory, and are showcased at conferences where groups from European Southern Observatory and Space Telescope Science Institute present methods for programmatic data access.

Licensing and Distribution

Astroquery is distributed under the BSD-3-Clause license, a permissive open-source license also used by projects like Astropy Project and many scientific software packages developed at institutions such as California Institute of Technology and Massachusetts Institute of Technology. It is available via package repositories commonly used by researchers at Harvard–Smithsonian Center for Astrophysics and other centers, enabling installation in environments used for production pipelines at European Southern Observatory and academic groups worldwide. The licensing choice facilitates integration into both academic research workflows and mission data systems maintained by organizations such as NASA and European Space Agency.

Category:Astronomy software