HDF5 1.10.5 のインストール（ソースコードを使用）（Windows 上）

HDF5 は，階層データを保存・管理するためのライブラリである．Windows上でのインストール手順は以下の通り：Visual Studio 2017 のNative Toolsコマンドプロンプトを使用し，ソースコードをダウンロードして解凍．その後，ctestコマンドを使用してビルドとインストールを行う．最後に，システム環境変数（HDF5_ROOT，LIB）を適切に設定する．このプロセスにより，HDF5がシステム全体で利用可能になる．configure 版よりも CMake 版の方がWindowsでのインストールが簡単だと判断している．

【目次】

HDF の利用条件などは、利用者が確認すること．

前準備

Build Tools for Visual Studio 2017 （ビルドツール for Visual Studio 2017）もしくは Visual Studio 2017 のインストール（Windows 上）

Build Tools for Visual Studio 2017 （ビルドツール for Visual Studio 2017）もしくはVisual Studio 2017 を，前もってインストールしておく．NVIDIA CUDA の nvcc を機能させるため．

Build Tools for Visual Studio 2017 （ビルドツール for Visual Studio 2017） のインストール: 別ページ »で説明

Git，CMake のインストール（Windows 上）

Gitは，分散型のバージョン管理システム． CMakeは，クロスプラットフォームのビルドシステム生成ツール．

【手順】

  1. Windows で，コマンドプロンプトを管理者として実行

    コマンドプロンプトを管理者として実行: 別ページ »で説明

    次のコマンドを実行

    次のコマンドは，GitとCMakeをインストールし，Gitにパスを通すものである．

    次のコマンドでインストールされるGitは 「git for Windows」と呼ばれるものであり， Git，MinGW などから構成されている． 

    winget install --scope machine Git.Git
powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";c:\Program Files\Git\cmd\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
winget install --scope machine Kitware.CMake
powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";c:\Program Files\CMake\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"

【関連する外部ページ】

【関連項目】 Git バージョン管理システム, Git の利用, CMake ビルドシステム生成ツール, CMake の使用方法

hdf5 のインストール（Build Tools for Visual Studio を利用）（Windows 上）

  1. hdf5 のバージョン確認

    https://support.hdfgroup.org/ftp/HDF5/current/src

  2. Visual Studio の x64 Native Tools コマンドプロンプトを起動．

    Windows のスタートメニューで「Visual Studio 2017」の下の「VS2017 用 x64 Native Tools コマンドプロンプト」で起動する.（あるいは類似のものを探す）

  3. hdf5 の作業ディレクトリとインストールディレクトリを削除する 
    cd /d c:%HOMEPATH%
rmdir /s /q CMake-hdf5-1.10.5
  4. hdf5 のソースコードをダウンロード 
    cd /d c:%HOMEPATH%
del CMake-hdf5-1.10.5.zip
curl -O https://support.hdfgroup.org/ftp/HDF5/current/src/CMake-hdf5-1.10.5.zip
rmdir /s /q CMake-hdf5-1.10.5
powershell Expand-Archive -DestinationPath . CMake-hdf5-1.10.5.zip
  5. Windows で hdf5 を ソースコードからビルドし、インストールする

    【関連する外部ページ】 HDF5のページ: https://docs.hdfgroup.org/hdf5/v1_14/_intro_h_d_f5.html

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

    cd /d c:%HOMEPATH%
cd CMake-hdf5-1.10.5
ctest -S HDF5config.cmake,BUILD_GENERATOR=VS201764,INSTALL_DIR="C:/hdf5" -C Release -V -O hdf5.log
  6. 結果の確認

    次のような表示になる． 「100% tests passed. 0 tests failed out of 2681」のように表示される．

    なお Build Tools for Visual Studio 2017 よりも新しいバージョン (2019 や 2022）を使うと，エラーが出て，続行できないようである．

  7. Windows の システム環境変数 HDF5_ROOT の設定

    次のように設定する

    %HOMEPATH%\CMake-hdf5-1.10.5\hdf5-1.10.5

  8. Windows の システム環境変数 LIB の設定

    次のように追加する

    %HOMEPATH%\CMake-hdf5-1.10.5\build\bin\Release

【まとめ】 HDF5をダウンロード，ctestでビルド，環境変数を設定．