Struct DistributedSlack 

pub struct DistributedSlack { /* private fields */ }

Moves the slack’s deviation from its own schedule onto the participating generators, by normalized weight, until the deviation is inside tolerance.

Reports Invalidates::Nothing: only p_spec changes between passes, so bus types, n_unknowns and the Jacobian’s sparsity pattern all hold and the solver keeps its symbolic factorization across the whole loop. That is the opposite of ReactiveLimits, which switches PV → PQ and must reset each time it does.

What it mutates

buses[i].p_spec ends up holding the dispatched value rather than the schedule it went in with, for every participating bus. That is the answer — who ended up producing what — and SlackDistributionReport::shift records how far each moved, so the original is recoverable.

Implementations

impl DistributedSlack

pub fn new(distribution: SlackDistribution) -> Self

pub fn report(&self) -> &SlackDistributionReport

What it did, readable after the solve.

pub fn into_report(self) -> SlackDistributionReport

Consumes the loop for its report, for callers that do not need it back.

Trait Implementations

impl Clone for DistributedSlack

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DistributedSlack

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

Formats the value using the given formatter.

impl OuterLoop for DistributedSlack

fn name(&self) -> &'static str

fn invalidates(&self) -> Invalidates

What this loop invalidates when it reports OuterLoopStatus::Unstable. Read by the driver, which then resets or restamps as required. See the module docs.

fn initialize(&mut self, ctx: &mut OuterLoopContext<'_, '_>)

Called once, before the first solve, with the network in its initial state. The place to record starting tap positions or bus types.

fn check(&mut self, ctx: &mut OuterLoopContext<'_, '_>) -> OuterLoopStatus

Look at the converged state and either accept it or change something.