1. 快速上手¶
我们准备了windows平台下的python开发环境,以及depthai示例。
并且python环境中已为您安装好了运行depthai示例所需的所有依赖。做到开箱即用。
1.1. Windows¶
下载安装程序
百度网盘:
平台
链接
密码
Windows
qc4i
sourceforge:
地址:https://sourceforge.net/projects/depthai/
此处可以选择不同平台下载:
Note
这个安装包的depthai版本版本号是2.14.1,更新时间2022-01-18。部分示例可能会在gitee上不定期更新,最新示例请在 此处 查看。
安装程序下载好后,双击安装。
选择安装目录
选择菜单目录
建议不要安装在C盘。
选择是否添加环境变量
开始安装
安装成功
此时可以看到桌面有一个bat的快捷方式,双击它可以直接运行depthai_demo.py程序。
打开命令提示符,如图所示:
如果您选择添加环境变量,则可以执行以下命令:
进入刚才选择的安装目录
cd /d %DEPTHAI_HOME%
查看python版本
python -V
查看pip版本及路径
pip -V
查看已安装的库
pip list
如果您的电脑已安装过python,则可以通过 %DEPTHAI_HOME%
变量调用我们安装好环境的python。
"%DEPTHAI_HOME%\python\python" -V
运行depthai_demo.py程序:
另外,安装包带有depthai,不需要再去GitHub拉取。
双击桌面的OAK Demo即可运行depthai_demo.py。
也可以通过以下命令直接运行Demo:
由于depthai_demo.py需要特殊版本的depthai库,我们为depthai_demo.py单独制作了一个Python环境。
cd /d %DEPTHAI_HOME%\depthai
depthai_demo_python\python.exe depthai_demo.py
depthai_demo.py程序默认为GUI显示,不过目前GUI的demo还不是很稳定,可以使用 -gt
参数设置opencv显示。
depthai_demo_python\python.exe depthai_demo.py -gt cv
Warning
如果系统用户名是中文 并出现下图错误:
您可以在depthai-demo.py文件中添加以下代码:
import blobconverter
blobconverter.set_defaults(output_dir="<指定模型文件下载路径>")
如果下载太慢,您可以将用户目录下的.cache文件夹中blobconverter文件夹复制到上面代码中所指定的文件夹中。
运行校准程序:
在DEPTHAI_HOME中,我们还准备了为OAK-D校准的bat程序。
如果您想要校准其他OAK设备,可以修改depthai_calibrate.bat文件。
也可以在命令行运行校准程序。
depthai_demo_python\python.exe calibrate.py -s 2.5 -db -brd BW1098OBC
运行API示例:
python depthai_API_examples\ColorCamera\rgb_preview.py
我们还准备了许多应用示例在depthai-experiments文件夹中。
1.2. Linux¶
Linux平台我们建议使用git直接拉取depthai仓库。
depthai
git clone https://gitee.com/oakchina/depthai.git
depthai-python
git clone https://gitee.com/oakchina/depthai-python.git
depthai-experiments
git clone https://gitee.com/oakchina/depthai-experiments.git
Warning
在Linux平台并且第一次使用OAK需要配置udev规则 - 详情
安装依赖:
python3 -m pip install -r depthai/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
执行以下命令:
python3 depthai/depthai_dome.py
效果如下:
1.3. Raspberry Pi¶
下载OAK树莓派镜像
百度网盘:
平台
链接
密码
Raspberry Pi
84u3
sourceforge:
我们准备了一个安装好OAK依赖的树莓派镜像。烧录完成后插入树莓派启动即可。
打开软件,选择我们的oak树莓派镜像和您要烧录进的内存卡,即可开始烧录。
启动成功后,打开命令行执行以下命令就可以运行oak。
cd depthai
python3 depthai_demo.py
树莓派常见问题请参考 此处
1.4. 使用Pycharm打开项目¶
1、下载安装后打开pycharm界面
2、打开我们打包好的工程文件
点击Open,打开Open Fire or Project 文件夹,路径设置为下载的百度云文件(开发环境安装包)解压后的位置
3、设置python解释器为我们开发环境安装包内自带的python开发环境
右下角点击Interpreter Settings
4、将python解释器改为我们开发环境安装包内的python.exe
其他编辑器跟PyCharm一样,首先需要加载压缩包中的python开发环境
有疑问?
我们很乐意为您提供代码或其他问题的帮助。
我们的联系方式
还可以通过我们发布的视频和文章了解OAK