このページの一部は機械翻訳であり、まだ人による確認が行われていません。

カメラの接続時間が長い

問題

カメラを初めて PC に接続するプロセスでは、接続を確立するのに時間がかかります。

原因

OpenCL カーネルは、カメラが接続されている特定のハードウェア用に構築されていますが、カメラが PC との接続を確立するまでは不明です。これらのカーネルの構築には、合計接続時間のかなりの時間がかかり、プロセス内でカメラが初めて接続されるときに行われます。

プロセス (具体的には Zivid アプリケーション) が存続している場合、カーネルを再構築する必要はありません。

解決

カーネルをキャッシュすることで、カメラに接続するたびにカーネルを再構築する必要がなくなります。初めて接続するときはまだ遅いですが、その後接続するたびに高速になることに注意してください。特定のハードウェアの指示に従ってください。

Windows
Intel

Intel ドライバーを最新バージョンにアップグレードして、 Intel Driver & Support assistant を使用して OpenCL カーネルのキャッシュを有効にしてください。キャッシュが正しく行われていることを確認するには、フォルダー %LocalAppData%/NEO/neo_compiler_cache が存在し、空でないことを確認してください。

Intel ドライバーをアップグレードしても問題が解決しない場合は、手動でキャッシュを許可することができます (実験的)。詳しい手順については、下のドロップダウンに従ってください。

キャッシュを手動で有効にする (実験的)

この方法は Intel Graphics Compute Runtime では非推奨かつ実験的と見なされていますが、ドライバーが更新されるまでの一時的な解決策です。Windows における cl_cache の制限については Intel Graphics Compute Runtime に記載されているため注意してください。また、本番環境以外のセットアップでのみ使用することを検討してください。

  1. キャッシュされたカーネルを保存したいフォルダを作成します。例 %LocalAppData%/NEO/neo_compiler_cache

  2. 新しい環境変数 cl_cache_dir を追加し、その値をキャッシュフォルダのパスに設定します。例 %LocalAppData%/NEO/neo_compiler_cache

変更を有効にするには、コンピュータを再起動する必要がある場合があります。

NVIDIA

ほとんどの NVIDIA GPU とドライバーでは、デフォルトでキャッシュがオンになっている必要があります。それでも接続時間が遅い場合は、 NVIDIA GPU の最新ドライバーに更新してみてください。

キャッシュが正しく機能していることを確認するには、フォルダー %AppData%/NVIDIA/ComputeCache が存在し、空でないことを確認してください。

Ubuntu
Intel

OpenCL ドライバーを利用可能な最新バージョンにアップグレードして、OpenCL カーネルのキャッシュを可能にします。

sudo apt update && sudo apt upgrade intel-opencl-icd

リポジトリ内の最新バージョンで不十分な場合は、 intel/compute-runtime から最新のリリースパッケージを使用できます。キャッシュが正しく行われていることを確認するには、フォルダー $HOME/.cache/neo_compiler_cache が存在し、空でないことを確認してください。

Intel ドライバーをアップグレードしても問題が解決しない場合は、キャッシュを手動で許可できます。詳細な手順については、以下のドロップダウンに従ってください。

キャッシュを手動で有効にする
  1. キャッシュされたカーネルを保存するフォルダーを作成します (例 $HOME/.cache/neo_compiler_cache

  2. 新しい環境変数 cl_cache_dir を追加し、その値をキャッシュ フォルダーのパスに設定します (例 $HOME/.cache/neo_compiler_cache

mkdir $HOME/.cache/neo_compiler_cache
export cl_cache_dir=$HOME/.cache/neo_compiler_cache

キャッシュは現在のセッション中、永続的に保存されるようになりました。

NVIDIA

ほとんどの NVIDIA GPU とドライバーでは、デフォルトでキャッシュがオンになっている必要があります。それでも接続時間が遅い場合は、 NVIDIA GPU の最新ドライバーに更新してみてください。

キャッシュが正しく機能していることを確認するには、フォルダー $HOME/.nv/ComputeCache が存在し、空でないことを確認してください。

ドッカー

Docker コンテナからカメラに接続する場合、最初の接続を改善するために、ホスト上のキャッシュディレクトリをコンテナのルートディレクトリにマウントする必要があります。これは、各 Docker コンテナが独自のファイルシステムを持ち、コンテナが起動されるたびにキャッシュディレクトリが空になるためです。

以下の手順は、カメラへの初回接続を改善することのみを目的としており、コンテナを最初に実行する場合にのみ適用されます。ホストマシンに既にキャッシュされたカーネルが必要であることに注意してください。

Windows

現在、Windows は Docker ではサポートされていません。これは、Docker コンテナ内では Windows 上で OpenCL が完全にサポートされていないためです。

Ubuntu
Intel

カーネルキャッシュの場所は、環境変数 NEO_CACHE_DIR に基づいて決定されます。この環境変数のデフォルト値は、ホストマシン上の $HOME/.cache/neo_compiler_cache です。キャッシュを共有するには、実行時にこのディレクトリをコンテナのルートディレクトリにマウントしてください。

ホームディレクトリに root ユーザーが所有するファイルが作成されないようにするには、まずキャッシュを root ディレクトリにコピーしてください。

sudo rsync -r --mkpath "$HOME"/.cache/neo_compiler_cache/ /root/.cache/neo_compiler_cache/
sudo docker run --interactive --tty --device=/dev/dri --volume /root/.cache/neo_compiler_cache:/root/.cache/neo_compiler_cache <image>

ここで <image> は実行したいイメージの名前です。

NVIDIA

カーネルキャッシュはホストマシンの $HOME/.nv/ComputeCache に保存されます。キャッシュを共有するには、実行時にこのディレクトリをコンテナのルートディレクトリにマウントしてください。

ホームディレクトリに root ユーザーが所有するファイルが作成されないようにするには、まずキャッシュを root ディレクトリにコピーしてください。

sudo rsync -r --mkpath "$HOME"/.nv/ComputeCache /root/.nv/ComputeCache
sudo docker run --interactive --tty --device=/dev/dri --gpus=all --volume /root/.nv/ComputeCache:/root/.nv/ComputeCache <image>

ここで <image> は実行したいイメージの名前です。