Skip to content

gaia_query

Cone-search the Gaia archive around ICRS coordinates.
Category External catalogues
Backend astroquery - wraps astroquery (Virtual Observatory access)
Version 1.0.0
Reads -
Writes catalog_lookups

Requires network access and the optional 'catalogs' extra. By default queries the latest release available via astroquery.gaia. Use data_release to pin a specific release such as 'DR3' or 'DR2'.

Parameters

Parameter Default Required Description
ra_deg None yes Right ascension (ICRS) in degrees.
dec_deg None yes Declination (ICRS) in degrees.
radius_arcsec 5.0 - Cone-search radius around the position.
data_release None - Gaia release table to query (e.g. 'gaiadr3.gaia_source').

Use it

from spectro_kernel import run_algorithm

output = run_algorithm("gaia_query", ctx, {
    "ra_deg": "<value>",
    "dec_deg": "<value>",
    "radius_arcsec": 5.0,
    "data_release": None
})

spectro run gaia_query --input spectrum.fits \
  --param ra_deg=<value> \
  --param dec_deg=<value> \
  --param radius_arcsec=5.0 \
  --param data_release=none

{
  "tool": "gaia_query",
  "arguments": {
    "session_id": "<session_id>",
    "params": {
      "ra_deg": "<value>",
      "dec_deg": "<value>",
      "radius_arcsec": 5.0,
      "data_release": null
    }
  }
}

Every algorithm is an MCP tool of the same name; describe_algorithm returns this page's metadata as JSON.

References

  • Gaia Collaboration 2016, A&A 595, A1 — the Gaia mission
  • Salgado et al. 2017 — Gaia archive TAP+ access
  • Ginsburg et al. 2019, AJ 157, 98 — astroquery
  • simbad_query - Resolve an object name against SIMBAD and store the record in the context.
  • vizier_query - Look up an object in VizieR — the CDS table service.