Struct EvalConfig 

pub struct EvalConfig {

    pub enable_parallel: bool,
    pub max_threads: Option<usize>,
    pub max_vertices: Option<usize>,
    pub max_eval_time: Option<Duration>,
    pub max_memory_mb: Option<usize>,
    pub default_sheet_name: String,
    pub case_sensitive_names: bool,
    pub case_sensitive_tables: bool,
    pub workbook_seed: u64,
    pub volatile_level: VolatileLevel,
    pub deterministic_mode: DeterministicMode,
    pub range_expansion_limit: usize,
    pub max_open_ended_rows: u32,
    pub max_open_ended_cols: u32,
    pub stripe_height: u32,
    pub stripe_width: u32,
    pub enable_block_stripes: bool,
    pub spill: SpillConfig,
    pub use_dynamic_topo: bool,
    pub pk_visit_budget: usize,
    pub pk_compaction_interval_ops: u64,
    pub max_layer_width: Option<usize>,
    pub pk_reject_cycle_edges: bool,
    pub sheet_index_mode: SheetIndexMode,
    pub warmup: WarmupConfig,
    pub arrow_storage_enabled: bool,
    pub delta_overlay_enabled: bool,
    pub write_formula_overlay_enabled: bool,
    pub max_overlay_memory_bytes: Option<usize>,
    pub date_system: DateSystem,
    pub formula_parse_policy: FormulaParsePolicy,
    pub defer_graph_building: bool,
    pub enable_virtual_dep_telemetry: bool,
}

Configuration for the evaluation engine

Fields

enable_parallel: bool

max_threads: Option<usize>

max_vertices: Option<usize>

max_eval_time: Option<Duration>

max_memory_mb: Option<usize>

default_sheet_name: String

Default sheet name used when no sheet is provided.

case_sensitive_names: bool

When false, resolve defined names case-insensitively (ASCII only).

This matches Excel behavior for defined names.

case_sensitive_tables: bool

When false, resolve table names case-insensitively (ASCII only).

This matches Excel behavior for native table (ListObject) names.

workbook_seed: u64

Stable workbook seed used for deterministic RNG composition

volatile_level: VolatileLevel

Volatile granularity for RNG seeding and re-evaluation policy

deterministic_mode: DeterministicMode

Deterministic evaluation configuration (clock/timezone injection).

range_expansion_limit: usize

Ranges with size <= this limit are expanded into individual Cell dependencies

max_open_ended_rows: u32

Fallback maximum row bound for open-ended references (e.g. A:A, A1:A).

This is only used when used-bounds cannot be determined.

max_open_ended_cols: u32

Fallback maximum column bound for open-ended references (e.g. 1:1, A1:1).

This is only used when used-bounds cannot be determined.

stripe_height: u32

Height of stripe blocks for dense range indexing

stripe_width: u32

Width of stripe blocks for dense range indexing

enable_block_stripes: bool

Enable block stripes for dense ranges (vs row/column stripes only)

spill: SpillConfig

Spill behavior configuration (conflicts, bounds, buffering)

use_dynamic_topo: bool

Use dynamic topological ordering (Pearce-Kelly algorithm)

pk_visit_budget: usize

Maximum nodes to visit before falling back to full rebuild

pk_compaction_interval_ops: u64

Operations between periodic rank compaction

max_layer_width: Option<usize>

Maximum width for parallel evaluation layers

pk_reject_cycle_edges: bool

If true, reject edge insertions that would create a cycle (skip adding that dependency). If false, allow insertion and let scheduler handle cycles at evaluation time.

sheet_index_mode: SheetIndexMode

Sheet index build strategy for bulk loads

warmup: WarmupConfig

Warmup configuration for global pass planning (Phase 1)

arrow_storage_enabled: bool

Enable Arrow-backed storage reads (Phase A)

delta_overlay_enabled: bool

Enable delta overlay for Arrow sheets (Phase C)

write_formula_overlay_enabled: bool

Mirror formula scalar results into Arrow overlay for Arrow-backed reads This enables Arrow-only RangeView correctness without Hybrid fallback.

max_overlay_memory_bytes: Option<usize>

Optional memory budget (in bytes) for formula/spill computed Arrow overlays.

When set, the engine will compact computed overlays into base lanes when the estimated usage exceeds this cap.

date_system: DateSystem

Workbook date system: Excel 1900 (default) or 1904.

formula_parse_policy: FormulaParsePolicy

Policy for malformed formulas encountered during ingest/graph-build.

defer_graph_building: bool

Defer dependency graph building: ingest values immediately but stage formulas for on-demand graph construction during evaluation.

enable_virtual_dep_telemetry: bool

Enable virtual dependency convergence telemetry collection.

When disabled, the engine avoids per-pass timing/edge-count bookkeeping.

Implementations

impl EvalConfig

pub fn with_range_expansion_limit(self, limit: usize) -> Self

pub fn with_parallel(self, enable: bool) -> Self

pub fn with_block_stripes(self, enable: bool) -> Self

pub fn with_case_sensitive_names(self, enable: bool) -> Self

pub fn with_case_sensitive_tables(self, enable: bool) -> Self

pub fn with_arrow_storage(self, enable: bool) -> Self

pub fn with_delta_overlay(self, enable: bool) -> Self

pub fn with_formula_overlay(self, enable: bool) -> Self

pub fn with_date_system(self, system: DateSystem) -> Self

pub fn with_formula_parse_policy(self, policy: FormulaParsePolicy) -> Self

pub fn with_virtual_dep_telemetry(self, enable: bool) -> Self

Trait Implementations

impl Clone for EvalConfig

fn clone(&self) -> EvalConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EvalConfig

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

Formats the value using the given formatter.

impl Default for EvalConfig

fn default() -> Self

Returns the “default value” for a type.