Giter VIP home page Giter VIP logo

flute's Introduction


Logo

a Python GUI for interactive phasor analysis of Fluorescence Lifetime Microscopy (FLIM) data
Explore the docs »

User manual and publication

A detailed user manual is available in the supplemental material of the associated publication:
Gottlieb, D., Asadipour, B., Kostina, P., Ung, T., & Stringari, C. (2023). "FLUTE: A Python GUI for interactive phasor analysis of FLIM data". Biological Imaging, 1-22. doi:10.1017/S2633903X23000211 »
Please cite this article if you found FLUTE helpful with your data analysis.

About the project

Fluorescence Lifetime Ultimate Explorer (FLUTE) provides a graphical user interface to explore Fluorescence Lifetime Microscopy (FLIM) using phasor analysis. The GUI allows for quick and interactive analysis of experimental FLIM data, and can export results for further processing.

An example of various FLIM data visualisation and analyses can be seen here:

Colormaps of the same data with cursor selection, phase lifetime contrast, modulation lifetime contrast and distance from a known molecular species. Scale bar is 150 um.

(back to top)

The Fluorescence lifetime imaging microscopy (FLIM) data relative to the publications are in our Zenodo repository »
Fluorescein.tif stack contains the fluorescence intensity decay of fluorescein solution with a known lifetime of 4ns, used as calibration. Embryo.tif file contains the fluorescence intensity decay of a zebrafish embryo at 3 days post fertilisation.
Both files have been acquired with the following parameters:

  • laser repetition rates = 80 MHz
  • bin width = 0.223ns
  • temporal bin number = 56

Here you can find in open access the slides about FLUTE software

Built with

FLUTE mainly depends on the following packages:

With the exe compiled using auto-py-to-exe

Getting started

Running the exe

To quickly start using FLUTE, an exe which works on Windows computers without installing Python is available under releases on the github here.

Running the code

To run the code from this github page, run main.py after installing:

pip install PyQt5, numpy, opencv-python, matplotlib, scikit-image

Prerequisites

FLIM data must be saved or exported as a tiff-stack, where each image of the stack represents a temporal bin of the fluorescence decay measurement. Example data is available in the supplemental data of the release publication.

(back to top)

License

FLUTE is Copyright (C) 2022 FLUTE

FLUTE source code is Free and Open Source Software released under the terms of the 3-Clause BSD License (see file [LICENSE] for details).

The prebuilt FLUTE executable is a combined work that contains both FLUTE and QT library bindings. It is released under the terms of both the 3-Clause BSD License (for the FLUTE part) and the GNU Lesser General Public License (for the QT part).

flute's People

Contributors

chiarastringari avatar dalelob avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

flute's Issues

Running FLUTE from main.py on macOS

I had to go through quite some steps before I was able to run FLUTE from main.py. The main issue was to install PyQt5. This stackoverflow post (and the MacOS specific answer) was of great help:
https://stackoverflow.com/questions/70961915/error-while-installing-pytq5-with-pip-preparing-metadata-pyproject-toml-did-n
I document the steps here as detailed as possible, as it may be helpful for others.

I'm on macOS Montery (12.4) with a MacBook Pro (14-inch, 2021), Apple M1 pro chip and I'm using the miniconda distribution of Python.


First, in the terminal install brew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

After installation, there will be instructions from brew, which I followed. These are copied below:

(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/joachimgoedhart/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Second, use brew to install qt5:

brew install qt5

Next we need to find the place where bin/qmake is located. On my laptop it is:

/opt/homebrew/opt/qt@5/bin

Now I add to the file (located in my homefolder): .zshrc

This line of code:

export PATH="$PATH:/opt/homebrew/opt/qt@5/bin"

Third, I was able to install PyQt5:

pip install pyqt5 --config-settings --confirm-license= --verbose
This worked (took quite some time to compile)!!!


After these steps I was able to install the packages in a new environment:

  • pip install numpy
  • pip install PyQt5
  • pip install opencv-python
  • pip install pip install
  • pip install matplotlib==3.6.3

And tada, I was able to run:

python main.py

Determining bin width

Dear all,

we are struggling to understand how to determine the bin width of our image(s)/data as asked for in the calibration window.
We would be very grateful for any tips on how best to find the value(s) in our data.

Best wishes,
Elisabeth

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.