pub fn load_tiff_folder_with_options(
dir: &Path,
pattern: Option<&str>,
options: &TiffFolderOptions,
) -> Result<(Array3<f64>, TiffLoadInfo), IoError>Expand description
Load a directory of TIFFs matching a glob pattern, returning provenance metadata.
Behaves like load_tiff_folder (same extension guard and glob pattern
semantics), with two additions:
- chunked-folder detection and element-wise chunk summing (see the
module docs and
TiffFolderOptions::sum_chunks); - a
TiffLoadInforeport of what was loaded.
§Arguments
dir— Path to the directory containing TIFF files.pattern— Optional glob pattern to filter filenames.options— Loading options (chunk summing).
§Returns
(stack, info) where stack has shape (n_frames, height, width).
§Errors
IoError::FileNotFoundifdirdoes not exist.IoError::NotADirectoryifdirexists but is not a directory.IoError::NoMatchingFilesif no files match the pattern.IoError::DimensionMismatchif frames have inconsistent dimensions.IoError::ChunkMismatchif a chunked folder is internally inconsistent (ragged chunks or duplicate (chunk, frame) pairs) andoptions.sum_chunksistrue. Withsum_chunks = falsethe same inconsistency is not raised: the files load as the legacy lexicographic concatenation andTiffLoadInfo::chunk_inconsistentis set.