Introduction

Why qpformat?

There is a multitude of phase-imaging techniques that inevitably comes with a broad range of quantitative phase imaging (QPI) file formats. In addition, raw data, such as digital holographic microscopy (DHM) images, must be preprocessed to access the phase encoded in the interference pattern. Qpformat provides a unified and user-friendly interface for loading QPI data. It is based on the qpimage library and thus benefits from its hdf5-based data structure (e.g. elaborate background correction, meta data management, and transparent data storage). Furthermore, qpformat can manage large datasets (e.g. many holograms in one folder) without running out of memory by means of its lazily-evaluated SeriesData class.

Supported file formats

Class, Storage type, Description

SeriesFieldSinogramMeepHDF5

field

sinograms extracted from Meep/FDTD simulations

SeriesFolder

multiple

Folder-based wrapper file format

SeriesPhasePhasicsZipTif

phase,intensity

Phasics series data (zipped “SID PHA*.tif” files)

SeriesPhaseQpimageHDF5

phase,amplitude

Qpimage series (HDF5 format)

SeriesPhaseQpimageSubjoinedHDF5

phase,amplitude

Subjoined qpimage series (HDF5 format), may contain other data

SeriesRawOAHHyperSpyHDF5

raw-oah

HyperSpy hologram series (HDF5 format)

SeriesRawOAHQpformatHDF5

raw-oah

Raw off-axis holography series data (HDF5)

SeriesRawOAHZipTif

raw-oah

Off-axis hologram series (zipped TIFF files)

SeriesRawQLSIQpformatHDF5

raw-qlsi

Raw quadriwave lateral shearing interferometry series data (HDF5)

SingleFieldPhaseNumpyNpy

multiple

Numpy complex field or phase data (numpy binary format)

SinglePhasePhasicsTif

phase,intensity

Phasics image (“SID PHA*.tif”)

SinglePhaseQpimageHDF5

phase,amplitude

Qpimage single (HDF5 format)

SingleRawOAHQpformatHDF5

raw-oah

Raw off-axis holography data (HDF5)

SingleRawOAHTif

raw-oah

Off-axis hologram image (TIFF format)

SingleRawQLSIQpformatHDF5

raw-qlsi

Raw quadriwave lateral shearing interferometry data (HDF5)