Skip to content

Choose an Analysis Path

OpenEntropy analysis is exposed through two execution surfaces:

SurfaceEntry pointWhat it controls
Dispatcher APIopenentropy_core::dispatcher::analyzeforensic, entropy, chaos, trials, cross_correlation
CLI analyze commandopenentropy analyzeDispatcher modules plus CLI-only toggles: --temporal, --statistics, --synchrony, --chaos-extended

Use this page as the hub, then jump to focused deep-dive pages.

Terminal window
openentropy analyze --profile quick
openentropy analyze --profile deep
openentropy analyze --profile security
from openentropy import analyze
report = analyze([("my_source", data)], profile="deep")
use openentropy_core::dispatcher::{analyze, AnalysisProfile};
let report = analyze(&[("my_source", &data)], &AnalysisProfile::Deep.to_config());

CLI profiles (openentropy analyze):

ProfileForensicEntropyChaos CoreChaos ExtendedTemporalStatisticsSynchronyTrialsCross-Corr
quick—*
standard—*
deep—*
security—*

Dispatcher profiles (openentropy_core::dispatcher::AnalysisProfile and Python analyze(profile=...)):

ProfileForensicEntropyChaosTrialsCross-Corr
quick
standard
deep
security

* Synchrony always requires 2+ streams and is enabled explicitly with --synchrony (CLI) or direct synchrony APIs.

Start with the question you are trying to answer:

If your question is…UseWhy
”Is this source healthy at a basic level?”Forensic AnalysisBaseline checks: autocorrelation, spectral flatness, bias, distribution, stationarity, runs
”How much entropy density does this source have?”Entropy BreakdownMulti-estimator min-entropy view and grade
”Are two sources independent enough to combine?”Cross-CorrelationPairwise correlation matrix and flagged pairs
”Do I trust PASS/WARN/FAIL quickly?”Verdict SystemThreshold model used by CLI and reports
”Is behavior drifting over time?”Temporal AnalysisChange points, anomalies, bursts, shifts, drift
”Are there formal dependence/goodness-of-fit issues?”Statistics AnalysisCramer-von Mises, Ljung-Box, gap, group tests
”Are two streams coupled or event-synchronized?”Synchrony AnalysisMutual information, coherence proxy, cross-sync, global events
”Is this random-looking output actually structured/chaotic?”Chaos Theory AnalysisCore + extended entropy/complexity methods
”How stable is deviation across repeated 200-bit trials?”Trial Analysis MethodologyPEAR-style trial framing and Stouffer combination

For most users:

  1. Start with openentropy analyze --profile security for security validation or --profile deep for research.
  2. Review Forensic Analysis and Entropy Breakdown first.
  3. Use Verdict System for triage, then inspect raw metrics on any WARN/FAIL.
  4. Add advanced modules only when needed: temporal/statistics/synchrony/chaos/trials.

The expanded analysis inventory in OpenEntropy was informed by the open-source work in vikingdude81/qrng-analysis-toolkit.