Skip to main content

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.

Metadata

Release files for gaia-catalog 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gaia-catalog 0.1.2
File Size Uploaded Provenance
gaia_catalog-0.1.2.tar.gz 15.7 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for gaia-catalog 0.1.2
File Interpreter ABI Platform
gaia_catalog-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 31.3 MB

Release files / gaia_catalog-0.1.2.tar.gz

Download URL gaia_catalog-0.1.2.tar.gz
Size 15.7 MB
Tags Source
SHA-256 checksum
How to use checksums
ef13382c378c3c239197aba3555f0b3fc164fdfae036f3448dd90ead54ac5673
BLAKE2b-256 checksum
How to use checksums
3a464484177cc9781eff8c719b629f7f839f774c10d6b79c2cfc4c6935792a8b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / gaia_catalog-0.1.2-py3-none-any.whl

Download URL gaia_catalog-0.1.2-py3-none-any.whl
Size 15.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
89986c057a0d66d7d976811c51bdab6e0db316c9a97da4fcb4a68d42aac91abd
BLAKE2b-256 checksum
How to use checksums
910a6bfe09a1bf95a09fd2ffdae4462f1ba5c17e8bac83f2c240a71fbe3e2f49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Security for gaia-catalog 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page