Struct ProtectionTester 

pub struct ProtectionTester {
    pub relay_config: RelayTestConfig,
    pub simulation_noise_pct: f64,
    pub seed: u64,
}

Main protection testing engine.

Simulates relay operation with configurable LCG-based timing noise so that test suites are repeatable yet realistic.

Noise model

actual_time = ideal_time × (1 + noise_pct × (u − 0.5)) where u ∈ [0,1) is drawn from a Linear Congruential Generator.

Fields

relay_config: RelayTestConfig

Relay configuration (settings, ratios, characteristic).

simulation_noise_pct: f64

Fractional timing noise amplitude (e.g. 0.005 = ±0.25 %).

seed: u64

Internal LCG state for reproducible pseudo-randomness.

Implementations

impl ProtectionTester

pub fn new(relay_config: RelayTestConfig) -> Self

Create a new tester with default 0.5 % noise.

pub fn compute_expected_operate_time(&self, current_a: f64) -> f64

Compute the expected relay operating time for current_a [A secondary].

The formula is selected by RelayTestConfig::characteristic:

Key	Formula (t in seconds)
IEC_SI	TDS × 0.14 / ((I/Is)^0.02 − 1)
IEC_VI	TDS × 13.5 / ((I/Is) − 1)
IEC_EI	TDS × 80 / ((I/Is)² − 1)
ANSI_MI	TDS × (0.0515/((I/Is)^0.02−1) + 0.114)

Returns milliseconds. Returns 0.0 when current ≤ pickup and f64::INFINITY when the denominator is numerically zero.

pub fn simulate_relay_operation(&mut self, case: &TestCase) -> (bool, f64)

Simulate relay operation for a test case.

Returns (operated: bool, operate_time_ms: f64).

If operated is false, operate_time_ms is 0.0.

pub fn run_test_case(&mut self, case: &TestCase) -> TestResult

Execute a single test case and return its result.

pub fn run_suite<'s>(&mut self, suite: &'s mut TestSuite) -> &'s TestSuite

Run all test cases in a TestSuite and update its counters.

Returns a shared reference to the (now populated) suite.

pub fn generate_pickup_tests(&self) -> Vec<TestCase>

Generate pickup verification tests at 0.8×, 0.9×, 1.0×, 1.05×, 1.1×, 1.5× pickup.

Tests at or below pickup expect no operation; tests above expect operation. Produces exactly 6 test cases.

pub fn generate_timing_tests(&self, multiples: &[f64]) -> Vec<TestCase>

Generate timing tests at the specified current multiples of the pickup setting.

Typically called with &[2.0, 5.0, 10.0, 20.0]. Tolerance is the larger of 5 % of the expected time or 20 ms.

pub fn generate_characteristic_tests(&self, n_points: usize) -> Vec<TestCase>

Generate n_points characteristic curve test cases distributed on a logarithmic scale from 1.05× to 20× pickup.

Returns an empty Vec when n_points == 0.

Trait Implementations

impl Clone for ProtectionTester

fn clone(&self) -> ProtectionTester

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProtectionTester

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

Formats the value using the given formatter.