gaia-catalog 0.1.0__tar.gz

gaia_catalog-0.1.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: gaia-catalog
+Version: 0.1.0
+Summary: Bundled Gaia DR3 + Hipparcos merged star catalog in binary format
+Author: Steven Michael
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# gaia-catalog
+
+Bundled [Gaia DR3](https://www.cosmos.esa.int/web/gaia/dr3) + Hipparcos merged star catalog in a compact binary format for Python.
+
+## Installation
+
+```bash
+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):
+
+```bash
+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
+
+```python
+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-NC 3.0 IGO](https://creativecommons.org/licenses/by-nc/3.0/igo/). If you use this catalog, please cite Gaia DR3 appropriately. The code in this package is MIT-licensed.

gaia_catalog-0.1.0/README.md

@@ -0,0 +1,41 @@
+# gaia-catalog
+
+Bundled [Gaia DR3](https://www.cosmos.esa.int/web/gaia/dr3) + Hipparcos merged star catalog in a compact binary format for Python.
+
+## Installation
+
+```bash
+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):
+
+```bash
+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
+
+```python
+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-NC 3.0 IGO](https://creativecommons.org/licenses/by-nc/3.0/igo/). If you use this catalog, please cite Gaia DR3 appropriately. The code in this package is MIT-licensed.

gaia_catalog-0.1.0/gaia_catalog/__init__.py

@@ -0,0 +1,67 @@
+"""Bundled Gaia DR3 + Hipparcos merged star catalog in binary format."""
+
+import csv
+import math
+import struct
+from pathlib import Path
+
+__version__ = "0.1.0"
+
+_DATA_DIR = Path(__file__).parent / "data"
+
+
+def catalog_path() -> Path:
+    """Return the path to the bundled gaia_merged.bin file."""
+    return _DATA_DIR / "gaia_merged.bin"
+
+
+def convert_csv_to_binary(csv_path: str, output_path: str | None = None) -> None:
+    """Convert a gaia_merged.csv file to the compact binary format.
+
+    CSV columns: source_id,ra,dec,phot_g_mean_mag,pmra,pmdec
+
+    Binary format:
+        Header:  b'GDR3' + version (u32 LE, 1) + 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
+
+    Args:
+        csv_path: Path to gaia_merged.csv.
+        output_path: Destination for the binary file. Defaults to the
+            package's data/gaia_merged.bin.
+    """
+    if output_path is None:
+        output_path = str(_DATA_DIR / "gaia_merged.bin")
+
+    # First pass: read all rows into memory so we know num_stars for the header.
+    stars: list[tuple[int, float, float, float, float, float]] = []
+    with open(csv_path, newline="") as f:
+        reader = csv.reader(f)
+        header = next(reader)  # skip header row
+        for row in reader:
+            source_id = int(row[0])
+            ra = float(row[1])
+            dec = float(row[2])
+            mag = float(row[3])
+            pmra_val = float(row[4]) if row[4] else 0.0
+            pmdec_val = float(row[5]) if row[5] else 0.0
+            if math.isnan(pmra_val):
+                pmra_val = 0.0
+            if math.isnan(pmdec_val):
+                pmdec_val = 0.0
+            stars.append((source_id, ra, dec, mag, pmra_val, pmdec_val))
+
+    num_stars = len(stars)
+
+    with open(output_path, "wb") as out:
+        # Header: magic + version + num_stars
+        out.write(b"GDR3")
+        out.write(struct.pack("<I", 1))
+        out.write(struct.pack("<Q", num_stars))
+
+        # Star records
+        for source_id, ra, dec, mag, pmra_val, pmdec_val in stars:
+            out.write(struct.pack("<qddfff", source_id, ra, dec, mag, pmra_val, pmdec_val))
+
+    print(f"Wrote {num_stars} stars to {output_path}")

gaia_catalog-0.1.0/gaia_catalog.egg-info/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: gaia-catalog
+Version: 0.1.0
+Summary: Bundled Gaia DR3 + Hipparcos merged star catalog in binary format
+Author: Steven Michael
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# gaia-catalog
+
+Bundled [Gaia DR3](https://www.cosmos.esa.int/web/gaia/dr3) + Hipparcos merged star catalog in a compact binary format for Python.
+
+## Installation
+
+```bash
+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):
+
+```bash
+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
+
+```python
+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-NC 3.0 IGO](https://creativecommons.org/licenses/by-nc/3.0/igo/). If you use this catalog, please cite Gaia DR3 appropriately. The code in this package is MIT-licensed.

gaia_catalog-0.1.0/gaia_catalog.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+gaia_catalog/__init__.py
+gaia_catalog.egg-info/PKG-INFO
+gaia_catalog.egg-info/SOURCES.txt
+gaia_catalog.egg-info/dependency_links.txt
+gaia_catalog.egg-info/top_level.txt
+gaia_catalog/data/gaia_merged.bin

gaia_catalog-0.1.0/gaia_catalog.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gaia_catalog-0.1.0/gaia_catalog.egg-info/top_level.txt

@@ -0,0 +1 @@
+gaia_catalog

gaia_catalog-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gaia-catalog"
+version = "0.1.0"
+description = "Bundled Gaia DR3 + Hipparcos merged star catalog in binary format"
+requires-python = ">=3.10"
+authors = [{ name = "Steven Michael" }]
+license = "MIT"
+readme = "README.md"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Astronomy",
+]
+
+[tool.setuptools.packages.find]
+include = ["gaia_catalog*"]
+
+[tool.setuptools.package-data]
+gaia_catalog = ["data/*.bin"]

gaia_catalog-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+