How Do You Find and Download High-Energy Astronomy Data from NASA's HEASARC?

Updated

HEASARC is NASA's designated multi-mission archive for cosmic astronomy datasets in the extreme ultraviolet (EUV), X-ray, and gamma-ray bands, plus cosmic microwave background (CMB) data. If your target is a high-energy observation from a mission like Chandra, XMM-Newton, Swift, NuSTAR, or Fermi, this is the archive to search. You can query it through a web portal, pull data programmatically via API or Python, and analyze it either locally with HEASoft or in the cloud on SciServer.

Know which archive covers your data

HEASARC is not the only NASA archive, and picking the wrong one wastes time. The site itself points to three related services:

Archive Wavelength / content Use it for
HEASARC EUV, X-ray, gamma-ray, CMB datasets High-energy mission observations
LAMBDA Cosmic microwave background CMB research, cosmology mission data and tools
MAST (referenced alongside HEASARC/IRSA in the Fornax cloud effort) Data accessible through the same cloud platform

If your source is a CMB experiment, start at LAMBDA rather than HEASARC's main query interface.

Search the archive

Two entry points exist, and the choice depends on how precise your query is.

Archive Quick Search

This is the plain-language path. You type a query and the site redirects you to the search portal. The site's own examples show the query grammar:

  • '3c 273' rosat — find ROSAT tables with information on 3C 273
  • chanmaster exposure>10000 status='archived' — find long Chandra exposures
  • 'AM Her' cataclysmic — cataclysmic variable tables containing AM Her
  • messier rosmaster a.constell='SCO' b.exposure>20000 — long ROSAT observations of Messier objects in Scorpius

The pattern is: object name or table name, plus optional column conditions using operators like > and =. Queries can join two tables with aliases (a., b.) when you need to filter across them.

Xamin

Xamin is the interactive web portal for data discovery and exploration. The classic Browse portal remains available if you prefer the older interface. Use Xamin when you want to see table structure, refine conditions visually, and inspect results before downloading.

Expected result: both paths end at a results table you can filter and export. If a query returns nothing, check that the object name matches the catalog's format (the examples use quoted names like '3c 273') and that your column names exist in the table you selected.

Retrieve data programmatically

If you are scripting a pipeline or need repeatable pulls, HEASARC offers three documented routes:

  • Xamin API — HTTP access to the same query system
  • astroquery Heasarc module — Python interface, convenient inside notebooks
  • Virtual Observatory protocols via pyvo — standards-based access for interoperability with other VO tools

Choose the API or pyvo when your queries must run unattended; choose astroquery when you are working interactively in Python and want results as tables.

Analyze without installing anything

HEASARC data are available in the cloud and on SciServer. HEASARC@SciServer is an analysis-ready platform where both data and software are reachable through a browser — HEASoft and other high-energy software (CAIO, XMM-SAS, Fermitools, Spex, and others) are pre-installed there.

The Fornax Initiative is NASA's next-generation cloud science platform, and the site notes it is welcoming interested beta users to analyze HEASARC, IRSA, and MAST data in the cloud. If your goal is to avoid a local software stack, start with SciServer.

Install and version-match local software

For local analysis you need HEASoft, which includes XSPEC. Current details from the site:

  • HEASoft 6.37.0 is available, and HEASoft and XSPEC are also distributed as conda packages.
  • NuSTARDAS v2.1.6 is required for recent NuSTAR observations. Any observation taken on or after September 24, 2026 requires NuSTARDAS v2.1.6, found in the latest HEASoft v6.37.1 release. The general analysis process is unchanged.

That last point is the most common trap: a working installation can still fail on new data if the calibration software predates the observation. Check the observation date against the required software version before debugging anything else.

A practical sequence

  1. Identify the mission and wavelength of your target.
  2. Query via Archive Quick Search or Xamin to confirm the data exist and note the table and observation IDs.
  3. Download through the portal, or script the pull with the Xamin API, astroquery, or pyvo.
  4. If you want to skip installation, open the data on SciServer; otherwise install HEASoft (conda packages are an option) and verify the version matches your observation dates.
  5. Reduce and analyze with HEASoft/XSPEC or the mission-specific tools bundled with it.

The archive, its data, and its software are described as freely available for use.