Struct ResolvedExchangeFactors 

pub struct ResolvedExchangeFactors { /* private fields */ }

Pre-resolved per-block exchange capacity factors.

Provides O(1) lookup of exchange factors by (line_index, stage_index, block_index) returning (direct_factor, reverse_factor). Returns (1.0, 1.0) for absent entries. Populated by cobre-io during the resolution step and stored in crate::System.

Examples

use cobre_core::resolved::ResolvedExchangeFactors;

let empty = ResolvedExchangeFactors::empty();
assert_eq!(empty.factors(0, 0, 0), (1.0, 1.0));

Implementations

impl ResolvedExchangeFactors

pub fn empty() -> Self

Create an empty exchange factors table. All lookups return (1.0, 1.0).

Used as the default when no exchange_factors.json exists.

Examples

use cobre_core::resolved::ResolvedExchangeFactors;

let t = ResolvedExchangeFactors::empty();
assert_eq!(t.factors(5, 3, 2), (1.0, 1.0));

pub fn new(n_lines: usize, n_stages: usize, max_blocks: usize) -> Self

Create a new exchange factors table with the given dimensions.

All entries are initialized to (1.0, 1.0) (no scaling). Use set to populate individual entries.

pub fn set( &mut self, line_idx: usize, stage_idx: usize, block_idx: usize, direct_factor: f64, reverse_factor: f64, )

Set the exchange factors for a specific (line_idx, stage_idx, block_idx) triple.

Panics

Panics if any index is out of bounds.

pub fn factors( &self, line_idx: usize, stage_idx: usize, block_idx: usize, ) -> (f64, f64)

Look up the exchange factors for a (line_idx, stage_idx, block_idx) triple.

Returns (direct_factor, reverse_factor). Returns (1.0, 1.0) when the index is out of bounds or the table is empty.

Trait Implementations

impl Clone for ResolvedExchangeFactors

fn clone(&self) -> ResolvedExchangeFactors

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResolvedExchangeFactors

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

Formats the value using the given formatter.

impl PartialEq for ResolvedExchangeFactors

fn eq(&self, other: &ResolvedExchangeFactors) -> 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 StructuralPartialEq for ResolvedExchangeFactors