Struct Nc4File 

pub struct Nc4File { /* private fields */ }

An opened NetCDF-4 file (backed by HDF5).

Implementations

impl Nc4File

pub fn open(path: &Path) -> Result<Self>

Open a NetCDF-4 file from disk.

pub fn open_with_options(path: &Path, options: NcOpenOptions) -> Result<Self>

Open a NetCDF-4 file from disk with custom options.

pub fn from_bytes(data: &[u8]) -> Result<Self>

Open a NetCDF-4 file from in-memory bytes.

pub fn from_bytes_with_options( data: &[u8], options: NcOpenOptions, ) -> Result<Self>

Open a NetCDF-4 file from in-memory bytes with custom options.

pub fn from_storage(storage: DynStorage) -> Result<Self>

Open a NetCDF-4 file from a custom random-access storage backend.

pub fn from_storage_with_options( storage: DynStorage, options: NcOpenOptions, ) -> Result<Self>

Open a NetCDF-4 file from a custom random-access storage backend with custom options.

pub fn root_group(&self) -> Result<&NcGroup>

The root group.

pub fn is_classic_model(&self) -> bool

Check if this file uses the classic data model (_nc3_strict).

This checks the raw HDF5 root group attributes (before the internal attribute filter removes _nc3_strict).

pub fn dimensions(&self) -> Result<&[NcDimension]>

pub fn variables(&self) -> Result<&[NcVariable]>

pub fn global_attributes(&self) -> Result<&[NcAttribute]>

pub fn group(&self, path: &str) -> Result<&NcGroup>

pub fn variable(&self, path: &str) -> Result<&NcVariable>

pub fn dimension(&self, path: &str) -> Result<&NcDimension>

pub fn global_attribute(&self, path: &str) -> Result<&NcAttribute>

pub fn read_variable<T: H5Type>(&self, path: &str) -> Result<ArrayD<T>>

Read a variable’s data as a typed array.

Looks up the variable by path relative to the root group, then opens the matching HDF5 dataset and reads the data.

pub fn read_variable_into<T: H5Type>( &self, path: &str, dst: &mut [T], ) -> Result<()>

Read a variable into a caller-provided typed buffer.

pub fn read_variable_raw_bytes(&self, path: &str) -> Result<Vec<u8>>

Read a variable as logical raw bytes in HDF5 datatype byte order.

pub fn read_variable_raw_bytes_into( &self, path: &str, dst: &mut [u8], ) -> Result<()>

Read logical raw bytes into a caller-provided buffer.

pub fn read_variable_native_bytes(&self, path: &str) -> Result<Vec<u8>>

Read a variable as logical raw bytes with numeric fields in native endian.

pub fn read_variable_native_bytes_into( &self, path: &str, dst: &mut [u8], ) -> Result<()>

Read native-endian logical raw bytes into a caller-provided buffer.

pub fn iter_variable_chunks(&self, path: &str) -> Result<DatasetChunkIterator>

Iterate decoded HDF5 chunks for a chunked variable.

pub fn chunk_cache_stats(&self) -> ChunkCacheStats

Return current chunk-cache statistics.

pub fn read_variable_as_string(&self, path: &str) -> Result<String>

Read a string variable as a single string.

pub fn read_variable_as_strings(&self, path: &str) -> Result<Vec<String>>

Read a string variable as a flat vector of strings.

pub fn read_variable_user_defined(&self, path: &str) -> Result<ArrayD<NcValue>>

Read a variable containing NetCDF-4 user-defined values.

pub fn read_variable_user_defined_with<T, F>( &self, path: &str, decoder: F, ) -> Result<ArrayD<T>>

where F: FnMut(NcValueView<'_>) -> Result<T>,

Read a NetCDF-4 user-defined variable through a custom decoder.

pub fn read_variable_parallel<T: H5Type>(&self, path: &str) -> Result<ArrayD<T>>

pub fn read_variable_in_pool<T: H5Type>( &self, path: &str, pool: &ThreadPool, ) -> Result<ArrayD<T>>

impl Nc4File

pub fn read_variable_as_f64(&self, path: &str) -> Result<ArrayD<f64>>

Read a variable with automatic type promotion to f64.

Reads in the native HDF5 type and promotes to f64 via mapv.

pub fn read_variable_slice_as_f64( &self, path: &str, selection: &NcSliceInfo, ) -> Result<ArrayD<f64>>

Read a slice of a variable with automatic type promotion to f64.

pub fn read_variable_slice<T: H5Type>( &self, path: &str, selection: &NcSliceInfo, ) -> Result<ArrayD<T>>

Read a typed slice of a variable (NC4 delegation).

pub fn read_variable_slice_parallel<T: H5Type>( &self, path: &str, selection: &NcSliceInfo, ) -> Result<ArrayD<T>>

Read a typed slice of a variable using chunk-level parallelism.

Chunked datasets decompress overlapping chunks in parallel via Rayon. Non-chunked layouts fall back to read_variable_slice.