インストールと環境設定#
pypylonの背景情報については、はじめにを参照してください。
pylon Software Suiteのインストール#
Basler pylon Software Suiteを、pypylonおよび3Dカメラなどの必要な追加パッケージと一緒にインストールします。
情報
pypylonのホイールパッケージには、すでにpylon C++ランタイムとvToolsが含まれています。これはpypylonを使用するのに十分であり、追加のドライバーを必要としないトランスポートレイヤーに対してすぐに機能します。
必要に応じて、pylon Software Suiteおよび3Dカメラ用の追加パッケージなどをBaslerウェブサイトからダウンロードできます。
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を参照してください。