Registry / data / skyfield-data

skyfield-data

library7.0.0pypypi✓ verified 83d ago

A data package for the Skyfield astronomy library, providing essential ephemeris files (e.g., de421.bsp) and Earth orientation data (finals2000A.all) that automatically expire and can be refreshed. Current version 7.0.0 requires Python >=2.6, !=3.0-3.7; supports Python 3.11, 3.12. Releases are irregular, driven by data file updates.

data

pip install skyfield-data

github ↗package ↗

INSTALL

IMPORT

SIG · SKYFIELD-DATA

skyfield-data

datapythonv7.0.0

Install

2.0s avg

Import

10ms

Disk

35MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v7.0.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.004s · 37.4MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.0s · import 0.002s · 38MB

35MB installed

● package 35MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

get_skyfield_data_path

✓ from skyfield_data import get_skyfield_data_path

This snippet imports Skyfield's loader and the data path from skyfield-data, then loads the included de421.bsp file.

from skyfield.api import load from skyfield_data import get_skyfield_data_path # Use the data path provided by skyfield-data load_data = load(get_skyfield_data_path()) # Load an ephemeris (de421.bsp is included) planets = load_data('de421.bsp') print('Ephemeris loaded successfully')

Debug

Known issues

breakingVersion 3.0.0 switched from using deltat.data/deltat.preds to finals2000A.all for timescale computations. Existing code using old file paths will break.

fix

Ensure your Skyfield timescale initialization does not rely on deltat files; upgrade skyfield-data to 3.0.0+ and let Skyfield use the IERS data automatically.

affects: >=3.0.0

deprecatedVersion 2.0.0 removed deltat.data and deltat.preds files; Skyfield 1.31+ no longer uses them. Code that accesses these files directly will fail after upgrade.

fix

Remove any manual loading of deltat files; upgrade to skyfield>=1.31 and skyfield-data>=2.0.0.

affects: >=2.0.0

gotchaData files have expiration dates. If a file is expired, get_skyfield_data_path() will raise a UserWarning. Code that uses the path without checking may silently use stale data.

fix

Call get_skyfield_data_path() with expire=True to force a refresh, or catch the warning and re-download using the included download script.

affects: >=0.1.0

gotchaThe included de421.bsp is a simplified ephemeris; for high-precision work, you must download a larger JPL ephemeris separately (e.g., de430.bsp).

fix

Use load_data('de430.bsp') after downloading the file manually, or point the loader to a custom directory.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'skyfield_data'

Package not installed or imported incorrectly.

fix

Run 'pip install skyfield-data' and use 'from skyfield_data import get_skyfield_data_path'

UserWarning: The file ... has expired

Data file is older than its expiration date.

fix

Run the download script: 'python -m skyfield_data.download' or pass expire=True to get_skyfield_data_path()

Upgrade

Version history

7.0.0latest on PyPI · released Aug 26, 2025

Audit

Dependencies

skyfieldrequiredData files are used by Skyfield's loader and timescale computations.

Agent activity

11 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/brunobord/skyfield-data ↗

packagehttps://pypi.org/project/skyfield-data/ ↗