gaia-catalog

Bundled Gaia DR3 star catalog in a compact binary format for Python, with Hipparcos 2 data for the brightest stars.

Installation

pip install gaia-catalog

Creating the binary catalog

The binary data file is not included in the repository. To create it from a gaia_merged.csv (produced by tetra3rs's download script):

python -c "from gaia_catalog import convert_csv_to_binary; convert_csv_to_binary('path/to/gaia_merged.csv')"

This writes gaia_merged.bin into the package's data/ directory.

Usage

from gaia_catalog import catalog_path

path = catalog_path()

Binary format

Header:  b'GDR3' (4 bytes) + version (u32 LE) + num_stars (u64 LE)
Per star: source_id (i64 LE) + ra (f64 LE) + dec (f64 LE)
          + mag (f32 LE) + pmra (f32 LE) + pmdec (f32 LE)

36 bytes per star, little-endian throughout.

Data license

Gaia DR3 data is published by ESA/Gaia/DPAC under CC BY-SA 3.0 IGO. Hipparcos 2 data is provided by ESA and is freely available for scientific use. If you use this catalog, please cite Gaia DR3 appropriately. The code in this package is MIT-licensed.