Struct ResearchOutcome 

pub struct ResearchOutcome {
    pub status: ResearchStatus,
    pub max_effect_ns: f64,
    pub max_effect_ci: (f64, f64),
    pub theta_floor: f64,
    pub detectable: bool,
    pub model_mismatch: bool,
    pub effect: EffectEstimate,
    pub samples_used: usize,
    pub quality: MeasurementQuality,
    pub diagnostics: Diagnostics,
}

Research mode outcome (spec v4.1 research mode).

This struct is returned when using AttackerModel::Research. Unlike the standard Outcome which makes Pass/Fail decisions, research mode characterizes the timing behavior relative to the measurement floor.

Key differences from standard mode:

• No Pass/Fail verdict (no threshold comparison)
• Reports measurement floor (theta_floor) at final sample size
• detectable field indicates if CI lower bound > floor
• model_mismatch is non-blocking (tracked but doesn’t stop analysis)

Fields

status: ResearchStatus

Research outcome status.

max_effect_ns: f64

Maximum effect across quantiles: max_k |(Xβ)_k| in nanoseconds. This is the posterior mean of the maximum absolute predicted effect.

max_effect_ci: (f64, f64)

95% credible interval for maximum effect: (2.5th, 97.5th percentile).

theta_floor: f64

Measurement floor at final sample size. This is the minimum detectable effect given measurement noise.

detectable: bool

True if the effect is detectable: CI lower bound > theta_floor.

model_mismatch: bool

True if model mismatch was detected (Q > q_thresh). In research mode, this is non-blocking but adds a caveat to interpretation.

effect: EffectEstimate

Effect size estimate with decomposition. If model_mismatch is true, interpretation_caveat will be set.

samples_used: usize

Number of samples used.

quality: MeasurementQuality

Measurement quality assessment.

diagnostics: Diagnostics

Diagnostic information.

Implementations

impl ResearchOutcome

pub fn is_effect_detected(&self) -> bool

Check if a timing effect was confidently detected.

pub fn is_no_effect_detected(&self) -> bool

Check if no effect was confidently detected.

pub fn is_resolution_limit_reached(&self) -> bool

Check if the resolution limit was reached.

pub fn has_quality_issue(&self) -> bool

Check if there was a quality issue.

pub fn effect(&self) -> &EffectEstimate

Get the effect estimate.

pub fn quality(&self) -> MeasurementQuality

Get the measurement quality.

pub fn diagnostics(&self) -> &Diagnostics

Get the diagnostics.

Trait Implementations

impl Clone for ResearchOutcome

fn clone(&self) -> ResearchOutcome

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResearchOutcome

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ResearchOutcome

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ResearchOutcome

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for ResearchOutcome

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.