Struct ExecutionContext 

pub struct ExecutionContext { /* private fields */ }

Shared controls passed through every stage of an out-of-core operation.

Implementations

impl ExecutionContext

pub fn builder() -> ExecutionContextBuilder

Starts a declarative context builder with bounded defaults.

pub const fn image_search_limit(&self) -> usize

The most candidate symmetry images a crystal search may examine.

A crystal environment is found by trying every symmetry operation and lattice translation that could bring a copy within reach, so the work grows with the unit’s extent as well as its atom count. Exceeding the limit is an error, never a silent truncation; raise it deliberately after reviewing the cost.

pub fn memory_budget(&self) -> MemoryBudget

Returns this context’s execution-memory ceiling.

pub const fn worker_budget(&self) -> usize

Maximum native tasks one operation may submit to the shared pool.

pub const fn cancellation(&self) -> &CancellationToken

Returns the shared cooperative cancellation token.

pub const fn scratch_policy(&self) -> ScratchPolicy

Returns the reusable scratch policy.

pub const fn temp_storage_policy(&self) -> &TempStoragePolicy

Returns the temporary-storage policy.

pub fn create_spill_file(&self, key: &str) -> Result<SpillFile, SpillError>

Creates one bounded, execution-owned spill file.

The key becomes the deterministic file name below the configured root. A file with the same key is never overwritten.

Errors

Returns SpillError::Disabled when spill is not configured, or a storage error when the key, disk budget, or destination is invalid.

pub fn spill_bytes(&self) -> u64

Returns temporary bytes currently retained by this execution graph.

pub fn total_spilled_bytes(&self) -> u64

Total physical bytes written to execution-owned spill files.

pub fn reserved_bytes(&self) -> usize

Bytes currently retained by execution-owned allocations.

pub fn peak_reserved_bytes(&self) -> usize

Highest number of execution-owned bytes retained concurrently.

pub fn live_batches(&self) -> usize

Batch leases that are currently alive.

pub fn peak_live_batches(&self) -> usize

Highest number of batch leases alive concurrently.

pub fn try_reserve( &self, bytes: usize, ) -> Result<MemoryReservation, MemoryBudgetError>

Charges retained bytes against this context until the result is dropped.

Errors

Returns MemoryBudgetError::Exhausted when the requested bytes do not fit alongside current reservations.

Trait Implementations

impl Clone for ExecutionContext

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 ExecutionContext

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

Formats the value using the given formatter.

impl Default for ExecutionContext

fn default() -> Self

Returns the “default value” for a type.