Skip to main content

penumbra-toolkit

Probabilistic space-weather driver forecasting for Python: forecast the F10.7 solar radio flux and the Kp geomagnetic index with calibrated uncertainty bands, verify that calibration with a leakage-free walk-forward backtest, and translate the uncertainty into orbital-drag risk.

Extracted from PENUMBRA, where the same code powers a live dashboard over the public NOAA feeds. The phase-2 companion to kessler-toolkit.

pip install penumbra-toolkit

What's inside

Module Purpose
series Parse NOAA F10.7 / Kp, aggregate Kp→daily Ap, align and gap-fill daily series
f107_forecast Persistence + mean-reversion point forecast with empirical quantile bands
kp_forecast Recency-weighted geomagnetic storm-category probabilities + Ap band
calibration Leakage-free walk-forward backtest, coverage, pinball loss, skill, reliability
drag F10.7 band → thermospheric density → in-track orbit-decay uncertainty

Quick start

import numpy as np
from penumbra_toolkit import (
    DailySeries, walk_forward_errors, forecast, coverage, skill_vs_reference,
)

# a daily F10.7 history (dates + values)
history = DailySeries(dates, values)

# learn the out-of-sample error distribution, then forecast with calibrated bands
bt = walk_forward_errors(history, lead_days=45, min_train=400)
fc = forecast(history, 45, bt.error_quantiles)

print(fc.point[6], fc.bands[5][6], fc.bands[95][6])   # 7-day point + 90% band
print(coverage(bt)[0])                                # empirical vs target coverage
print(skill_vs_reference(bt)[0])                      # skill vs persistence baseline

Every uncertainty band is learned from real out-of-sample forecast errors — calibrated by construction if the backtest is leakage-free, which is enforced by test. Drag translation is a reduced, order-of-magnitude model (not a high-fidelity propagation).

Apache-2.0. Space-weather data used with PENUMBRA courtesy of NOAA SWPC and GFZ Potsdam.

Metadata

Release files for penumbra-toolkit 0.1.0

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

Source distribution (sdist)

Source distribution for penumbra-toolkit 0.1.0
File Size Uploaded Provenance Actions
penumbra_toolkit-0.1.0.tar.gz 12.5 kB Without provenance Details for penumbra_toolkit-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for penumbra-toolkit 0.1.0
File Interpreter ABI Platform Actions
penumbra_toolkit-0.1.0-py3-none-any.whl Python 3 none any Details for penumbra_toolkit-0.1.0-py3-none-any.whl

Total release size: 26.5 kB

Release files / penumbra_toolkit-0.1.0.tar.gz

Download URL penumbra_toolkit-0.1.0.tar.gz
Size 12.5 kB
Tags Source
SHA-256 checksum
How to use checksums
9cdb78778b123c29cc8dbea0a7ce70389210c3ce2d909b29f673d43a424a004d
BLAKE2b-256 checksum
How to use checksums
e813a12fed6c6d12e0a0d263eae15289ee8cc721f16a9dc52db5b56a6f712e09
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.7

Release files / penumbra_toolkit-0.1.0-py3-none-any.whl

Download URL penumbra_toolkit-0.1.0-py3-none-any.whl
Size 14.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7e4802c73a648cf7aae681289de88214b139097b3d91f0bc50a90fcdfed6f0db
BLAKE2b-256 checksum
How to use checksums
666ffdea4b5892a873862df49be1b4fd3520aee7ac912aa3dd04009af07785f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.7

Security for penumbra-toolkit 0.1.0

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