quanti-fret

Home | Documentation | Source | PyPI | Napari | Contact

quanti-fret is a Python tool that performs QuanTI-FRET calibration and analysis from 3-channel movies.

If you use the QuanTI-FRET app in your scientific work, please cite:

Leblanc, J., Lombard, A.H., Saumureau, A. et al. Live-cell quantitative FRET imaging made simple by autocalibration in QuanTI-FRET. Eur. Phys. J. E 48, 74 (2025). https://doi.org/10.1140/epje/s10189-025-00541-z

1. Description
2. Documentation
3. Napari Plugin
4. Standalone GUI App
5. Standalone CLI App
6. For developpers

Description

The QuanTI-FRET method proposes calibrating the instrument and the FRET pair to simply calculate absolute FRET probabilities from a triplet of images acquired under the same conditions and with the same FRET pair. All the photophysical and instrumental factors are included in this calibration, leaving the variability of the results to biological origins.

The quanti-fret package provides all the tools to perform first the calibration, and then to make quantitative FRET measurement of your experiments, using only your triplet images.

It can be used:

• As a Napari plugin
• With the Standalone GUI app
• On the terminal with a CLI (Command Line Interface) app

Documentation

You can find the online documentation here.

Napari Plugin

QuanTI-FRET was designed to be integrated into the Napari tool as a plugin.

Installation

QuanTI-FRET is available in the Napari Hub under the name quanti-fret.

To install it:

• Have a look here to install Napari
• Have a look here to install a plugin

Getting Started

To open the plugin, go to the Plugins menu and click on QuanTI-FRET (quanti-fret)

Standalone GUI App

You can also use the QuanTI-FRET software as a standalone GUI or CLI app outside Napari.

Installation

Set up your environment

It is good practice to set up a virtual environment and install the tool inside your environment.

With Conda

conda create --name quantifret
conda activate quantifret
conda install pip

With Pyenv

pyenv virtualenv [PYTHON_VERSION>=3.10] quantifret
pyenv activate quantifret
pip install --upgrade pip

Install Qt

If you want to use the GUI application, you need to install Qt.

It is not in the defaults dependencies as the quanti_fret modules also comes up with a CLI app, or can be imported directly inside your Python code. So we don't want to penalize all the users by forcing a Qt dependency.

quanti-fret supports Qt5 and Qt6 using either PyQt or PySide

pip install [pyqt6 | pyqt5 | pyside6 | pyside2] # Choose one package

Install the module

Finally, you can install the quanti_fret module by running:

pip install quanti-fret

Upgrade the module

pip install quanti-fret --upgrade

Getting Started

Run the following command inside your environement:`

quanti-fret-run

Standalone CLI App

For automation purposes, or if you don't have access to a graphic server, you can use the CLI app.

Installation

Do all the steps of the standalone GUI app installation except for the Qt part

Getting Started

Generate your config files

You first need to generate one config file for the calibration phase, and one for the fret phase:

quanti-fret-run generate_config calibration path/to/new/calibration.ini
quanti-fret-run generate_config fret path/to/new/fret.ini

You then need to modify them to fit your requirements (see the documentation)

Run the calibration

quanti-fret-run cli calibration path/to/new/calibration.ini

Run the fret on the series

quanti-fret-run cli fret path/to/new/fret.ini

For developpers

Here are some indications dedicated to the developpers

Poetry

quanti-fret is using poetry as a build system.

To install it, go to their doc page

Note: You need to install at least poetry 2.0

Clone the project

git clone https://gricad-gitlab.univ-grenoble-alpes.fr/liphy/quanti-fret.git
cd quanti-fret/

Note

To build the doc and run the tests, you need to have git-lfs installed.

If you installed it after cloning, please run

git lfs fetch
git lfs checkout

Install QuanTI-FRET

poetry install

Run the tests

pytest
flake8
mypy .