Struct CachedRecording 

pub struct CachedRecording { /* private fields */ }

Implementations

impl CachedRecording

pub fn wrap( inner: Box<dyn RecordingSource>, budget_bytes: usize, ) -> Box<dyn RecordingSource>

Wraps inner when it is stored in chunks, keeping up to budget_bytes of decoded chunks (at least one); other sources are returned unchanged.

Trait Implementations

impl RecordingSource for CachedRecording

fn info(&self) -> &RecordingInfo

fn chunk_samples(&self) -> Option<u64>

Samples per storage chunk along time, for formats stored in independently decoded chunks (Zarr, NWB, mtscomp). Reads covering whole multiples of it, aligned to it, decode each chunk once; None when every range costs the same (memory-mapped, in-memory, procedural).

fn read( &self, channels: &[usize], samples: Range<u64>, out: &mut [f32], ) -> DspResult<()>

Reads samples of every channel in channels into out, channel-major and scaled to each channel’s unit (ChannelInfo): out[i * n..(i + 1) * n] holds channels[i], where n = samples.end - samples.start.

fn read_native( &self, samples: Range<u64>, out: &mut [f32], ) -> DspResult<MemoryOrder>

Reads samples of every channel, scaled, in the order the source stores them, and returns that order: MemoryOrder::ChannelMajor fills out as Self::read of all channels; MemoryOrder::TimeMajor fills out[t * channels + c]. Whole-recording passes (min/max summaries) use it to skip the transposition read does for time-major sources.

fn read_stored( &self, channels: &[usize], samples: Range<u64>, out: &mut [u8], ) -> DspResult<()>

Reads the stored values (info().format, little-endian, before each channel’s gain and offset) of samples of every channel in channels into out, channel-major: out holds channels.len() · n · format.bytes() bytes. Lets pipelines move compact integer samples and scale them on the device.

fn read_channel( &self, channel: usize, samples: Range<u64>, out: &mut [f32], ) -> Result<(), DspError>

fn read_chunk( &self, channels: &[usize], samples: Range<u64>, ) -> Result<SignalChunk, DspError>

Reads into a newly allocated channel-major SignalChunk.