Struct OltcControl 

pub struct OltcControl {
    pub branch_index: usize,
    pub bus_regulated: usize,
    pub v_target: f64,
    pub v_band: f64,
    pub tap_min: f64,
    pub tap_max: f64,
    pub tap_step: f64,
}

On-Load Tap Changer (OLTC) control data for a transformer branch.

An OLTC regulates the voltage at a remote (or local) bus by stepping its tap ratio in discrete increments. After Newton-Raphson converges, the solver checks each OLTC transformer:

1. If |vm[bus_regulated] - v_target| > v_band / 2, tap is stepped toward the target and NR is re-solved.
2. Steps are bounded by [tap_min, tap_max].
3. The loop terminates when all regulated bus voltages are within band or oltc_max_iter outer iterations are exhausted.

The branch_index field refers to the 0-based index into PowerNetwork::branches. The tap adjustment modifies branches[branch_index].tap in place before each NR re-solve.

Fields

branch_index: usize

0-based index into Network::branches for the transformer being controlled.

bus_regulated: usize

0-based index into Network::buses for the bus whose voltage is regulated.

May differ from the transformer’s from/to bus for remote voltage control.

v_target: f64

Voltage target in per-unit.

v_band: f64

Dead-band half-width in per-unit (control activates when |V - v_target| > v_band / 2).

tap_min: f64

Minimum allowable tap ratio in per-unit (e.g. 0.9).

tap_max: f64

Maximum allowable tap ratio in per-unit (e.g. 1.1).

tap_step: f64

Discrete tap step size in per-unit (e.g. 0.00625 = 1/160, typical 16-step OLTC).

Implementations

impl OltcControl

pub fn standard( branch_index: usize, bus_regulated: usize, v_target: f64, ) -> Self

Create a standard OLTC with symmetric ±10 % range and 16 tap steps per side.

branch_index — 0-based index of the transformer in Network::branches. bus_regulated — 0-based bus index to regulate.

Trait Implementations

impl Clone for OltcControl

fn clone(&self) -> OltcControl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OltcControl

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for OltcControl

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for OltcControl

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

where __S: Serializer,

Serialize this value into the given Serde serializer.