Skip to content
Python API for the ZED SDK
Branch: master
Clone or download
Latest commit d9f086a May 6, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Read package version from (sphinx doc) May 2, 2019
examples Update for ZED SDK 2.8 (#76) Apr 19, 2019
pyzed Update for ZED SDK 2.8 (#76) Apr 19, 2019
tutorials Update for ZED SDK 2.8 (#76) Apr 19, 2019
.gitlab-ci.yml Adding CI (#81) May 3, 2019
LICENSE Stable API (#62) Dec 14, 2018 update README CI May 6, 2019
appveyor.yml update README CI May 6, 2019
requirements.txt Adding CI (#81) May 3, 2019 Adding CI (#81) May 3, 2019

Stereolabs ZED - Python API

This package lets you use the ZED stereo camera in Python 3.

Linux pipeline status Windows Build status

Getting started


Please check your python version with the following command. The result should be 3.5 or higher.

python --version

Cython and Numpy can be installed via pip.

python -m pip install cython numpy

Note: On Linux, it is advised to use the python3 command instead of python which by default point to python 2.7. To do so, the following packages python3-dev and python3-pip need to be installed.

python3 --version
pip3 install -r requirements.txt

Installing the plugin using pip

Currently the package is built for Desktop for the latest ZED SDK 2.8, depending on your configuration (Python, CUDA or OS version), choose the relevant command :

Ubuntu 16 using the default Python 3.5 and CUDA 9

pip3 install

Ubuntu 18 using the default Python 3.6 and CUDA 10

pip3 install

Windows : Python 3.5, 3.6 and 3.7 are available. For instance Python 3.7, CUDA 10 :

python.exe -m pip install

Build the plugin from source

python build
python install

or on Linux

python3 build
python3 install

If an error occurs during the compilation, make sure that you're using the latest ZED SDK and that you installed an x64 version of python. python -c "import platform; print(platform.architecture())"

The packages .pyd for Windows or .so for Linux will be generated and installed.

You can use python cleanall to remove every cpp files generated and build directory.

Make sure to be out of the plugin directory when using it. It will prevent Python from considering the pyzed folder of the plugin as the pyzed package.

When using Anaconda, make sure the package binary can be found. In the project folder, after compiling the wrapper run :

conda develop build/lib.linux-x86_64-3.6 # or 3.5 depending on the python version used

Use the plugin


Import the packages in your Python terminal or file like this:

import as sl

Vectors operations like norm, sum, square, dot, cross, distance but also simple operations can be done with Numpy package.

Run the tutorials

The tutorials provide simple projects to show how to use each module of the ZED SDK. For a similar version using the C++ API checkout the Cpp tutorials.

Run the examples

Please refer to the examples README for more informations.

Generate the API documentation

The documentation is provided in the doc folder and has to be built first.

Sphinx is used to generates the html documentation.

  1. The zed-python-api has to be compiled and installed
  2. Make sure sphinx and sphinx_rtd_theme are installed
    cd doc
    pip3 install -r requirements.txt
  1. Generate the documentation by running the provided Makefile (Linux) or make.bat (Windows)
    make html
  1. The documentation can be viewed in a browser by opening the generated index.html file located in doc/build/html/

Stable API notice

The ZED Python API is now stable but has some breaking changes from the previous (beta) version. The older beta version can be found in the legacy branch.

The changes were made to better reflect the C++ API and ease of use. Mainly all classes have a similar name to the C++ SDK (without the "Py" prefix), and all components were migrated to a unified sl namespace.


Feel free to open an issue if you find a bug, or a pull request for bug fixes, features or other improvements.

You can’t perform that action at this time.