Development Status
- 3 - Alpha
Intended Audience
- Science/Research
- Developers
Operating System
- OS Independent
Programming Language
- Cython
- Python :: 3 :: Only
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
- Python :: 3.14
Fbdfile is a Python library to read FLIMbox data (FBD), firmware (FBF), and setting (FBS.XML) files. The FLIMbox is an FPGA-based device for high bandwidth, multi-channel data collection for fluorescence lifetime-resolved imaging (FLIM) from a pulsed laser scanning confocal microscope. The files are written by SimFCS and ISS VistaVision software.
- Author:
- License:
BSD-3-Clause
- Version:
2025.9.18
- DOI:
Quickstart
Install the fbdfile package and all dependencies from the Python Package Index:
python -m pip install -U fbdfile[all]
See Examples for using the programming interface.
Source code and support are available on GitHub.
Requirements
This revision was tested with the following requirements and dependencies (other versions may work):
Revisions
2025.9.18
Fix reading FBF and FBS files from streams.
2025.9.17
Make frame_markers a numpy array.
Add options to specify number of OpenMP threads.
2025.9.16
Initial alpha release based on lfdfiles 2025.7.31.
Notes
The API is not stable yet and might change between revisions.
Python <= 3.10 is no longer supported. 32-bit versions are deprecated.
The latest Microsoft Visual C++ Redistributable for Visual Studio 2015-2022 is required on Windows.
The FLIMbox formats are not documented and might change arbitrarily. This implementation is based on reverse engineering existing files. No guarantee can be made as to the correctness of code and documentation.
SimFCS, a.k.a. Globals for Images, is software for fluorescence image acquisition, analysis, and simulation, developed by Enrico Gratton at UCI.
VistaVision is commercial software for instrument control, data acquisition, and data processing by ISS Inc (Champaign, IL).
Examples
Read a FLIM lifetime image and metadata from an FBD file:
>>> with FbdFile('tests/data/flimbox$CBCO.fbd') as fbd:
... bins, times, markers = fbd.decode()
...
>>> print(bins[0, :2], times[:2], markers[:2])
[50 58] [ 0 32] [1944097 2024815]
>>> import numpy
>>> hist = [numpy.bincount(b[b >= 0]) for b in bins]
>>> int(numpy.argmax(hist[0]))
53
>>> image = fbd.asimage((bins, times, markers))
>>> image.shape
(1, 2, 256, 256, 64)
View the histogram and metadata in a FLIMbox data file from the console:
$ python -m fbdfile tests/data/flimbox$CBCO.fbd
