This package provides a pythonic interface to the Evocortex libirimager direct binding.
The project is largely inspired by an old Github project which is no longer available.
- Download the irDirectSDK from the Evocortex website (this package has been tested with libirimager7.2)
- Make sure to adapt the 'config_file.xml' to your specific setup. You should pay special attention to the and tags because they need to point to the correct locations of the 'Formats.def' and calibration files. The calibration files are provided with the camera.
pip install git+https://github.com/FiloCara/pyOptris.git
- Attach your Optris device to the USB port
- run
bash libirimager_setup.shto automacally download and setup the libirimager library from the Evocortex website. The script also generate the XML config file. If not working, you can still manually download the SDK from Evocortex website pip3 install git+https://github.com/FiloCara/pyOptris.git
For any libirimager installation problems please refers to the Evocortex documentation
Warning: Gtk-Message: 21:31:44.478: Failed to load module "canberra-gtk-module"
sudo apt install libcanberra-gtk-module libcanberra-gtk3-module
| direct binding name | node-optris name | description |
|---|---|---|
| evo_irimager_usb_init | usb_init | Initializes an IRImager instance connected to this computer via USB |
| evo_irimager_usb_init | tcp_init | Initializes the TCP connection to the daemon process (non-blocking) |
| evo_irimager_terminate | terminate | Disconnects the camera, either connected via USB or TCP |
| evo_irimager_get_thermal_image_size | get_thermal_image_size | Accessor to image width and height |
| evo_irimager_get_palette_image_size | get_palette_image_size | Accessor to width and height of false color coded palette image |
| evo_irimager_get_thermal_image | get_thermal_image | Accessor to thermal image by reference, Conversion to temperature values are to be performed as follows: t = ((double)data[x] - 1000.0) / 10.0 |
| evo_irimager_get_palette_image | get_palette_image | Accessor to an RGB palette image by reference |
| evo_irimager_get_thermal_palette_image | get_thermal_palette_image | Accessor to an RGB palette image and a thermal image by reference |
| evo_irimager_set_palette | set_palette | Set RGB palette |
| evo_irimager_set_shutter_mode | set_shutter_mode | Sets shutter flag control mode (0:manual, 1:auto) |
| evo_irimager_trigger_shutter_flag | trigger_shutter_flag | Forces a shutter flag cycle |
| evo_irimager_daemon_launch | daemon_launch | Launch TCP daemon |
| evo_irimager_daemon_is_running | daemon_is_running | Check whether daemon is already running |
| evo_irimager_daemon_kill | daemon_kill | Kill TCP daemon |
The folder provides two example scripts.
/examples/example_palette.py shows how to get thermal images in RGB format (a colormap is applied over the termperature values). The example needs OpenCV installed.
/examples/example_thermal.py allows to get the thermal frame with Celsius temperature for each pixel.
import cv2
import pyOptris as optris
DLL_path = "../irDirectSDK/sdk/x64/libirimager.dll"
optris.load_DLL(DLL_path)
# USB connection initialisation
optris.usb_init("config_file.xml")
optris.set_palette(9)
w, h = optris.get_palette_image_size()
print("{} x {}".format(w, h))
while True:
# Get the palette image (RGB image)
frame = optris.get_palette_image(w, h)
cv2.imshow("IR streaming", frame)
if cv2.waitKey(1) & 0xFF == ord("q"):
break
optris.terminate()
cv2.destroyAllWindows()import pyOptris as optris
DLL_path = "../irDirectSDK/sdk/x64/libirimager.dll"
optris.load_DLL(DLL_path)
# USB connection initialisation
optris.usb_init('config_file.xml')
w, h = optris.get_thermal_image_size()
print('{} x {}'.format(w, h))
# Get the thermal frame (numpy array)
thermal_frame = optris.get_thermal_image(w, h)
# Conversion to temperature values are to be performed as follows:
# t = ((double)data[x] - 1000.0) / 10.0;
processed_thermal_frame = (thermal_frame - 1000.0) / 10.0
print(processed_thermal_frame)
optris.terminate()