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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.