No project description provided
flirpy is a Python library to interact with FLIR thermal imaging cameras and images.
It aims to be a one-stop-shop to:
- Interact and query cameras via serial
- Capture raw images
- Convert FLIR file formats (e.g. seq, fff, tmc, tfc) to geotagged readable images
- Convert raw images to radiometric images
- Extract and plot GPS traces from image sequences (e.g. from drones)
The library has been tested with:
- FLIR Tau (serial only)
- FLIR Boson (serial and image capture)
- FLIR Duo Pro R (image post-processing)
- TeAx Fusion Zoom (image post-processing)
Support for the Lepton is coming soon, but will probably be limited to the Raspberry Pi for the time being.
It is strongly recommended that you use Python 3. I have tried to ensure that certain functions are portable between Python 2 and 3, mainly those involved with camera communication (for example if you want to use flirpy with ROS, most of the important stuff works). However, some file IO is hit and miss on Python 2 due to differences in regexes. Python 2 is effectively end of life and while I'd like to support both, it's a low priority. Submit a PR if you like!
The library is organised into logical sections:
flirpy.cameracontains classes to communicate with FLIR camera cores directly
flirpy.iocontains claseses to deal with thermal image formats
flirpy.utilcontains helper functions e.g. raw conversion
Flirpy includes a convenience utility
split_seqs for splitting FLIR sequence (SEQ) files.
Once installed, you can run:
$ split_seqs -h usage: split_seqs [-h] [-o OUTPUT] -i INPUT [-v VERBOSITY] Split all files in folder. optional arguments: -h, --help show this help message and exit -o OUTPUT, --output OUTPUT Output folder -i INPUT, --input INPUT Input file mask -v VERBOSITY, --verbosity VERBOSITY Logging level
split_seqs accepts either a directory, a specific filename, or a wildcard string (e.g.
"./my/data/flight_*.SEQ"). If you use wildcards, be sure to enclose the argument in quotes, otherwise your shell will expand the wildcard before running the program and confuse it. If you specify a directoy, all SEQ files in that diretory will be used.
Files will be extracted to folders with the same base name as the SEQ file, for example
20180101_1030.SEQ will be extracted to
20180101_1030, etc. By default the splitter will three kinds of files, separated by subfolder.
- Raw (FFF) files with metadata text files
- Radiometric 16-bit tiff images
- Preview 8-bit RGB representations of the radiometric data
The tiff images will be geotagged if GPS information is present in the raw data.
Output images are numbered. If SEQ file 1 contains 1800 frames, the first frame from SEQ file 2 will be numbered 1800.
Flirpy has been tested with Python 3 and may work on Python 2. It is always recommended that you install packages inside a virtualenv or Conda environment.
Either install using
pip install flirpy
python setup.py install
flirpy is distributed with a copy of Exiftool which is used to extract metadata from certain file formats.
Installation on ARM (e.g. Raspberry Pi)
Flirpy mostly works well, and has been tested, on the Raspberry Pi. If you're building from scratch, you need to install a few things manually. Try to use Python 3 if you can.
It's recommended that you first install the Python dependencies using
pip in combination with piwheels. For whatever reason,
setuptools does not find these files, so it will fail if e.g. OpenCV isn't installed already. Once you've set up piwheels (it should be automatic on Raspbian if you've installed pip3) run:
pip3 install -r requirements.txt
You may need to install some dependencies for OpenCV, for example
You should also install Exiftool manually with
sudo apt install exiftool.
To run the test suite, install
pytest and run:
pytest --cov=flirpy test
Some tests are hardware dependent, e.g. for cameras, so expect them to fail unless you own and have a camera to try them with. Hardware tests are skipped by default if the requisite camera is not plugged in.
The repository includes some small representative examples of image files (e.g. SEQ). It is tested and is routinely used with flight data from FLIR Duo cameras, so larger files aren't a problem, but they're too large to include in the repository.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size flirpy-0.0.4-py2.py3-none-any.whl (10.2 MB)||File type Wheel||Python version py2.py3||Upload date||Hashes View hashes|
|Filename, size flirpy-0.0.4.tar.gz (9.6 MB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for flirpy-0.0.4-py2.py3-none-any.whl