Struct Directory 

pub struct Directory { /* private fields */ }

In-memory directory covering all posting blocks for a dimension.

Unlike DirectoryBlock (a single on-disk part limited to u16 entries), Directory holds the complete (max_offset, max_weight) list with no size restriction. It is the owner on both the write and read paths:

• Write: accumulate entries, then call [into_parts] to produce Vec<DirectoryBlock> sized for the blockfile.
• Read: load DirectoryBlock parts, then call [from_parts] to get back the full Directory.

Implementations

impl Directory

pub fn new( max_offsets: Vec<u32>, max_weights: Vec<f32>, ) -> Result<Self, SparsePostingBlockError>

Create a directory from per-posting-block metadata.

pub fn from_parts( parts: impl IntoIterator<Item = DirectoryBlock>, ) -> Result<Self, SparsePostingBlockError>

Reconstruct a directory from on-disk DirectoryBlock parts.

pub fn into_parts(self, max_entries_per_part: usize) -> Vec<DirectoryBlock>

Split into DirectoryBlock parts that each fit within a block-size budget.

Use [max_entries_for_block_size] to derive max_entries_per_part from the blockfile’s max_block_size_bytes.

pub fn max_offsets(&self) -> &[u32]

pub fn max_weights(&self) -> &[f32]

pub fn dim_max_weight(&self) -> f32

Dimension-level maximum weight (max of all per-block max_weights).

pub fn num_blocks(&self) -> usize

Number of posting blocks summarized.

pub fn max_entries_for_block_size(max_block_size_bytes: usize) -> usize

Maximum directory entries per DirectoryBlock part that fit within max_block_size_bytes.

Each entry is 8 bytes (u32 offset + f32 weight) plus a 16-byte header per part. A fixed headroom is reserved for Arrow per-row overhead (offset buffers, prefix/key columns, alignment padding).

Trait Implementations

impl Clone for Directory

fn clone(&self) -> Directory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Directory

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

Formats the value using the given formatter.