安装与环境设置#
有关 pypylon 的背景信息，请参阅简介。
安装 pylon Software Suite#
安装 Basler pylon Software Suite 以及 pypylon 和所需的补充软件包（例如用于 3D 相机的软件包）。
信息
pypylon wheel 软件包已经包含了 pylon C++ 运行时和 vTools。这足以使用 pypylon，并且对于不需要任何额外驱动程序的传输层可以立即生效。
如有需要，您可以从 Basler 网站下载 pylon Software Suite 以及任何其他补充软件包（例如用于 3D 相机的软件包）。
pylon Software Suite 的安装向导将引导您完成整个过程，并允许您决定要安装哪些组件。推荐使用以下组件：
- USB/GigE 驱动程序
- CXP GenTL Producer 和驱动程序（如果使用 CXP 相机）
- pylon Viewer
安装 pypylon#
pypylon 可从 PyPi 获取。要安装它，请运行以下命令：
在某些系统上运行 pip install 时，您可能会看到类似以下内容的信息：
error: externally-managed-environment × This environment is externally managed To install Python packages system-wide, use your system package manager, for instance on Ubuntu23.04+.
这意味着您的操作系统管理着 Python 安装。这有助于防止 pip 更改系统软件包。
方案 1：虚拟环境（推荐）#
Python“虚拟环境”允许将 Python 软件包安装在特定应用程序的隔离位置，而不是全局安装。使用 venv 安装到文件夹 DIR 您需要执行以下步骤：
python3 -m venv <DIR>
source <DIR>/bin/activate # MacOS/ Linux
<DIR>\Scripts\activate # Windows
pip install pypylon
deactivate
这在 Docker、WSL、Raspberry Pi 和 Conda 设置中的工作方式相同。每个项目都有自己的依赖项树，一个项目中的升级绝不会影响另一个项目。
方案 2：系统范围安装#
sudo python3 -m pip install pypylon --break-system-packages
这种方法比较简单，并且模块可供所有用户立即使用。然而，除了需要 root 权限外，它还有以下缺点。
- 它可能会与 Debian 软件包管理发生冲突。
- 未来的 Debian 或 Python 更新可能会破坏系统。
总的来说，在现代 Debian 系统上不建议采用这种方法。
验证安装#
要验证 pypylon 安装，请运行以下命令：
from pypylon import pylon
factory = pylon.TlFactory.GetInstance()
devices = factory.EnumerateDevices()
print("Detected:", len(devices))
GigE 优化#
如果您计划使用 GigE 相机，建议进行以下优化：
- 使用专用的网络接口卡 (NIC)
- 启用巨型帧 (MTU 9000)
- 禁用节能
分发 pypylon#
Pypylon 提供了一个完整的 pylon 运行时。因此，无需安装 pylon Software Suite。
如果您还需要相机或图像采集卡驱动程序，请参阅 pylon Deployment Guide。