Struct LoopConfig 

pub struct LoopConfig {
    pub process_type: ProcessType,
    pub controller_type: ControllerType,
    pub relay_amp_percent: f32,
    pub num_cycles_skip: u32,
    pub num_cycles_count: u32,
    pub noise_protection_secs: u32,
    pub mrft_delay_secs: u32,
}

Fields

process_type: ProcessType

controller_type: ControllerType

relay_amp_percent: f32

Relay amplitude as a percentage of the MV range. Not enforced by the type itself – call LoopConfig::validate on a LoopConfig built from external input (CLI flags, an imported template) before using it, to catch an out-of-range value before it reaches a live loop.

num_cycles_skip: u32

num_cycles_count: u32

noise_protection_secs: u32

mrft_delay_secs: u32

Pre/post-test recording padding, in seconds. PV is still read and recorded during this period; no switch evaluation happens.

Implementations

impl LoopConfig

pub const RELAY_AMP_PERCENT_MIN: f32 = 0.1

Minimum allowed relay_amp_percent. A relay step smaller than this is not a meaningfully-sized perturbation to reliably induce a detectable oscillation, and is far more likely to be a data-entry slip (a misplaced decimal point) than a genuine choice.

pub const RELAY_AMP_PERCENT_MAX: f32 = 50.0

Maximum allowed relay_amp_percent. Half of the entire MV span in a single relay step is already an unusually aggressive, disruptive perturbation to a live process – legitimate tunes use single-digit to low-double-digit percentages. A value above this is far more likely to be a mistake than a deliberate choice; this is exactly the failure mode this bound closes off, where an unvalidated field let a stray four-digit debug shortcut reach a live control loop as a “relay amplitude”.

pub const MRFT_DELAY_SECS_MAX: u32 = 3600

Maximum allowed mrft_delay_secs. Chosen to match the built-in whole-run timeout (one hour): genuine pre/post-test recording padding is realistically a few minutes at most, so anything larger is far more likely a units mistake (e.g. milliseconds typed as seconds) than a deliberate choice.

pub fn with_process_type(self, process_type: ProcessType) -> LoopConfig

Applies process_type’s default skip/test/noise-protection values, keeping the existing controller_type, relay_amp_percent, and mrft_delay_secs. Downgrades controller_type from PID to PI if the new process type doesn’t allow PID.

pub fn validate(&self) -> Result<(), LoopConfigError>

Validates fields whose legality can’t be expressed in the type system alone: relay amplitude against [RELAY_AMP_PERCENT_MIN, RELAY_AMP_PERCENT_MAX], num_cycles_count must be at least 1 (zero previously reached tuning_math::measure_oscillation’s internal assert! and panicked mid-run, after the loop had already been switched to manual and stroked – see docs/internal/v1-checklist.md §2), and mrft_delay_secs against MRFT_DELAY_SECS_MAX. This is real range validation at the model/construction level, not just a client-side keystroke filter or a single “not blank” check, so it applies no matter how the LoopConfig was built (CLI flags, an imported template, or a future web GUI request).

Trait Implementations

impl Clone for LoopConfig

fn clone(&self) -> LoopConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for LoopConfig

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Copy for LoopConfig

impl Debug for LoopConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LoopConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LoopConfig

fn eq(&self, other: &LoopConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for LoopConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for LoopConfig

impl ToSchema for LoopConfig

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference [utoipa::openapi::schema::Schema]s for this type.