navigate.model.data_sources.bdv_data_source.BigDataViewerDataSource

class navigate.model.data_sources.bdv_data_source.BigDataViewerDataSource(file_name: Optional[str] = None, mode: str = 'w')

Bases: PyramidalDataSource

BigDataViewer data source.

This class is used to write data to a BigDataViewer-compatible file. It supports both HDF5 and N5 file formats.

__init__(file_name: Optional[str] = None, mode: str = 'w') → None

Initializes the BigDataViewerDataSource.

Parameters:

• file_name (str) – The name of the file to write to.

• mode (str) – The mode to open the file in. Must be “w” for write or “r” for read.

Methods

__init__([file_name, mode])	Initializes the BigDataViewerDataSource.
close()	Close the image file.
get_shape_from_metadata()	Get the shape of the data source from the metadata.
get_slice(x, y, c[, z, t, p, subdiv])	Get a 3D slice of the dataset for a single c, t, p, subdiv.
read()	Reads data from the image file.
set_metadata(metadata_config)	Sets the metadata
set_metadata_from_configuration_experiment(...)	Sets the metadata from according to the microscope configuration.
setup()	Additional steps for establishing the initial file setup.
write(data, **kw)	Writes 2D image to the data source.

Attributes

data	Return array representation of data stored in data source.
mode	Getter for the mode of the data source.
nbytes	Getter for image size.
resolutions	Getter for resolutions.
shape	Getter for the shape as XYCZT.
shapes	Getter for image shape.
subdivisions	Getter for subdivisions.
voxel_size	Getter for the voxel size
image	The image.
metadata	The metadata.

close() → None

Close the image file.

get_shape_from_metadata()

Get the shape of the data source from the metadata.

get_slice(x, y, c, z=0, t=0, p=0, subdiv=0) → Union[_SupportsArray[dtype], _NestedSequence[_SupportsArray[dtype]], bool, int, float, complex, str, bytes, _NestedSequence[Union[bool, int, float, complex, str, bytes]]]

Get a 3D slice of the dataset for a single c, t, p, subdiv.

Parameters:

• x (int or slice) – x indices to grab

• y (int or slice) – y indices to grab

• c (int) – Single channel

• z (int or slice) – z indices to grab

• t (int) – Single timepoint

• p (int) – Single position

• subdiv (int) – Subdivision of the dataset to index along

Returns:

3D (z, y, x) slice of data set

Return type:

npt.ArrayLike

read() → None

Reads data from the image file.

set_metadata(metadata_config: dict) → None

Sets the metadata

Parameters:

metadata_config (dict) – shape configuration: “c”, “z”, “t”, “p”, “is_dynamic”, “per_stack”

set_metadata_from_configuration_experiment(configuration: Dict[str, Any], microscope_name: Optional[str] = None) → None

Sets the metadata from according to the microscope configuration.

Parameters:

• configuration (Dict[str, Any]) – The configuration experiment.

• microscope_name (str) – The microscope name

setup()

Additional steps for establishing the initial file setup.

write(data: Union[_SupportsArray[dtype], _NestedSequence[_SupportsArray[dtype]], bool, int, float, complex, str, bytes, _NestedSequence[Union[bool, int, float, complex, str, bytes]]], **kw) → None

Writes 2D image to the data source.

Parameters:

• data (npt.ArrayLike) – The data to write.

• kw (dict) – The keyword arguments to write.

bits

Number of bits per pixel.

Type:

int

property data: Union[_SupportsArray[dtype], _NestedSequence[_SupportsArray[dtype]], bool, int, float, complex, str, bytes, _NestedSequence[Union[bool, int, float, complex, str, bytes]]]

Return array representation of data stored in data source.

Returns:

Array representation of data stored in data source.

Return type:

npt.ArrayLike

Raises:

NotImplementedError – If not implemented in a derived class.

dc

Step size between channels (always 1)

Type:

float

dt

The time interval between frames (seconds).

Type:

float

dx

Pixel size in x dimension (microns). float: Pixel size in y dimension (microns). float: Pixel size in z dimension (microns).

Type:

float

dy

Pixel size in x dimension (microns). float: Pixel size in y dimension (microns). float: Pixel size in z dimension (microns).

Type:

float

dz

Pixel size in x dimension (microns). float: Pixel size in y dimension (microns). float: Pixel size in z dimension (microns).

Type:

float

file_name

Name of the file to read/write from.

Type:

str

image

The image.

Type:

np.array

logger

Logger for this class.

Type:

logging.Logger

metadata

The metadata.

Type:

BigDataViewerMetadata

property mode: str

Getter for the mode of the data source.

Returns:

Mode of the data source.

Return type:

str

property nbytes: int

Getter for image size.

Size in bytes. Overrides base class. Accounts for subdivisions.

Returns:

size – The size of the image in bytes.

Return type:

int

positions

Number of positions in the data source.

Type:

int

property resolutions: Union[_SupportsArray[dtype], _NestedSequence[_SupportsArray[dtype]], bool, int, float, complex, str, bytes, _NestedSequence[Union[bool, int, float, complex, str, bytes]]]

Getter for resolutions.

Store as XYZ per BDV spec.

Returns:

resolutions – The resolutions.

Return type:

npt.ArrayLike

property shape: tuple

Getter for the shape as XYCZT.

Returns:

Shape of the data source in XYCZT format.

Return type:

tuple

shape_c

Size of the data source in c dimension.

Type:

int

shape_t

Size of the data source in t dimension.

Type:

int

shape_x

Size of the data source in x dimension.

Type:

int

shape_y

Size of the data source in y dimension.

Type:

int

shape_z

Size of the data source in z dimension.

Type:

int

property shapes: Union[_SupportsArray[dtype], _NestedSequence[_SupportsArray[dtype]], bool, int, float, complex, str, bytes, _NestedSequence[Union[bool, int, float, complex, str, bytes]]]

Getter for image shape.

Store as ZYX rather than XYZ, per BDV spec.

Returns:

shapes – The shapes.

Return type:

npt.ArrayLike

property subdivisions: Union[_SupportsArray[dtype], _NestedSequence[_SupportsArray[dtype]], bool, int, float, complex, str, bytes, _NestedSequence[Union[bool, int, float, complex, str, bytes]]]

Getter for subdivisions.

Store as XYZ per BDV spec.

Returns:

subdivisions – The subdivisions.

Return type:

npt.ArrayLike

property voxel_size: tuple

Getter for the voxel size

Returns:

Voxel size in x, y, z dimensions.

Return type:

tuple