Installation

Prerequisites

camazing needs something called GenTL Producer in order to work. It enables the library to access and configure the camera hardware in a generic way and acquire images with the cameras. A more profound description can be found from the GenICam GenTL standard. Notice, that camazing currently works only when there are exactly one GenTL Producer installed on the machine. This is because multiple paths to different GenTL Producers are listed in the GENICAM_GENTL64_PATH environment variable, and camazing currently knows only how to handle one.

The following implementations should not block cameras of competitive manufacturers:

Manufacturer	Software	Operating Systems	Status
JAI	JAI SDK	Windows	Not tested
Matrix Vision	mvIMPACT Acquire	Windows, Linux	Tested and working
STEMMER IMAGING	Common Vision Blox	Windows, Linux (Ubuntu)	Not tested

Also following software implement GenICam Producer, but they’re likely to work only with the cameras of the same manufacturer as the software:

Manufacturer	Software	Operating Systems	Status
Basler	Pylon	Windows, macOS, Linux	Tested, but camera driver missing
Baumer Optotronic	Baumer GAPI SDK	Windows, Linux	Not tested
OMRON SENTECH	StCamUSBPack	?	Not tested

The installed software should define an environment variable GENICAM_GENTL64_PATH, or GENICAM_GENTL32_PATH if you are using 32-bit CPU. This contains the path to the GenICam Producer file with file extension .cti, and camazing should be able to detect this automatically. If, however, the environment variable is not defined for whatever reason, the GenICam Producer can be provided to CameraList object manually.

Installation using pip

For normal use, direct installation from pip should work fine:

pip install camazing

For development, you should clone the repository from git and install it using development mode with the command

pip install -e .[doc]

This also installs the necessary packages for building the documentation locally with cd docs && make html.

Note on GenICam bindings and Python 3.8 on Windows

Currently camazing relies on the genicam2 Python bindings which do not seem to available for Python 3.8 on Windows, requiring the use of Python 3.7 or earlier.