ionis-jupyter

Jupyter notebooks and helper library for HF propagation research using IONIS datasets.

What's Inside

175+ million propagation signatures spanning 18 years (2008-2026), ready for analysis:

Plus solar indices (1932-2026), DSCOVR solar wind, and IRI-2020 ionospheric atlas.

Quick Start

Option 1: Binder (No Install)

Click the Binder badge above to launch notebooks in the cloud — nothing to install.

Option 2: Local Install

# Install packages
pip install ionis-jupyter ionis-mcp

# Download datasets (choose your bundle)
ionis-download --bundle minimal      # ~430 MB: contest + grids + solar
ionis-download --bundle recommended  # ~1.1 GB: + pskr + dscovr
ionis-download --bundle full         # ~15 GB: all 9 datasets

# Launch Jupyter
jupyter lab

Notebooks

Helper Library

The ionis_jupyter package provides utilities for common tasks:

from ionis_jupyter import (
    # Data loading
    load_dataset, list_datasets,

    # Grid calculations
    grid_to_latlon, grid_distance, grid_bearing,

    # Solar geometry
    solar_elevation, is_dark, classify_path,

    # Plotting
    plot_band_heatmap, plot_solar_correlation,
    plot_path_profile, plot_distance_snr,
)

# Load WSPR signatures
wspr = load_dataset("wspr")
print(f"Loaded {len(wspr):,} signatures")

# Filter to 20m band
wspr_20m = wspr[wspr["band"] == 107]

# Plot hour×month heatmap
plot_band_heatmap(wspr_20m, band=107)

Data Directory

By default, datasets are stored in ~/.ionis-mcp/data/. Override with:

export IONIS_DATA_DIR=/path/to/your/data

Or download directly:

# Specific datasets
ionis-download --datasets wspr,rbn,solar

# To custom directory
ionis-download --bundle minimal --data-dir /my/data/path

For Researchers

This repository is designed for:

• PhD students studying ionospheric propagation
• HamSCI researchers analyzing TIDs, eclipse effects, greyline
• Data scientists needing labeled propagation data for ML
• Contesters analyzing historical band conditions
• Amateur radio operators exploring propagation patterns

Citation

If you use these datasets in research, please cite:

IONIS-AI Propagation Datasets.
Greg Beam, KI7MT. IONIS-AI Project.
https://ionis-ai.com

Data sources: WSPRNet, Reverse Beacon Network, PSK Reporter, CQ Contests.

Links

• Datasets: SourceForge
• MCP Server: ionis-mcp on PyPI
• Project: IONIS-AI on GitHub

License

MIT — see LICENSE.

Datasets are CC BY 4.0 (see per-directory LICENSE.md files on SourceForge).