GPU について

Zivid SDK を最適に実行するには、ホストマシンに GPU が必要です。統合 GPU と専用 GPU はどちらも Zivid で適切に動作しますが、パフォーマンスの違いはキャプチャ時間にあります。

パフォーマンスに関する考慮事項

専用 GPU

A dedicated GPU gives the best performance with Zivid. It is also the best choice if the GPU will be used for more than Zivid's computations. A medium to high-end NVIDIA GPU with at least 3 GB of memory is required for optimal performance. This is the preferred solution for Zivid.

推奨事項:

デスクトップ用 NVIDIA GeForce GTX 1060 以上
ラップトップ用 NVIDIA GeForce MX150 以上

統合 GPU

This is the most cost-efficient solution for Zivid. The benefit of an integrated GPU is that the data transfer from GPU to CPU is fast. It is also beneficial for applications that require low power consumption, e.g., battery-powered mobile platforms. A high-end integrated GPU with at least 3 GB of memory available is required for optimal performance.

推奨事項:

HD630 以上を搭載した Intel i7

Nvidia Jetson Orin

Zivid は、Zivid SDK および追加ソフトウェアを実行するために、少なくとも 16GB の RAM を搭載した Jetson Orin ボードを推奨しています。

Zivid SDK は Jetson Orin Nano をサポートしていますが、Orin Nano の RAM は合計 4GB/8GB しかなく、CPU と GPU で共有されています。4GB では Zivid SDK を使用するアプリケーションを実行するには一般的に不十分であり、8GB でも多くのユースケース、特に長時間のキャプチャ、 Stripe/Omni エンジンの使用、および/または多数のフィルターの有効化には不十分です。したがって、Orin Nano を使用する場合は、アプリケーションの RAM 使用量を慎重に評価する必要があります。

警告

Jetson Orin ボードは、Zivid SDK の点群処理速度を著しく低下させる低電力プロファイルで起動する場合があります。最大電力プロファイルの設定については Jetson Linux に Zivid をインストールするを参照してください。

コンピューティングデバイスの選択

複数の GPU があり、Zivid SDK で特定の GPU を使用したい場合は、設定ファイルでコンピューティングデバイスを指定できます。Zivid SDK を CPU で実行するように構成することもできますが、CPU はサポートされていないコンピューティングデバイスモードです。

CUDA and OpenCL

Zivid SDK is available in two versions, a CUDA version and an OpenCL version. The version is selected when you install the SDK, not in the configuration file.

The CUDA version runs on NVIDIA GPUs only. The OpenCL version runs on Intel GPUs, and can run on NVIDIA GPUs as an unsupported compute device. To use an NVIDIA GPU as a supported compute device, install the CUDA version of the SDK.

Configuration file

ファイルがまだ存在しない場合は、 Config.yml ファイルをダウンロードして、次のディレクトリに配置します。

Windows

mkdir %LOCALAPPDATA%\Zivid\API
move %HOMEPATH%\Downloads\Config.yml %LOCALAPPDATA%\Zivid\API\

Ubuntu

mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
mv ~/Downloads/Config.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/

The desired GPU is assigned by changing the ComputeDevice parameters in the configuration file.

単一ベンダー

単一ベンダーの複数の GPU (例: 2 つの Nvidia GPU) がある場合、 SelectionFilter でどの GPU を使用するかを指定する必要があります。 clinfo を使用してすべてのコンピューティングデバイスをリストします。 clinfo の詳細、インストール方法、使用方法については、以下のドロップダウンに従ってください。

特定の GPU 名を見つけるには、 clinfo を実行してコンピューティングデバイスを一覧表示します。

clinfo -l

注釈

clinfo lists OpenCL devices and applies to the OpenCL version of the SDK. With the CUDA version, run nvidia-smi -L in a terminal instead, and use any unique part of the CUDA device name. Both commands run on Windows and Ubuntu. On Windows, clinfo is not installed by default and nvidia-smi may not be on the PATH.

設定ファイル内の SelectionFilter を、目的のデバイスの名前の一意の部分に変更します。たとえば、次の出力の NVIDIA GeForce RTX 3060 の場合、

../../../_images/clinfo_multiple_gpu_single_vendor.png

SelectionFilter を次のように設定します。

ComputeDevice:
    SelectionFilter: "RTX 3060"
    Type: Any
    Vendor: Any

複数のベンダー

If you have multiple GPUs from multiple vendors (e.g. an integrated Intel GPU and a dedicated NVIDIA GPU), change Type to GPU and Vendor to Nvidia or Intel, e.g.

ComputeDevice:
    SelectionFilter: ""
    Type: GPU
    Vendor: Nvidia

サポートされていないコンピューティングデバイスの有効化

Enabling unsupported compute devices can be done by enabling an option in the Configuration file. However, such a setup may give unexpected results and errors, and is not tested by Zivid. Currently, the unsupported compute devices are CPUs, AMD GPUs, and NVIDIA GPUs on the OpenCL version of the SDK.

ファイルがまだ存在しない場合は、 Config.yml ファイルをダウンロードし、次のディレクトリに配置します。

Windows

mkdir %LOCALAPPDATA%\Zivid\API
move %HOMEPATH%\Downloads\Config.yml %LOCALAPPDATA%\Zivid\API\

Ubuntu

mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
mv ~/Downloads/Config.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/

設定ファイルには次の情報が含まれています。 AllowUnsupported: yes によってサポートされていないコンピューティングデバイスが有効になります。

__version__:
    serializer: 1
    data: 19
Configuration:
    ComputeDevice:
        AllowUnsupported: yes

Enable NVIDIA on the OpenCL version

The OpenCL version of the SDK treats NVIDIA GPUs as unsupported compute devices. To run the OpenCL version on an NVIDIA GPU, set Vendor to Nvidia and AllowUnsupported to yes in the Config.yml. For a supported setup on NVIDIA GPUs, install the CUDA version of the SDK instead.

__version__:
    serializer: 1
    data: 19
Configuration:
    ComputeDevice:
        Type: GPU
        Vendor: Nvidia
        AllowUnsupported: yes

CPU を有効にする

Intel チップセット上で Zivid SDK を実行するには、 CPU Runtime for OpenCL を使用します。 Config.yml 内のコンピューティングデバイスの Type を CPU に、 Vendor を Intel に変更します。

__version__:
    serializer: 1
    data: 19
Configuration:
    ComputeDevice:
        Type: CPU
        Vendor: Intel
        AllowUnsupported: yes

警告

CPU はサポートされていないコンピューティングデバイスモードです。CPU を使用するとキャプチャ時間が大幅に増加するため、ほとんどのアプリケーションではこの設定は推奨されません。また、OpenCL プラットフォームが混在する環境では、CPU を選択するとクラッシュなどの不安定な動作を引き起こす可能性があります。

バージョン履歴

SDK	変更点
2.18.0	Added CUDA version of the SDK for NVIDIA GPUs. Added Jetson Thor support. Added support for Ubuntu 26.04.
2.12.0	Jetson Orin のサポートを追加しました。