astro-resolver 0.1.0

Astronomical object name resolution: Messier, NGC/IC, Caldwell, Sharpless, Barnard, SIMBAD.

astro-resolver

Astronomical object name resolution for FITS workflows, astrophotography pipelines and Siril scripts. Turns messy OBJECT headers like "M 81", "sh2-101", "barnard 33" or "HD 1" into clean, filesystem-safe folder names.

Features

• Local-first resolution chain — SIMBAD only as a last resort
• Solar System, Caldwell, custom aliases, OpenNGC (~14k objects), Sharpless and Barnard catalogs bundled
• Stellar catalog IDs (HD, HIP, SAO, TYC, …) skip the SIMBAD otype round-trip and go straight to coordinate lookup
• Coordinate fallback via SIMBAD when name lookup fails
• Filesystem-safe output suitable as folder/file names

Installation

pip install astro-resolver

Usage

from astro_resolver import resolve_object_name

resolve_object_name("M 81")              # → "M81_BodesGalaxy"
resolve_object_name("sh2-101")           # → "Sh2-101_TulipNebula"
resolve_object_name("barnard 33")        # → "B33_HorseheadNebula"

# Stellar catalog ID with coordinates → SIMBAD coord lookup
resolve_object_name("HD 1", ra="00 05 09", dec="+67 50 24")

The resolver accepts an optional log callable so it can be plugged into Siril scripts (log=siril.log) or any other host environment.

Resolution priority

1. Solar System (local)
2. Caldwell (local)
3. Custom aliases (local)
4. OpenNGC offline (local, ~14k NGC/IC objects)
5. Sharpless catalog (local, Sh 2-xxx HII regions)
6. Barnard catalog (local, dark nebulae)
7. SIMBAD by name (online)
8. SIMBAD by coordinates (online)
9. Sanitized header string as fallback

Data sources

• OpenNGC — CC BY-SA 4.0
• SIMBAD via astroquery

License

MIT