Package: seekcamera-python
seekcamera-pythonWelcome! :wave:This is the official home of the Python language bindings for the Seek Thermal SDK. :snake:About :scroll:In general, the Seek Thermal SDK allows customers to develop applications that interface with our thermal camera cores easily, flexibly, and efficiently.
In addition, examples are provided to demonstrate the use of several functional areas and can be a starting point for your own projects.The Python language bindings supplement and extend the SDK's traditional C interface in a higher-level language.
They require the Seek Thermal SDK 4.X to be pre-installed on the system; they also require a Seek Thermal OEM core to be physically attached to the system.Visit ourwebsitefor more information and to get yourStarter Kit.Features :test_tube:The Python language bindings mirror all the major functionality in our SDK.Highlights :confetti_ball:Asynchronous event driven API that is fast and responsiveAbility to use multiple cameras in one SDK instanceCommon set of APIs for both Mosaic and Micro Core camerasRobust error handling and logging interfaceNumerous frame output formatsExample applications to learn and get startedSupported platforms :electric_plug:The Python language bindings will run on a wide variety of common processors and Linux/Windows OSs.The requirements arePython 3.Xnumpy>= 1Host architecture supported by the SDKSee the official SDK documentation for more informationThe optional dependencies areopencv-python>=4Only for the seekcamera-opencv sampleGetting started :book:We recommend that you jump right in by checking out one of the sample applications.
The sample applications demonstrate how to use the most common APIs and features in the SDK.Sample applications :bulb:seekcamera-opencvDemonstrates how to image and display thermal frames to the screen using OpenCV's drawing functions.seekcamera-simpleDemonstrates how to export frame pixel values to disk as a CSV file.Run the samplescd seekcamera-python
python3 examples/seekcamera-opencv.pyAPI documentation :brain:API documentation is provided as standard Python docstrings.
Please refer to the more complete Seek Thermal SDK C Programming Guide which is provided with the SDK for more in-depth documentation.Installation :open_file_folder:The Python language bindings are developed using Python 3.X.
We recommended Python 3.6+ since we test against those versions; older versions may work as well but we have not tested against them.You can download Python from the officialwebsite.The recommended method of installation is via the package on pypipip3 install seekcamera-pythonAlternatively, you can install manually. To do so, after installing Python, clone this repositorygit clone https://github.com/seekthermal/seekcamera-python.gitChange directories into the cloned repositorycd seekcamera-pythonInstall viapippip3 install -e .Dependencies :floppy_disk:Python dependenciesAdditional Python dependencies (required for some of the samples) can be installed viapip.pip3 install -r requirements.examples.txtOther dependenciesThe Python language bindings require the Seek Thermal SDK to be installed.
It is recommended, but not required, to use one of the SDK installers.
We provide Debian installers (.deb) for Linux and zipfile archives (.zip) for Windows.On Windows, the SDK library (seekcamera.dll) should be located in one of the following places in order of precedence:%SEEKTHERMAL_LIB_DIR%/
C:/Program Files/Seek Thermal/Seek Thermal SDK/4.X.X/x64-windows/libOn Linux, the SDK library (libseekcamera.so) should be located in one of the following places in order of precedence:$SEEKTHERMAL_LIB_DIR/
$LD_LIBRARY_PATH/
/lib/
/lib64/
/usr/lib/
/usr/lib64/NOTE%SEEKTHERMAL_LIB_DIR%is Windows environment variable and is (optionally) set by the user.$SEEKTHERMAL_LIB_DIRis a Linux environment variable and is (optionally) set by the user.The minimum SDK runtime version for each stable release of the Python language bindings is shown below:seekcamera-pythonMinimum SDK runtime version1.0.04.0.01.1.04.1.01.1.14.1.0License :balance_scale:The project is licensed under the Apache 2.0 License.
Please see theLICENSEfor more information.Copyright (c) 2021 Seek Thermal.Contributing :hammer:We are excited about contributions!Please see ourcontributing guidefor more information.