HDF5 file format
The data of a qpimage.QPImage
or qpimage.QPSeries
can be
stored on disk, using the h5file
parameter upon class instantiation.
This section describes the scheme used to store the data using the
HDF5 file format.
QPImage
The following graph visualized the HDF5 file structure of a QPImage instance:
Attributes
These attributes of the root group (/) describe physical parameters of the data:
key |
description |
---|---|
medium index |
refractive index of the medium |
pixel size |
detector pixel size [m] |
time |
acquisition time of the image [s] |
wavelength |
imaging wavelength [m] |
These other attributes may be used by e.g. data simulators such as qpsphere or cellsino:
key |
description |
---|---|
angle |
tomographic acquisition angle [rad] |
date |
acquisition date ‘YYYY-MM-DD’ |
device |
imaging device used |
focus |
focus position [m] |
identifier |
image identifier |
numerical aperture |
numerical aperture |
pos x |
x position [m] |
pos y |
y position [m] |
qpimage version |
qpimage software version used |
sim center |
simulation: center of object [px] |
sim index |
simulation: refractive index of object |
sim model |
simulation: model used |
sim radius |
simulation: object radius [m] |
software |
imaging software used |
Groups
Both groups, amplitude and phase, do not hold attributes. Each of the groups contain a dataset called raw (the raw image, by default stored as 32bit floating point values) and a group called bg_data which contains information about background correction. If background correction was used, then the bg_data group may contain the following datasets:
data: simple background image
fit: fitted background image; has the additional attributes
fit_offset
,fit_profile
, andborder_px
(seeqpimage.core.QPImage.compute_bg()
for possible values)estimate_bg_from_mask: binary mask image that defines regions in raw that resemble background data; used for background fitting
All of these datasets have the same shape as raw. The data and fit
datasets form the background data that are internally removed from the raw
data when requesting the QPImage.amp
or QPImage.pha
properties.
QPSeries
The following graph visualized the HDF5 file structure of a QPSeries instance (with a total of 48 QPImages):
Note that the name of each QPImage group always starts with “qpi_” and that the enumeration does not contain leading zeros. The root node (/) of a QPSeries may have the identifier attribute.