Struct TiffLoadInfo 

pub struct TiffLoadInfo {
    pub n_files: usize,
    pub n_chunks: usize,
    pub chunk_ids: Vec<u64>,
    pub chunks_summed: bool,
    pub n_clipped_pixels: usize,
    pub n_unrecognized_files: usize,
    pub unrecognized_examples: Vec<String>,
    pub chunk_inconsistent: bool,
}

Provenance metadata about a completed TIFF load.

Fields

n_files: usize

Number of TIFF files read (1 for a single multi-frame file).

n_chunks: usize

Number of DAQ chunks detected (0 when the folder does not follow the chunked <prefix>_<chunk>_<frame> naming convention).

chunk_ids: Vec<u64>

Detected chunk identifiers, ascending (empty when n_chunks == 0).

chunks_summed: bool

Whether chunks were summed element-wise into a single stack.

n_clipped_pixels: usize

Number of negative pixels clamped to zero. Only ever nonzero under PixelValuePolicy::ClipToZero.

n_unrecognized_files: usize

Number of files that did not parse as <prefix>_<chunk>_<frame> while at least one other file in the same folder did — a mixed folder, where the non-conforming files disabled chunk detection and forced the legacy lexicographic load. 0 in every other path: single-file loads, fully chunk-patterned folders, folders where no file matches the convention (the normal frame_0000.tif world), and multi-prefix folders (every stem parses; a different, documented fallback).

unrecognized_examples: Vec<String>

Lexicographically-first filenames of the non-conforming files, capped at MAX_UNRECOGNIZED_EXAMPLES entries so the provenance stays message-sized. Empty iff n_unrecognized_files == 0.

chunk_inconsistent: bool

Whether the folder’s chunk-patterned files were internally inconsistent (ragged frame counts/sets or a duplicate (chunk, frame) pair) yet were still loaded, as the legacy lexicographic concatenation, because the caller opted out of summing (TiffFolderOptions::sum_chunks = false). This is a distinct signal from n_unrecognized_files: the files do follow <prefix>_<chunk>_<frame>, they just do not agree on a common frame set. Always false on the summing path — there the same inconsistency is a hard IoError::ChunkMismatch error, because summing ragged chunks would silently corrupt counts.

Trait Implementations

impl Clone for TiffLoadInfo

fn clone(&self) -> TiffLoadInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TiffLoadInfo

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

Formats the value using the given formatter.

impl PartialEq for TiffLoadInfo

fn eq(&self, other: &TiffLoadInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for TiffLoadInfo

impl StructuralPartialEq for TiffLoadInfo