Struct BufferPool 

pub struct BufferPool {
    pub pools: HashMap<usize, Vec<Vec<f64>>>,
    pub cap_per_bucket: usize,
}

Pool of reusable Vec<f64> allocations, bucketed by capacity (power of two).

This is used by the CPU-shadow (stub) path to avoid repeated heap allocation when the same buffer sizes are recycled across simulation steps.

Fields

pools: HashMap<usize, Vec<Vec<f64>>>

Map from power-of-two bucket size → list of free buffers.

cap_per_bucket: usize

Maximum number of free buffers to retain per bucket before dropping.

Implementations

impl BufferPool

pub fn new() -> Self

Create a new pool with a default per-bucket cap of 64.

pub fn alloc(&mut self, len: usize) -> Vec<f64>

Allocate a buffer of at least len elements.

If a free buffer of the correct power-of-two bucket size exists it is returned directly (contents may be stale); otherwise a fresh zero-filled allocation is made.

pub fn free(&mut self, len: usize, buf: Vec<f64>)

Return a buffer to the pool for future reuse.

If the pool for this bucket is already at capacity, the buffer is silently dropped (deallocated).

pub fn total_free(&self) -> usize

Return the number of free buffers currently held by the pool.

pub fn clear(&mut self)

Clear all pooled buffers, releasing memory back to the allocator.

Trait Implementations

impl Default for BufferPool

fn default() -> Self

Returns the “default value” for a type.