Skip to main content

jpl-debias-2018

A Python data package by the Asteroid Institute, a program of the B612 Foundation

jpl-debias-2018 is a data-only Python package containing the JPL Solar System Dynamics EFCC18 astrometric catalog-debias table. It follows the same installed-resource convention as the Asteroid Institute kernel packages: import the package, then pass its exported filesystem path to the consumer.

This is not an official JPL package. It is an Asteroid Institute mirror of the upstream files so that the table is installable via pip. The package preserves the upstream data byte-for-byte and records its complete provenance and cryptographic identity.

The package contains no orbit-determination implementation, has no runtime dependencies, performs no network access at import or runtime, and does not recompute data identity at import.

Data identity

Field Value
Upstream archive https://ssd.jpl.nasa.gov/ftp/ssd/debias/debias_2018.tgz
Archive SHA-256 288132cefea7f1bdf0989782db1173948dd7dfef7da31910be90b16b73cfea6c
Archive size 9,852,628 bytes
Archive last-modified 2023-03-01 22:24:39 UTC
bias.dat SHA-256 ef6a50830bb83d8b1161e7acb391eed988ea9708e9fbcccc0c834da6109476e3
bias.dat size 37,161,151 bytes
Upstream BIAS_VERSION 3.0 (2018-09-21)
Archive correction 2023-03-01 catalog-code correction
HEALPix geometry NSIDE 64, NPIX 49,152
Catalogs 26

The complete machine-readable record is packaged as jpl_debias_2018/SOURCE_MANIFEST.json. The March 2023 upstream update corrected the UCAC-5 catalog code in comments and headers from W to Y; the numerical table is identified by the hash above.

Installation

Install the released package from PyPI:

python -m pip install jpl-debias-2018

A reviewed wheel can also be installed directly:

python -m pip install ./jpl_debias_2018-2023.3.1.1-py3-none-any.whl

Pip installs wheels unpacked. Zip-importing this package is deliberately not supported because a real filesystem path is part of the public contract.

Python/native use

import jpl_debias_2018

bias_path = jpl_debias_2018.bias_dat
print(bias_path)
# '/.../site-packages/jpl_debias_2018/bias.dat'

bias_dat is an absolute str path. It can be passed directly across PyO3, C FFI, subprocess, or CLI boundaries just like naif_de440.de440.

Filesystem path for non-Python consumers

The package's native-consumer contract is only the absolute filesystem path. A deployment with the wheel installed can obtain it during provisioning:

BIAS_DAT="$(python -c 'import jpl_debias_2018; print(jpl_debias_2018.bias_dat)')"
printf '%s\n' "$BIAS_DAT"

The wheel can instead be unpacked as a data artifact during provisioning:

python -m zipfile --extract \
  jpl_debias_2018-2023.3.1.1-py3-none-any.whl ./od-data
BIAS_DAT="$(cd ./od-data && pwd)/jpl_debias_2018/bias.dat"
printf '%s\n' "$BIAS_DAT"

A consuming program, including a standalone Rust program, receives that explicit path through its own configuration. The consumer should validate the expected size and SHA-256 at its data-ingress boundary before parsing the file, and should not download the table during scientific execution. This data package does not define a consumer CLI or Rust API.

What the table contains

For every one of 49,152 equal-area sky tiles and each of 26 MPC star-catalog codes, the table supplies:

  • RA cos(Dec) position correction at J2000, arcseconds;
  • Dec position correction at J2000, arcseconds;
  • RA cos(Dec) proper-motion correction, milliarcseconds/year;
  • Dec proper-motion correction, milliarcseconds/year.

The upstream README is preserved unmodified in the wheel as UPSTREAM_README.txt. It explains how the corrections are applied and cites Eggl et al. (2020, Icarus) for the method.

Reproducible maintenance

Normal builds use the committed immutable data and never contact JPL. To verify a separately downloaded authority before copying it into the package:

curl --fail --location --proto '=https' --tlsv1.2 \
  -o /tmp/debias_2018.tgz \
  https://ssd.jpl.nasa.gov/ftp/ssd/debias/debias_2018.tgz
python tools/refresh_data.py --archive /tmp/debias_2018.tgz --check-only

To replace the packaged files with the already-verified known authority:

python tools/refresh_data.py --archive /tmp/debias_2018.tgz

--download is an explicit maintainer-only alternative. The script checks the archive hash and all member hashes and sizes before writing anything. If JPL changes the archive, it fails closed. Review the upstream changes first, then deliberately update the expected manifest and tests in the same commit; do not weaken or bypass the hash gate.

The release source has a checked exact inventory. After intentional source changes, regenerate it, inspect the diff, and commit it with the change:

python tools/update_source_inventory.py

Official artifacts must be built from a clean commit through the deterministic builder, never with a bare python -m build release command:

python tools/build_release.py
python tools/verify_artifacts.py dist/*.whl dist/*.tar.gz
python -m twine check dist/*
python tools/check_reproducible_builds.py

The final command clones the clean commit twice, builds independently, and requires byte-identical wheel and sdist SHA-256 values. The builder pins the backend, fixes SOURCE_DATE_EPOCH, canonicalizes ZIP and tar/gzip metadata, validates every inventoried source and packaged identity file, and rejects dirty source by default. The artifact verifier enforces the exact artifact filenames, complete ordered metadata headers and values, generated egg-info bytes, archive member and directory sets, and canonical container bytes. It does not provide a weaker payload-only verification mode.

Normal CI is pinned, read-only, and artifact-only. The standard manually dispatched/callable publication workflow reuses the exact artifacts produced by that complete validation workflow without rebuilding them, then publishes through PyPI trusted publishing with no long-lived upload credential. Creating the protected pypi environment, configuring the trusted publisher, and dispatching a release remain separate reviewed owner operations.

Acknowledgment

This project makes use of data provided and maintained by the NASA Jet Propulsion Laboratory, California Institute of Technology.

Licensing and attribution

This package uses normal Asteroid Institute MIT distribution metadata; see LICENSE. The bundled bias.dat and upstream README are exact JPL source bytes, not Institute-authored data. NOTICE and the packaged SOURCE_MANIFEST.json preserve that attribution, the upstream identity, and the Institute's distribution-policy record. This package is not affiliated with or endorsed by JPL, NASA, or Caltech.

Metadata

Release files for jpl-debias-2018 2023.3.1.1

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

Source distribution (sdist)

Source distribution for jpl-debias-2018 2023.3.1.1
File Size Uploaded Provenance Actions
jpl_debias_2018-2023.3.1.1.tar.gz 9.1 MB With provenance Details for jpl_debias_2018-2023.3.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for jpl-debias-2018 2023.3.1.1
File Interpreter ABI Platform Actions
jpl_debias_2018-2023.3.1.1-py3-none-any.whl Python 3 none any Details for jpl_debias_2018-2023.3.1.1-py3-none-any.whl

Total release size: 18.7 MB

Release files / jpl_debias_2018-2023.3.1.1.tar.gz

Download URL jpl_debias_2018-2023.3.1.1.tar.gz
Size 9.1 MB
Tags Source
SHA-256 checksum
How to use checksums
5cc1419cd6472817c15e878d61269a3234e71ba156bfc83443ae63b5f636ed85
BLAKE2b-256 checksum
How to use checksums
a29a781b647e91ca840321d4659acbf50dcadc38e636355211d69ffda195aeff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / jpl_debias_2018-2023.3.1.1-py3-none-any.whl

Download URL jpl_debias_2018-2023.3.1.1-py3-none-any.whl
Size 9.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ebd00a5dfee68553c394a270b48ca84815de282d0b603b0cf8f9fbebb8acc6b9
BLAKE2b-256 checksum
How to use checksums
a2774eebbffcfad3a776a0c7d37842102ceef7521e0f31db11a605ab8321b76c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Security for jpl-debias-2018 2023.3.1.1

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for jpl_debias_2018-2023.3.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

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
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