Workflow

Run Analysis

Run Analysis is the main one-dimensional precision workflow. It reads the controller state, builds the active timing model, computes ideal and instrument-specific theory curves, optionally validates them with Monte Carlo, and refreshes the diagnostics and estimator-tracking widgets with the same sweep context.

Theory path

For specialists

The desktop calls DigitalTwinService.run_precision(). The service patches a temporary PhysicsConfig, builds the x-grid, computes the ideal reference, computes the instrument theory path, and packages the payloads needed by the precision, accuracy, and diagnostics widgets.

The current theory path separates:

  • conditional precision on collected photons
  • photon survival / reporting basis
  • detector-transfer approximation versus explicit event-driven simulation

Monte Carlo validation

When enabled, Monte Carlo validation runs the estimator repeatedly across the same x-grid and compares the empirical estimator behaviour to the theory path. The payload now includes conditional F, survival eta, compatible/incompatible flags, and optional bootstrap confidence intervals.

Photon basis and rescaling

The collected-photon result is canonical. Toggling Compute F-value on changes the reporting basis, not the collected-photon estimator. In many cases this means cached results can be rescaled without recomputing the underlying sweep.

Outputs

OutputWhere it appearsMeaning
Ideal referencePrecision widgetReference ceiling for the active sweep/grid interpretation.
Theory curvePrecision widgetExpected performance of the configured instrument.
Monte Carlo points and CIsPrecision widgetEmpirical validation of the theory path.
Estimator trackingMLE Accuracy widgetEstimated-vs-truth view of estimator bias and spread.
Reference PDF and gatesInstrument DiagnosticsTiming-domain explanation of the current result.