Struct TargetDosePlan 

pub struct TargetDosePlan {
    pub target_nats: f64,
    pub seed_amplitude: f64,
    pub steer: SteerPlan,
    pub applied_probe: Option<AppliedDoseObservation>,
    pub iterations: usize,
    pub readout_kl_radius: Option<f64>,
    pub certified_attainable_upper_nats: Option<f64>,
}

A target output-KL dose on one atom’s chord, returned atomically with the exact activation-space move the caller must apply (gh#2249/#2263).

Fields

target_nats: f64

The requested dose in nats of KL.

seed_amplitude: f64

Closed-form first-order amplitude a0 = sqrt(2 q* / (dgᵀ M dg)), exact in the quadratic/in-radius regime.

steer: SteerPlan

Exact applied move at the solved amplitude, including delta, predicted dose, metric provenance, chart radius, and off-manifold audit.

applied_probe: Option<AppliedDoseObservation>

Exact directional local-Fisher dose, effective applied delta, and measured patched-forward KL at SteerPlan::amplitude. None for the pure closed-form seed. This never changes the resident metric or its status.

iterations: usize

Number of patched-forward probes consumed (0 without a callback).

readout_kl_radius: Option<f64>

READOUT-KL radius: the largest probed amplitude whose measured KL still matched its exact directional local-Fisher dose within readout_tol_rel before the first probed failure. A later accidental match cannot extend the radius past a failed point. None without a callback or when the first probe failed.

certified_attainable_upper_nats: Option<f64>

Tightest global attainable-dose upper bound certified by any applied probe in this solve. None means no global envelope was certified.

Trait Implementations

impl Clone for TargetDosePlan

fn clone(&self) -> TargetDosePlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TargetDosePlan

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

Formats the value using the given formatter.