トップページインストール,使い方Windows の種々のソフトウェア(インストール,使い方)Windows で flann 最新版をソースコードからビルドして、インストールする.CUDA対応可に設定(マイクロソフト C++ ビルドツール (Build Tools) を使用)

Windows で flann 最新版をソースコードからビルドして、インストールする.CUDA対応可に設定(マイクロソフト C++ ビルドツール (Build Tools) を使用)

Windows で,flann 最新版をソースコードからビルドして,インストールする手順をスクリーンショット等で説明する.

flannは、高次元空間での近似最近傍探索(approximate nearest neighbor searches)を行うライブラリ.マイクロソフト C++ ビルドツールを使用する.GPUを利用するように設定する手順も説明する.

目次

※ flann の利用条件などは、利用者が確認すること。次のWeb ページを活用してください

https://github.com/flann-lib/flann

謝辞

flann の作者に感謝します

前準備

Build Tools for Visual Studio 2022 (ビルドツール for Visual Studio 2022)のインストール

Build Tools for Visual Studio は,Windows で動くMicrosoft の C++ コンパイラーである.

ダウンロードページ

https://visualstudio.microsoft.com/ja/downloads/

詳細説明

Build Tools for Visual Studio 2022 (ビルドツール for Visual Studio 2022)のインストール: 別ページで説明している.

インストール手順の概要

  1. ダウンロード URL を開く

    https://visualstudio.microsoft.com/ja/downloads/

  2. このページの「Build Tools のダウンロード」をクリック
  3. ダウンロードが始まる
  4. ダウンロードした .exe ファイルを実行する
  5. 表示を確認し,「続行」をクリック
  6. C++ によるデスクトップ開発」をクリック.「インストール」をクリック.

    [image]

Git のインストール

Git のページ https://git-scm.com/ からダウンロードしてインストール:

cmake のインストール

cmake のダウンロードページ: https://cmake.org/download/

zlib のインストール

liblz4 のインストール

hdf5 のインストール

NVIDIA ドライバ,NVIDIA CUDA ツールキット 11.7.0, NVIDIA cuDNN 8.4.1 のインストール

GPU は,グラフィックス・プロセッシング・ユニットの略で、コンピュータグラフィックス関連の機能,乗算や加算の並列処理の機能などがある. NVIDIA CUDA ツールキット は,NVIDIA社が提供している GPU 用のプラットフォームである.

【インストール手順の詳細説明】

NVIDIA ドライバについて

  1. 古いNVIDIA ドライバ,NVIDIA CUDA がインストール済みのとき,不要なものがあればアンインストール

    Windows のスタートメニューで「設定」,「アプリ」と操作して,「NVIDIA ・・・」を削除

  2. NVIDIA グラフィックス・カードの種類を調べる

    hwinfo (URL: https://www.hwinfo.com) を使って調べることができる.

  3. あとで,NVIDIA CUDA ツールキットをインストールするときに,NVIDIA ドライバを同時にインストールすることができる.

    あとで、NVIDIA CUDA ツールキットをインストールするので、そのときに、NVIDIA ドライバもインストールすることにする.次へ進む.

    但し, NVIDIA CUDA ツールキットの古いバージョンを使う場合には,次のページから,最新のNVIDIA ドライバをダウンロードして,インストールする.

    NVIDIA ドライバのダウンロードページ: https://www.nvidia.co.jp/Download/index.aspx?lang=jp

NVIDIA CUDA ツールキット 11.7.0,NVIDIA cuDNN 8.4.1 のインストール

Windows での NVIDIA ドライバ,NVIDIA CUDA ツールキット 11.6.2NVIDIA cuDNN v8.4.0 のインストール: 別ページで説明している.

flann のインストール(マイクロソフト C++ ビルドツール (Build Tools) を使用)

  1. Visual Studio の x64 Native Tools コマンドプロンプトを開く.

    起動は,Windows のメニューで「Visual Studio 20..」の下の「x64 Native Tools コマンドプロンプト (x64 Native Tools Command Prompt)」を選ぶ.「x64」は,64ビット版の意味である.

    「x64 Native Tools コマンドプロンプト (x64 Native Tools Command Prompt)」がないとき:

    C++ ビルドツール (Build Tools) のインストールを行うことで, 「x64 Native Tools コマンドプロンプト (x64 Native Tools Command Prompt)」がインストールされる.その手順は,別ページで説明している

  2. flann のインストールディレクトリを削除する
    cd %LOCALAPPDATA%
    rmdir /s /q flann
    

    [image]
  3. flann のソースコードをダウンロード
    cd %LOCALAPPDATA%
    git clone https://github.com/mariusmuja/flann
    

    [image]
  4. cmake の実行

    cmake でのオプションについて

    cmake のオプションの 「Visual Studio 16 2019」のところは, 使用する Visual Studio のバージョンにあわせること. Visual Studio 2022 のときは,「Visual Studio 17 2022」. Visual Studio 2019 のときは,「Visual Studio 16 2019

    cmake の実行手順例は次の通り

    cd %LOCALAPPDATA%
    cd flann
    del CMakeCache.txt
    rmdir /s /q build
    mkdir build
    cd build
    del CMakeCache.txt
    cmake -G "Visual Studio 16 2019" -T host=x64 ^
        -DCMAKE_INSTALL_PREFIX="c:\flann" ^
        -DBUILD_EXAMPLES=ON ^
        -DBUILD_PYTHON_BINDINGS=OFF ^
        -DBUILD_CUDA_LIB=ON ^
        -DHDF5_C_INCLUDE_DIR="%LOCALAPPDATA%\CMake-hdf5-1.10.4\hdf5-1.10.4\c++\src" ^
        -DHDF5_DIFF_EXECUTABLE="%LOCALAPPDATA%\CMake-hdf5-1.10.4\build\bin\Release\h5diff.exe" ^
        -DHDF5_DIR="%LOCALAPPDATA%\CMake-hdf5-1.10.4\hdf5-1.10.4" ^
        -DHDF5_hdf5_LIBRARY_RELEASE="%LOCALAPPDATA%\CMake-hdf5-1.10.4\build\bin\Release\hdf5.lib" ^
    ..
    

    [image]
  5. cmake の実行結果の確認

    ※ 下図のとおりになるとは限らない.自動設定がうまくいっていない場合は、1つ上の「cmake の実行」のところを、設定を変えてやり直す

    [image]
  6. ソースコードからビルドし、インストールする
    cmake --build . --config RELEASE --target INSTALL
    

    [image]
  7. 結果の確認

    エラーメッセージが出ていないことを確認.最後のほうに「0 エラー」のように表示されるのを確認.

    ※ 黄色の警告メッセージは無視しても良い

    [image]
    ※ ここでエラーメッセージが出たときは、
  8. システム環境変数 FLANN_ROOT の設定

    次のように設定する

    %LOCALAPPDATA%\flann

    [image]
  9. システム環境変数 LIB の設定

    次のように追加する

    %LOCALAPPDATA%\flann\lib

    [image]
  10. 動作確認

    https://usermanual.wiki/Document/flannmanual184.1650808969/html の PDF ファイルに掲載のプログラムを動作確認に使用

    VS 2017用 x64 Native Tools コマンドプロンプトで、次を実行する。エラーメッセージが出なければOKとする

    cd %LOCALAPPDATA%\flann\examples
    cl flann_example.cpp ^
      /I %LOCALAPPDATA%\flann\include ^
      /I %LOCALAPPDATA%\CMake-hdf5-1.10.4\hdf5-1.10.4\src ^
      /I %LOCALAPPDATA%\CMake-hdf5-1.10.4\build ^
      -o flann_example_cpp.exe ^
      libhdf5.lib liblz4.lib zlib.lib msvcrt.lib
    

    [image]

    ビルドでエラーメッセージが出たときは、

    を確認する

  11. GNU の C++ コンパイラでも動作確認 Windows のコマンドプロンプトで、次を実行する.エラーメッセージが出なければOKとする

    cd %LOCALAPPDATA%\flann\examples
    g++ flann_example.cpp ^
      -I %LOCALAPPDATA%\flann\include ^
      -o flann_example_cpp.exe ^
      %LOCALAPPDATA%\CMake-hdf5-1.10.4\build\bin\Release\hdf5.lib -llz4
    

    [image]