Struct TemporalCache 

pub struct TemporalCache { /* private fields */ }

Incrementally-loaded temporal index cache.

Implementations

impl TemporalCache

pub fn new() -> Self

Create an empty temporal cache.

pub async fn from_reader<S: ByteSource>( reader: &CopcStreamingReader<S>, ) -> Result<Option<Self>, TemporalError>

Open the temporal index from a COPC reader.

Loads the temporal header and root page. Returns Ok(None) if no temporal EVLR exists in the file.

pub async fn load_header( &mut self, source: &impl ByteSource, evlr_offset: u64, evlr_count: u32, ) -> Result<bool, TemporalError>

Scan EVLRs to find the temporal EVLR and read its header. Returns false if no temporal EVLR exists.

pub async fn load_root_page( &mut self, source: &impl ByteSource, ) -> Result<(), TemporalError>

Load the root temporal page.

pub async fn load_pages_for_time_range( &mut self, source: &impl ByteSource, start: GpsTime, end: GpsTime, ) -> Result<(), TemporalError>

Load child pages that overlap a time range, pruning by subtree bounds.

pub async fn load_all_pages( &mut self, source: &impl ByteSource, ) -> Result<(), TemporalError>

Load ALL pending pages.

pub async fn query( &mut self, source: &impl ByteSource, start: GpsTime, end: GpsTime, ) -> Result<Vec<&NodeTemporalEntry>, TemporalError>

Load relevant pages and return all nodes that overlap a time range.

This is the primary query method — it ensures the right pages are loaded before returning results. Equivalent to calling load_pages_for_time_range followed by nodes_in_range, but cannot return incomplete results.

pub fn get(&self, key: &VoxelKey) -> Option<&NodeTemporalEntry>

Look up the temporal entry for a node.

pub fn nodes_in_range( &self, start: GpsTime, end: GpsTime, ) -> Vec<&NodeTemporalEntry>

Return all loaded nodes whose time range overlaps [start, end].

pub fn stride(&self) -> u32

The sampling stride (every N-th point is recorded in the index).

pub fn header(&self) -> Option<&TemporalHeader>

The parsed temporal index header, if loaded.

pub fn len(&self) -> usize

Number of loaded node entries.

pub fn is_empty(&self) -> bool

Whether no node entries have been loaded.

pub fn iter(&self) -> impl Iterator<Item = (&VoxelKey, &NodeTemporalEntry)>

Iterate all loaded entries.

Trait Implementations

impl Default for TemporalCache

fn default() -> Self

Returns the “default value” for a type.