🌡️ AiThermometer 🌡️
Code for automatically measuring the temperature of people using a thermal camera. The software can be freely used for any non-commercial applications and it is useful for the automatic early-screening of fever symptoms. The code is open and can be improved with your support, please contact us at firstname.lastname@example.org if you want to help us.
[April 24th, 2020]
- We are maintaining list of supported cameras. Please feel free to contribute.
[April 7th, 2020]
- New code for acquiring and processing data streams from FLIR® cameras in the folder FLIR_cameras.
The software first detect people with an off-the-shelf body pose detector and then extract location of the face where the temperature is measured. The software requires a known reference temperature and the value and position are provided by the user (this information is shown as a single small green circle on the image). It is possible to have the absolute temperature but you need an image from a thermal camera with correct radiometric calibration and radiometric exif data loaded into image.
Code is developed in Python3 and tested on Ubuntu 18.04 with NVidia driver, Cuda 10.0 and Cudnn 7.6.5.
AiThermometer can be run in a Docker container, as described in this section.
Install the requirements
To run this code without Docker support, you need to install:
Please follow the instruction in the repository gitHub and install OpenPose in
In case you prefer to use a different OpenPose installation folder, you can pass it using the
Flir Image Extractor:
pip3 install flirimageextractor
apt-get install python3-opencv
pip3 install opencv-python
Install the Docker
You can install Docker following
After Docker installation, you can either build the available Dockerfile or download from
https://hub.docker.com/repository/docker/pmorerio/aithermometerthe already built image using:
docker pull pmorerio/aithermometer:release1
With radiometric images
Usage Example in case the available images are radiometric:
./ai_thermometer.py --image_in ./samples/IR_2412.jpg --image_out ./results/IR_2412_out.jpg --radiometric True
Without radiometric images
The algorithm has been designed such that it can be used with uncalibrated thermal cameras: a reference pixel with known approximate temperature should be provided by the user.
./ai_thermometer.py --image_in ./samples/image1.jpeg --image_out ./results/image1_out.jpg --reference_px 200 --reference_py 400 --reference_temperature 31
Using the included Dockerfile you can automatically build an image with the required packages.
Build the images using
docker build -t ai_thermometer .
Enter in the image bash using
docker run -it --gpus all -v <local_folder>:/ai_thermometer/results ai_thermometer
Run the sample script using
The resulting images will be stored in <local_folder>.
Below are some examples on the FREE FLIR Thermal Dataset.
- Increase the number of thermal cameras supported
- Increase people detection rate of openpose applied on thermal images
- Improve robustness of face measurement algorithm
- Automatic detection of masks, eyewear, scarf and other face occluding elements
- FLIR® A600
- FLIR® A315
You contribution in broadening the list of tested cameras is very welcome.
The information and content provided by this application is for information purposes only. You hereby agree that you shall not make any health or medical related decision based in whole or in part on anything contained within the application without consulting your personal doctor.
The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors, PAVIS or IIT be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.
This project is licensed under the terms of the MIT license.
This project incorporates material from the projects listed below (collectively, "Third Party Code"). This Third Party Code is licensed to you under their original license terms. We reserves all other rights not expressly granted, whether by implication, estoppel or otherwise.