Python (Windows/Linux)

Python SDK 目录结构

文件/文件夹

说明

epiceye

该文件夹用于存放Python SDK的源代码。

_init_.py:该文件定义了包的结构、导入方式和初始化操作,用于将epiceye文件夹标记为一个Python模块。

epiceye.py:该文件为SDK的主要功能实现,提供了一组函数和方法,用于与相机设备进行通信,并实现各种功能。

epicraw_parser.py:该文件实现了对 EPICRAW 数据的解析,包括获取图像、深度、相机矩阵和畸变参数等。

example.py

该文件是一个示例程序,演示了如何使用SDK中的函数来获取相机信息、配置相机、触发帧、获取图像、点云和深度等功能,并将结果保存到文件中。

requirements.txt

该文件包含了项目依赖的Python包列表,通常用于安装项目所需的依赖包。

setup.py

该文件用于构建、打包和安装Python模块的脚本文件,通常用于发布Python包到PyPI等包管理平台。

运行环境配置

安装 Python 环境

在终端中执行以下命令安装Python。

sudo apt-get install python3 python3-pip

安装依赖项

在终端中执行以下命令安装所需的依赖项。

pip install -r requirment.txt

运行例程

使用前提

直接运行例程

  1. 在 epiceye3_sdk/python 路径下,执行以下命令运行例程。

    • 自动搜索相机,并连接第一个相机。

      python example.py
    • 指定相机IP。

      python example.py xxx
      xxx为相机IP地址。相机IP地址获取请参考确认相机IP地址
  2. 运行完毕后,点云和2D图将保存在例程所在目录下。

作为库使用

  1. 在 epiceye3_sdk/python 路径下,执行以下命令。

    python setup.py install
  2. 执行下列命令生成.whl文件。

    python setup.py bdist_wheel
  3. 执行以下命令安装.whl文件。

    pip install ./dist/xxx.whl
    xxx为dist文件夹中.whl文件的文件名。
  4. 在项目中引用。

    import epiceye