ionis-validate

Validation suite for the IONIS V22-gamma + PhysicsOverrideLayer HF propagation model. Run 29 physics tests (18 KI7MT operator-grounded + 11 band x time discrimination), predict SNR for any HF path, or batch-test your own paths — all from the command line or a browser UI, on any platform.

IONIS (Ionospheric Neural Inference System) predicts HF radio signal strength from WSPR, RBN, and contest data. The V22-gamma model was trained on 38.7 million propagation observations spanning 2008-2026, with a deterministic PhysicsOverrideLayer for high-band night closure.

Install

pip install ionis-validate

Requires Python 3.10+ and PyTorch 2.0+. Works on Windows, macOS, and Linux.

Quick Start

# Show model and system info
ionis-validate info

# Run the full 29-test validation suite
ionis-validate test

# Predict SNR for a single path
ionis-validate predict \
    --tx-grid FN20 --rx-grid IO91 --band 20m \
    --sfi 150 --kp 2 --hour 14 --month 6 --day-of-year 172

# Acid test: 10m EU path at night (override should fire)
ionis-validate predict \
    --tx-grid DN46 --rx-grid JN48 --band 10m \
    --sfi 150 --kp 2 --hour 2 --month 2 --day-of-year 45

Browser UI

A point-and-click dashboard wrapping every command.

pip install "ionis-validate[ui]"
ionis-validate ui

Opens a browser tab at http://localhost:8765 with tabs for Predict, Custom, Report, and Info.

Batch Predictions

Define a set of paths in a JSON file and run them all at once:

# Run the bundled example (2 easy, 2 medium, 2 hard)
ionis-validate custom --example

# Run your own paths
ionis-validate custom my_paths.json

See the Custom Path Tests documentation for the JSON format. V22 adds day_of_year and an OVR (override) column to the output.

Beta Testing

Generate a structured report for filing as a GitHub Issue:

ionis-validate report

Privacy

IONIS processes only grid-pair geometry, band, time, and solar indices. No callsigns, names, or personal data are used by the model or stored by this tool.

Full privacy policy: https://ionis-ai.com/about/data-privacy/

License

GPL-3.0-or-later. See LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ionis_validate-4.0.3.tar.gz (817.0 kB view details)

Uploaded Feb 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ionis_validate-4.0.3-py3-none-any.whl (822.4 kB view details)

Uploaded Feb 26, 2026 Python 3

File details

Details for the file ionis_validate-4.0.3.tar.gz.

File metadata

Download URL: ionis_validate-4.0.3.tar.gz
Upload date: Feb 26, 2026
Size: 817.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ionis_validate-4.0.3.tar.gz
Algorithm	Hash digest
SHA256	`aa6da3bb12e6184fd38bb30c423f88d805662f2edc8ecbce8ddaf638608358e6`
MD5	`a313a056a5b6567eb9029c7520e2ceef`
BLAKE2b-256	`a7742b909850ecbd415511d432bd5a578ad3b0ef67afd0ff5fc4f8b8a8de0b2d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ionis_validate-4.0.3.tar.gz:

Publisher: publish.yml on IONIS-AI/ionis-validate

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ionis_validate-4.0.3.tar.gz
- Subject digest: aa6da3bb12e6184fd38bb30c423f88d805662f2edc8ecbce8ddaf638608358e6
- Sigstore transparency entry: 997394283
- Sigstore integration time: Feb 26, 2026
Source repository:
- Permalink: IONIS-AI/ionis-validate@afe0f50a1480be8cc7d5ace2e9d2c356c30e63c1
- Branch / Tag: refs/tags/v4.0.3
- Owner: https://github.com/IONIS-AI
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@afe0f50a1480be8cc7d5ace2e9d2c356c30e63c1
- Trigger Event: push