Struct ResolvedNcsFactors 

pub struct ResolvedNcsFactors { /* private fields */ }

Pre-resolved per-block NCS generation scaling factors.

Provides O(1) lookup of the generation factor by (ncs_index, stage_index, block_index). Returns 1.0 for absent entries (no scaling). Populated by cobre-io during the resolution step and stored in crate::System.

Uses dense 3D storage (n_ncs * n_stages * max_blocks) initialized to 1.0. The total size is small (typically < 10K entries) and the lookup is on the LP-building hot path.

Examples

use cobre_core::resolved::ResolvedNcsFactors;

let empty = ResolvedNcsFactors::empty();
assert!((empty.factor(0, 0, 0) - 1.0).abs() < f64::EPSILON);

Implementations

impl ResolvedNcsFactors

pub fn empty() -> Self

Create an empty NCS factors table. All lookups return 1.0.

Used as the default when no non_controllable_factors.json exists.

Examples

use cobre_core::resolved::ResolvedNcsFactors;

let t = ResolvedNcsFactors::empty();
assert!((t.factor(5, 3, 2) - 1.0).abs() < f64::EPSILON);

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

Create a new NCS factors table with the given dimensions.

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

pub fn set( &mut self, ncs_idx: usize, stage_idx: usize, block_idx: usize, value: f64, )

Set the NCS factor for a specific (ncs_idx, stage_idx, block_idx) triple.

Panics

Panics if any index is out of bounds.

pub fn factor(&self, ncs_idx: usize, stage_idx: usize, block_idx: usize) -> f64

Look up the NCS factor for a (ncs_idx, stage_idx, block_idx) triple.

Returns 1.0 when the index is out of bounds or the table is empty.

Trait Implementations

impl Clone for ResolvedNcsFactors

fn clone(&self) -> ResolvedNcsFactors

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResolvedNcsFactors

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

Formats the value using the given formatter.

impl PartialEq for ResolvedNcsFactors

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