加入CODE CHINA

· 不限速    · 不限空间    · 不限人数    · 私仓免费

免费加入
    README.md

    Stereolabs ZED - Python API

    This package lets you use the ZED stereo camera in Python 3. The Python API is a wrapper around the ZED SDK which is written in C++ optimized code. We make the ZED SDK accessible from external Python code using Cython.

    Getting started

    Prerequisites

    To start using the ZED SDK in Python, you will need to install the following dependencies on your system:

    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

    The sample dependencies can also be installed via pip

    python -m pip install opencv-python pyopengl

    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.

    Installing the Python API

    A Python script is available in the ZED SDK installation folder and can automatically detect your platform, CUDA and Python version and download the corresponding pre-compiled Python API package.

    Running the install script

    Windows

    The Python install script is located in: C:\Program Files (x86)\ZED SDK\

    Make sure you have admin access to run it in the Program Files folder, otherwise, you will have a Permission denied error. You can still copy the file into another location to run it without permissions.

    Linux

    The Python install script is located in: /usr/local/zed/

    Run the script:

    $ cd "/usr/local/zed/"
    $ python get_python_api.py
    
        # The script displays the detected platform versions
        CUDA 10.0
        Platform ubuntu18
        ZED 3.1
        Python 3.7
        # Downloads the whl package
        Downloading python package from https://download.stereolabs.com/zedsdk/3.1/ubuntu18/cu100/py37 ...
    
        # Gives instruction on how to install the downloaded package
        File saved into pyzed-3.1-cp37-cp37m-linux_x86_64.whl
        To install it run :
          python3 -m pip install pyzed-3.1-cp37-cp37m-linux_x86_64.whl

    Now install the downloaded package with pip:

    $ python3 -m pip install pyzed-3.1-cp37-cp37m-linux_x86_64.whl
    
        Processing ./pyzed-3.1-cp37-cp37m-linux_x86_64.whl
        Installing collected packages: pyzed
        Successfully installed pyzed-3.1

    That's it ! The Python API is now installed.

    Use the plugin

    Code

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

    import pyzed.sl 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.

    Run the examples

    Please refer to the examples README for more informations.

    Troubleshooting

    "Numpy binary incompatiblity"

    Traceback (most recent call last):
        ...
        File "__init__.pxd", line 918, in init pyzed.sl
    ValueError: numpy.ufunc size changed, may indicate binary incompatiblity. Expected 216 from C header, got 192 from PyObject

    This error usually means numpy isn't installed. To install it, simply run these commands :

    # On Jetson (aarch64) cython needs to be installed first since numpy needs to be compiled.
    python3 -m pip install cython
    python3 -m pip install numpy

    Compiling the Python API from source (only for developers of the python wrapper)

    To compile the ZED SDK Python wrapper go to src folder to get the cython sources and instructions.

    Note : This step is not useful for users of the wrapper, it is only meant to be used to extend the wrapper for advanced uses.

    Support

    If you need assistance go to our Community site at https://community.stereolabs.com/

    项目简介

    🚀 Github 镜像仓库 🚀

    源项目地址

    https://github.com/stereolabs/zed-python-api

    发行版本 7

    v3.1

    全部发行版

    贡献者 11

    开发语言

    • Python 98.0 %
    • C++ 2.0 %