Skip to content

vizier_query

Look up an object in VizieR — the CDS table service.
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 the row count per catalogue is capped at 5; set row_limit to change it.

Parameters

Parameter Default Required Description
object_name None yes Object identifier (e.g. 'HD 209458').
catalog None - Optional VizieR catalogue ID to restrict to (e.g. 'I/350/gaiaedr3').
row_limit 5 - Maximum number of rows to fetch per catalogue.
radius_arcsec 5.0 - Cone-search radius around the resolved position.

Use it

from spectro_kernel import run_algorithm

output = run_algorithm("vizier_query", ctx, {
    "object_name": "<value>",
    "catalog": None,
    "row_limit": 5,
    "radius_arcsec": 5.0
})

spectro run vizier_query --input spectrum.fits \
  --param object_name=<value> \
  --param catalog=none \
  --param row_limit=5 \
  --param radius_arcsec=5.0

{
  "tool": "vizier_query",
  "arguments": {
    "session_id": "<session_id>",
    "params": {
      "object_name": "<value>",
      "catalog": null,
      "row_limit": 5,
      "radius_arcsec": 5.0
    }
  }
}

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

References

  • Ochsenbein, Bauer & Marcout 2000, A&AS 143, 23 — VizieR
  • Ginsburg et al. 2019, AJ 157, 98 — astroquery
  • gaia_query - Cone-search the Gaia archive around ICRS coordinates.
  • simbad_query - Resolve an object name against SIMBAD and store the record in the context.