Upgrade to V22-gamma + PhysicsOverrideLayer (4.0.0)

Replace V20 model/tests with V22-gamma (17 features, safetensors,
PhysicsOverrideLayer deterministic clamp). 29 tests (18 KI7MT + 11
TST-900) replace the V20 62-test suite. Python floor raised to 3.10.
Bundled example_custom_paths.json with --example CLI flag.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: KI7MT

README.md

@@ -1,39 +1,46 @@
 # ionis-validate
 
-Validation suite for the IONIS V20 HF propagation model. Run 62 physics
-tests, predict SNR for any HF path, or batch-test your own paths — all
-from the command line or a browser UI, on any platform.
+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 V20 model was trained on
-31 million propagation observations spanning 2005-2025.
+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.9+ and PyTorch 2.0+. Works on Windows, macOS, and Linux.
+Requires Python 3.10+ and PyTorch 2.0+. Works on Windows, macOS, and Linux.
 
 ## Quick Start
 
 ```bash
 # Show model and system info
 ionis-validate info
 
-# Run the full 62-test validation suite
+# 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
+    --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. Requires Python 3.10+.
+A point-and-click dashboard wrapping every command.
 
 ```
 pip install "ionis-validate[ui]"
@@ -48,19 +55,19 @@ Custom, Report, and Info.
 Define a set of paths in a JSON file and run them all at once:
 
 ```bash
+# 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](https://ionis-ai.com/testing/custom-paths/)
-documentation for the JSON format.
+documentation for the JSON format. V22 adds `day_of_year` and an OVR
+(override) column to the output.
 
 ## Beta Testing
 
-If you are testing V20, follow the step-by-step
-[Beta Test Plan](https://ionis-ai.com/testing/beta-test-plan/) (Test-1
-through Test-9). It tells you exactly what to run, what to expect, and
-how to submit your results.
-
 Generate a structured report for filing as a GitHub Issue:
 
 ```bash
@@ -82,7 +89,6 @@ GPL-3.0-or-later. See [LICENSE](LICENSE).
 ## Links
 
 - Documentation: <https://ionis-ai.com/testing/>
-- Beta Test Plan: <https://ionis-ai.com/testing/beta-test-plan/>
 - Source: <https://github.com/IONIS-AI/ionis-validate>
 - Issues: <https://github.com/IONIS-AI/ionis-validate/issues>
 - IONIS Project: <https://ionis-ai.com/>

pyproject.toml

@@ -1,22 +1,23 @@
 [project]
 name = "ionis-validate"
-version = "0.3.0"
-description = "IONIS V20 — HF Propagation Model Validation Suite"
+version = "4.0.0"
+description = "IONIS V22-gamma + PhysicsOverrideLayer — HF Propagation Model Validation Suite"
 readme = "README.md"
 license = {text = "GPL-3.0-or-later"}
 authors = [{name = "Greg Beam, KI7MT"}]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 dependencies = [
     "torch>=2.0",
     "numpy>=1.24",
+    "safetensors>=0.4",
 ]
 classifiers = [
     "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Operating System :: OS Independent",
     "Topic :: Scientific/Engineering :: Physics",
 ]

src/ionis_validate/__init__.py

@@ -1,5 +1,5 @@
-"""IONIS V20 HF Propagation Model — Validation Suite"""
-__version__ = "0.3.0"
+"""IONIS V22-gamma + PhysicsOverrideLayer — HF Propagation Model Validation Suite"""
+__version__ = "4.0.0"
 
 import os as _os
 

src/ionis_validate/cli.py

@@ -26,22 +26,23 @@
 }
 
 USAGE = """\
-ionis-validate — IONIS V20 HF Propagation Model Validation Suite
+ionis-validate — IONIS V22-gamma + PhysicsOverrideLayer Validation Suite
 
 Usage:
   ionis-validate <command> [options]
 
 Commands:
-  test       Run the full 62-test validation suite
-  predict    Predict SNR for a single HF path
-  custom     Run batch predictions from a JSON file
+  test       Run the full 29-test validation suite (KI7MT + TST-900)
+  predict    Predict SNR for a single HF path (with PhysicsOverrideLayer)
+  custom     Run batch predictions from a JSON file (--example for demo)
   report     Generate a beta test report for GitHub Issues
   info       Show model and system information
   ui         Launch browser-based validation dashboard
 
 Examples:
   ionis-validate test
-  ionis-validate predict --tx-grid FN20 --rx-grid IO91 --band 20m --sfi 150 --kp 2 --hour 14 --month 6
+  ionis-validate predict --tx-grid FN20 --rx-grid IO91 --band 20m --sfi 150 --kp 2 --hour 14 --month 6 --day-of-year 172
+  ionis-validate custom --example
   ionis-validate custom my_paths.json
   ionis-validate info
 

src/ionis_validate/data/config_v20.json src/ionis_validate/data/config_v22.jsonsrc/ionis_validate/data/config_v20.json renamed to src/ionis_validate/data/config_v22.json

@@ -1,16 +1,17 @@
 {
-  "version": "v20",
-  "phase": "Production",
-  "checkpoint": "ionis_v20.pth",
+  "version": "v22",
+  "variant": "gamma",
+  "phase": "Production (Phase 4.0)",
+  "checkpoint": "ionis_v22_gamma.safetensors",
 
   "model": {
     "architecture": "IonisGate",
-    "dnn_dim": 11,
+    "dnn_dim": 15,
     "hidden_dim": 256,
     "sidecar_hidden": 8,
-    "input_dim": 13,
-    "sfi_idx": 11,
-    "kp_penalty_idx": 12,
+    "input_dim": 17,
+    "sfi_idx": 15,
+    "kp_penalty_idx": 16,
     "gate_init_bias": -0.693
   },
 
@@ -39,7 +40,9 @@
   "features": [
     "distance", "freq_log", "hour_sin", "hour_cos",
     "az_sin", "az_cos", "lat_diff", "midpoint_lat",
-    "season_sin", "season_cos", "day_night_est",
+    "season_sin", "season_cos", "vertex_lat",
+    "tx_solar_dep", "rx_solar_dep",
+    "freq_x_tx_dark", "freq_x_rx_dark",
     "sfi", "kp_penalty"
   ],
 
@@ -70,9 +73,10 @@
   },
 
   "validation": {
-    "pearson_min": 0.48,
-    "kp_storm_min": 3.0,
-    "sfi_benefit_min": 0.4
+    "pearson_min": 0.46,
+    "kp_storm_min": 1.0,
+    "sfi_benefit_min": 0.4,
+    "tst900_min": 8
   },
 
   "clickhouse": {

src/ionis_validate/data/example_custom_paths.json

@@ -0,0 +1,75 @@
+{
+  "description": "Example custom paths — 2 easy, 2 medium, 2 hard",
+  "conditions": {
+    "sfi": 150,
+    "kp": 2
+  },
+  "paths": [
+    {
+      "label": "Easy: 20m NA-EU midday summer",
+      "tx_grid": "FN31",
+      "rx_grid": "IO91",
+      "band": "20m",
+      "hour": 14,
+      "month": 6,
+      "day_of_year": 172,
+      "expect_open": true,
+      "mode": "FT8"
+    },
+    {
+      "label": "Easy: 40m domestic NA night",
+      "tx_grid": "DN13",
+      "rx_grid": "EM73",
+      "band": "40m",
+      "hour": 4,
+      "month": 1,
+      "day_of_year": 15,
+      "expect_open": true,
+      "mode": "FT8"
+    },
+    {
+      "label": "Medium: 15m NA-JA winter midday",
+      "tx_grid": "CN87",
+      "rx_grid": "PM95",
+      "band": "15m",
+      "hour": 22,
+      "month": 12,
+      "day_of_year": 355,
+      "expect_open": true,
+      "mode": "FT8"
+    },
+    {
+      "label": "Medium: 20m NA-VK evening",
+      "tx_grid": "FM18",
+      "rx_grid": "QF56",
+      "band": "20m",
+      "hour": 10,
+      "month": 3,
+      "day_of_year": 80,
+      "expect_open": true
+    },
+    {
+      "label": "Hard: 10m EU night — override should fire",
+      "tx_grid": "DN46",
+      "rx_grid": "JN48",
+      "band": "10m",
+      "hour": 2,
+      "month": 2,
+      "day_of_year": 45,
+      "expect_open": false,
+      "mode": "FT8"
+    },
+    {
+      "label": "Hard: 160m transatlantic winter night",
+      "tx_grid": "FN42",
+      "rx_grid": "IO81",
+      "band": "160m",
+      "hour": 3,
+      "month": 1,
+      "day_of_year": 15,
+      "sfi": 80,
+      "kp": 1,
+      "expect_open": true
+    }
+  ]
+}

src/ionis_validate/data/ionis_v20.pth

@@ -0,0 +1,36 @@
+{
+  "version": "v22",
+  "variant": "gamma",
+  "architecture": "IonisGate",
+  "phase": "Production (Phase 4.0)",
+  "date_range": "2008-03-11 to 2026-02-21",
+  "sample_size": 38760089,
+  "epoch": 100,
+  "val_rmse": 0.8346196287579953,
+  "val_pearson": 0.4591027498245239,
+  "sfi_benefit": 0.48183250427246094,
+  "storm_cost": 2.8148746490478516,
+  "rbn_full_sample": 0,
+  "tst900_score": "9/11",
+  "ki7mt_hard_pass": "16/17 raw, 17/17 with PhysicsOverrideLayer",
+  "physics_override": "IF freq>=21MHz AND tx_solar<-6 AND rx_solar<-6 AND pred>-1.0sigma THEN clamp -1.0sigma",
+  "dnn_dim": 15,
+  "sidecar_hidden": 8,
+  "input_dim": 17,
+  "features": [
+    "distance", "freq_log", "hour_sin", "hour_cos",
+    "az_sin", "az_cos", "lat_diff", "midpoint_lat",
+    "season_sin", "season_cos", "vertex_lat",
+    "tx_solar_dep", "rx_solar_dep",
+    "freq_x_tx_dark", "freq_x_rx_dark",
+    "sfi", "kp_penalty"
+  ],
+  "v16_physics_laws": [
+    "IonisGate architecture (gates from trunk output 256-dim)",
+    "HuberLoss(delta=1.0)",
+    "Gate variance loss",
+    "Defibrillator init (weights 0.8-1.2, fc2.bias=-10)",
+    "Weight clamp [0.5, 2.0] after every step",
+    "Data recipe: WSPR + DXpedition + Contest (no RBN Full)"
+  ]
+}