Skip to content

3D quantitative label-free imaging with phase and polarization


Notifications You must be signed in to change notification settings


Repository files navigation


PyPI - Python Version Python package index download statistics Python package index Development Status

recOrder is a collection of computational imaging methods. It currently provides QLIPP (quantitative label-free imaging with phase and polarization), phase from defocus, and fluorescence deconvolution.

Unveiling the invisible

Acquisition, calibration, background correction, reconstruction, and applications of QLIPP are described in the following E-Life Paper:

Syuan-Ming Guo, Li-Hao Yeh, Jenny Folkesson, Ivan E Ivanov, Anitha P Krishnan, Matthew G Keefe, Ezzat Hashemi, David Shin, Bryant B Chhun, Nathan H Cho, Manuel D Leonetti, May H Han, Tomasz J Nowakowski, Shalin B Mehta, "Revealing architectural order with quantitative label-free imaging and deep learning," eLife 2020;9:e55502 DOI: 10.7554/eLife.55502 (2020).

These are the kinds of data you can acquire with recOrder and QLIPP:

What do I need to use recOrder

recOrder is to be used alongside a conventional widefield microscope. For QLIPP, the microscope must be fitted with an analyzer and a universal polarizer:


For phase-from-defocus or fluorescence deconvolution methods, the universal polarizer is optional.

The overall structure of recOrder is shown in Panel B, highlighting the structure of the graphical user interface (GUI) through a napari plugin and the command-line interface (CLI) that allows users to perform reconstructions.

Flow Chart

Software Quick Start

(Optional but recommended) install anaconda and create a virtual environment:

conda create -y -n recOrder python=3.10
conda activate recOrder

Install recOrder-napari with acquisition dependencies (napari and pycro-manager):

pip install recOrder-napari[acq]

Open napari with recOrder-napari:

napari -w recOrder-napari

For more help, see recOrder's documentation. To install recOrder on a microscope, see the microscope installation guide.


Slides and a dataset shared during a workshop on QLIPP and recOrder can be found on Zenodo, and the napari plugin's sample contributions (File > Open Sample > recOrder-napari in napari).