QDL Research Suite

Abstract

QDL Research Suite QDL Research Suite is a free, open-source Python package that brings together tested computational tools from the Quantum Diverter Loop (QDL) research program. It is designed to help researchers verify, reproduce, inspect, and reuse advanced mathematical and computational results without rebuilding every method from scratch. Version v1.2.0 unifies the tested computational and reproducibility layers of QDL Papers 1, 2, 3, and 4 in a single software release while preserving the provenance of the original research and reproducibility packages. What you can do with it Walsh/Fourier interaction analysis Exact finite-sample permutation moments Exact mean, variance, and covariance calculations Krawtchouk polynomial calculations Finite-alphabet model checks Structured exact-distribution verification Arithmetic and combinatorial verification routines Selected GKZ / A-hypergeometric computations Continuation-horizon checks Clebsch-graph and Walsh exact-tail calculations Exact hierarchy and orbit-weighting calculations Deterministic exact-tail verification Four-variable log-linear interaction analysis FR-OSI restricted-model rank and identifiability checks Exact pair/triple contrast-closure verification Retrospective and frozen external-test reproducibility checks Historical source-file integrity and SHA-256 verification Paper modules included in v1.2.0 Paper-1 — Exact Permutation Moments Provides exact finite-sample calculations for Walsh interaction-order energies, including: exact permutation means; exact variances; exact cross-order covariances; normalized interaction-order statistics; exhaustive small-system verification; dense and sparse computational checks. The module supports direct verification of the finite-sample formulas developed in Paper-1 and includes controlled regression tests for the corresponding computational results. Paper-2 — Exact Distribution Laws Extends the framework from moments to structured exact-distribution calculations, including: Walsh/Krawtchouk fixed-defect methods; finite-alphabet calculations; structured exact-distribution checks; arithmetic certificates; selected GKZ / A-hypergeometric representations; complexity-boundary checks; continuation-horizon classification. The module provides computational checks for the structured classes treated in Paper-2 while preserving the distinction between exact tractable cases and broader computationally difficult cases. Paper-3 — Exact Certified Tail Computation Implements the scoped finite \(n=5\) Walsh/Clebsch exact-tail framework, including: Clebsch-graph and Walsh interaction calculations; exact hierarchy construction; \(S_5\) orbit weighting; deterministic counting and pruning checks; exact certificate verification; certified exact tail-probability calculations; preserved Paper-3 source-level reproducibility checks. The Paper-3 implementation is intentionally scoped to the stated finite \(n=5\) Walsh/Clebsch problem. It is not presented as a universal arbitrary-\(n\) exact PMF/CDF solver. Paper-4 — Identifiability, Contrast Closure, and Frozen External Testing Version v1.2.0 adds the Paper-4 computational and reproducibility layer. The Paper-4 module includes: exact rank verification for the restricted seven-parameter FR-OSI family; verification that the symmetry-compressed primary map has rank 7 and nullity 8; exact verification of the five pair and three triple contrast directions; confirmation that the primary coordinates plus eight contrasts restore full rank 15; locked retrospective benchmark calculations; frozen external four-series test calculations; preservation of the retrospective and prospective/frozen analyses as distinct datasets; reproducibility checks for the Wald, likelihood-ratio, bootstrap, and contrast results; verification of the archived historical FRED source files; SHA-256 source-integrity checks. The preserved Paper-4 reproducibility route reproduces 22/22 locked numerical checkpoints, and the recovered historical FRED source files pass 4/4 SHA-256 integrity checks. Paper-4 tests a specific restricted common-pair/common-triple four-variable log-linear interaction family. Rejection of that restriction does not identify a unique alternative model or physical mechanism. Why it is useful Instead of developing every calculation from the beginning, users can use QDL Research Suite to: run exact computations; verify mathematical identities on controlled examples; reproduce published numerical results; compare analytical formulas with computational checks; test structured finite models; inspect exact tail calculations; verify model-rank and contrast constructions; reproduce frozen external statistical tests; confirm source-data integrity; trace calculations through preserved provenance and checksum records. The package includes command-line tools, automated tests, reproducibility routines, metadata, provenance records, archived source material, and integrity information so that computational results can be independently inspected and verified. What v1.2.0 combines Version v1.2.0 brings together the tested computational layers of: Paper-1: exact permutation moments; Paper-2: structured exact distribution laws; Paper-3: certified exact tail computation; Paper-4: identifiability, contrast closure, and frozen external testing. These modules are provided under one QDL Research Suite software family rather than as separate software projects. The historical Paper-specific reproducibility packages remain part of the provenance chain and are preserved rather than being silently replaced or relabeled. For Paper-4, the original full-source-recovery reproducibility archive is retained byte-for-byte within the software provenance structure, allowing both computational and acquisition-level checks. Reproducibility and verification The v1.2.0 release has been regression-tested across all four Paper modules. The final release verification includes: 37/37 software tests passed; combined Paper-1 through Paper-4 reproduction checks passed; Paper-4 rank and contrast-closure verification passed; Paper-4 preserved full reproducibility run passed 22/22 numerical checkpoints; historical Paper-4 FRED source verification passed 4/4 SHA-256 checks. These checks are reproducibility and software-verification results. They should not be interpreted as external peer review or as proof of claims beyond the stated scope of the individual papers. What it is not QDL Research Suite is a computational and reproducibility toolbox. The software by itself does not establish: a new microscopic physical Hamiltonian; a quantum mechanism from the Paper-4 financial-sign analysis; causation; retrocausality; future-state prediction; a forecasting advantage; a nonzero physical intervention parameter; or universal validity of the restricted models studied in the papers. Paper-4 reports statistical rejection of a specified restricted interaction family on the tested datasets. It does not convert those statistical results into a physical-mechanism claim. Likewise, the Paper-3 exact-tail implementation remains scoped to its stated finite \(n=5\) problem. Who it is for QDL Research Suite may be useful to: researchers in computational mathematics and statistics; students studying exact permutation methods; researchers working with binary or finite-alphabet data; users of Walsh/Fourier and Krawtchouk methods; researchers studying exact finite distributions; researchers working with log-linear or higher-order interaction models; users interested in model identifiability and contrast analysis; engineers and data scientists who need reproducible mathematical verification; readers who want to independently reproduce the computational results of QDL Papers 1–4. In simple terms QDL Research Suite is one toolbox for checking difficult mathematics and reproducing the computational results behind QDL Papers 1, 2, 3, and 4. Paper-1 checks exact permutation moments.Paper-2 checks structured exact distributions.Paper-3 checks certified exact tail probabilities.Paper-4 checks model identifiability, contrast closure, and a frozen external statistical test. Version v1.2.0 puts all four tested computational layers into one reproducible software package so users can inspect, run, verify, and extend the calculations from a common interface.