sidescanpy.io.netcdf.reader

Read a SideScanFrequencyChannel from a NetCDF (.nc) file.

Uses h5netcdf engine. Pass chunks= for lazy/dask-backed loading.

2026 rshomberg@uri.edu

Contents

read_frequency_channel

Read a NetCDF file back into a SideScanFrequencyChannel.

sidescanpy.io.netcdf.reader.read_frequency_channel(path, *, chunks=None)

Read a NetCDF file back into a SideScanFrequencyChannel.

Parameters:

pathPath or str

Source file path.

chunksdict, optional

Pass to xr.open_dataset for lazy loading via dask. e.g. chunks={"ping": 256}. None (default) loads eagerly.

Returns:

SideScanFrequencyChannel

Validated channel wrapper around the loaded dataset.

Raises:

FileNotFoundError

If path does not exist.

ValueError

If the loaded dataset fails schema validation.