Eigen3ライブラリのインストール(ソースコードを用いたインストール)(Build Tools for Visual Studio を使用)と使用方法(Windows 上)
【目次】
- 前準備
- Eigen3ライブラリのインストール(ソースコードを用いたインストール)(Build Tools for Visual Studio を使用)と使用方法(Windows 上)
- Eigen 3 の動作確認
Eigen 3
Eigen 3 は, 次の機能を持つ C++ テンプレートライブラリ.SSEを使うように最適化されている.
- 線形演算:行列,ベクトル,数値解析,その他関連のアルゴリズム
【関連する外部ページ】
- Eigen 3 の公式ページ: https://eigen.tuxfamily.org/index.php
【サイト内の関連ページ】
前準備
Build Tools for Visual Studio 2026 のインストール(Windows 上) [クリックして展開]
Build Tools for Visual Studio は,Visual Studio の IDE を含まない C/C++ コンパイラ,ライブラリ,ビルドツール等のコマンドライン向け開発ツールセットである。インストール済みの場合、この手順は不要である。
管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。
REM VC++ ランタイム
winget install --scope machine --id Microsoft.VCRedist.2015+.x64 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet /norestart"
REM Build Tools + Desktop development with C++(VCTools)+ 追加コンポーネント(一括)
winget install --scope machine --id Microsoft.VisualStudio.BuildTools -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "--quiet --wait --norestart --nocache --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100"
--add で追加されるコンポーネント
上記のコマンドでは,まず Build Tools 本体と Visual C++ 再頒布可能パッケージをインストールし,次に setup.exe を用いて以下のコンポーネントを追加している。
VCTools:C++ デスクトップ開発ワークロード(--includeRecommendedにより、MSVC コンパイラ、C++ AddressSanitizer、vcpkg、CMake ツール、Windows 11 SDK 等の推奨コンポーネントが含まれる)VC.Llvm.Clang:Windows 向け C++ Clang コンパイラClangCL:clang-cl ツールセットを含むコンポーネントグループ(MSBuild から Clang を使用するために必要)VC.CMake.Project:Windows 向け C++ CMake ツールWindows11SDK.26100:Windows 11 SDK(ビルド 10.0.26100)
インストール完了の確認
winget list Microsoft.VisualStudio.BuildTools
上記以外の追加のコンポーネントが必要になった場合は Visual Studio Installer で個別にインストールできる。
Visual Studio の機能を必要とする場合は、追加インストールできる。
Git のインストール(Windows 上) [クリックして展開]
管理者権限のコマンドプロンプトで以下を実行する.管理者権限は,winget の --scope machine オプションでシステム全体にインストールするために必要となる.
REM Git をシステム領域にインストール
winget install --scope machine --id Git.Git -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/VERYSILENT /NORESTART /NOCANCEL /SP- /CLOSEAPPLICATIONS /RESTARTAPPLICATIONS /COMPONENTS=""icons,ext\reg\shellhere,assoc,assoc_sh"" /o:PathOption=Cmd /o:CRLFOption=CRLFCommitAsIs /o:BashTerminalOption=MinTTY /o:DefaultBranchOption=main /o:EditorOption=VIM /o:SSHOption=OpenSSH /o:UseCredentialManager=Enabled /o:PerformanceTweaksFSCache=Enabled /o:EnableSymlinks=Disabled /o:EnableFSMonitor=Disabled"
CMakeのインストール(Windows 上) [クリックして展開]
管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。
REM CMake をシステム領域にインストール
winget install --scope machine --id Kitware.CMake -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/qn /norestart ADD_CMAKE_TO_PATH=System"
NVIDIA CUDA Toolkit 12.8のインストール
- 前提条件(NVIDIA CUDA Toolkit インストール前): NVIDIA GPU,NVIDIA ドライバ,および Build Tools for Visual Studio もしくは Visual Studio が必要である.
- インストール中の注意: なるべく他のウインドウはすべて閉じておくこと.
以下のコマンドを管理者権限のコマンドプロンプトで実行する
(手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。
REM NVIDIA CUDA Toolkit 12.8 をシステム領域にインストール
winget install --scope machine --id Nvidia.CUDA --version 12.8 -e --silent --disable-interactivity --force --uninstall-previous --accept-source-agreements --accept-package-agreements --override "-s -n"
REM 環境変数TEMP, TMPの設定(一時ファイルの保存先を短いパスに変更)
mkdir C:\TEMP
set "TEMP_PATH=C:\TEMP"
setx TEMP "%TEMP_PATH%" /M >nul
setx TMP "%TEMP_PATH%" /M >nul
Eigen3ライブラリのインストール(ソースコードを用いたインストール)(Build Tools for Visual Studio を使用)と使用方法(Windows 上)
Boost のインストール
(オプション)OpenBLAS のインストール
必ずしも必要ではないが,必要になったときはインストールする.
(オプション)数値演算ライブラリ等のインストール(vcpkg を使用)
必ずしも必要ではないが,必要になったときはインストールする.
- 事前にvcpkg のインストールを行っておく.
- コマンドプロンプトを管理者として開き次のコマンドを実行する.
c:\vcpkg\vcpkg --triplet x64-windows install blas fftw3[sse,sse2,avx,avx2,threads] gmp hwloc metis mpfr openblas[threads] pthread superlu - Windows の システム環境変数 PATHに,c:\vcpkg\installed\x64-windows\bin を追加して,パスを通す.
Windows で,管理者権限でコマンドプロンプトを起動(手順:Windowsキーまたはスタートメニュー >
cmdと入力 > 右クリック > 「管理者として実行」)。次のコマンドを実行
powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";c:\vcpkg\installed\x64-windows\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
Eigen3ライブラリのインストール(ソースコードを用いたインストール)(Build Tools for Visual Studio を使用)と使用方法(Windows 上)
このページでは,c:\eigen 下にインストールするものとして説明する.
- 以下の操作を管理者権限のコマンドプロンプトで実行する
(手順:Windowsキーまたはスタートメニュー →
cmdと入力 → 右クリック → 「管理者として実行」)。 - ソースコードのダウンロード
次のコマンドを実行
cd /d c:%HOMEPATH% rmdir /s /q eigen git clone https://gitlab.com/libeigen/eigen.git
- cmake の実行
cmake の実行手順例は次の通り
cd /d c:%HOMEPATH% cd eigen rmdir /s /q build mkdir build cd build del CMakeCache.txt rmdir /s /q CMakeFiles cmake .. -A x64 -T host=x64 ^ -DEIGEN_BUILD_BLAS=OFF ^ -DEIGEN_BUILD_LAPACK=OFF ^ -DBoost_INCLUDE_DIR="%Boost_INCLUDE_DIR%" ^ -DCUDA_NVCC_FLAGS="-allow-unsupported-compiler" ^ -DCMAKE_INSTALL_PREFIX="c:/eigen" ^ -DEIGEN_TEST_CUDA=ON
(以下省略)上に示した「実行手順例」でのcmake でのオプションを調整するとしたら
- vcpkg でインストールした数値演算ライブラリがあるとき
次のようなオプションを付ける.
-DVCPKG_TARGET_TRIPLET=x64-windows ^ -DCMAKE_TOOLCHAIN_FILE=C:/vcpkg/scripts/buildsystems/vcpkg.cmake ^
- vcpkg でインストールした数値演算ライブラリがあるとき
- cmake の実行結果の確認
* 下の通りになるとは限らない.エラーメッセージが出るなど場合は,前で cmake を実行したときの設定を変えてやり直す.
- ソースコードからビルドし、インストールする
cmake --build . --config Release --target INSTALL -- /m:4 - 実行結果の確認
- Windows の システム環境変数 EIGEN_ROOT に,c:\eigen を設定
次のコマンドを実行
powershell -command "[System.Environment]::SetEnvironmentVariable(\"EIGEN_ROOT\", \"c:\eigen\", \"Machine\")"
Eigen 3 の動作確認
ソースコード
Eigen 3ライブラリを使用して,Eigen 3 の行列演算の基本機能を実行する. プログラムでは,3x3行列と3次元ベクトルを用いて,乗算,転置,逆行列計算,固有値・固有ベクトル計算,LU分解を行い,結果を表示する.C++で書かれており,出力にはprintfを使用している.
#include
#include
using namespace Eigen;
int main()
{
printf("Eigen3 Demo Program\n\n");
// 行列演算
Matrix3f A;
A << 1, 2, 3,
4, 5, 6,
7, 8, 9;
Vector3f v(1, 2, 3);
printf("Matrix A:\n");
printf("%f %f %f\n%f %f %f\n%f %f %f\n\n",
A(0,0), A(0,1), A(0,2),
A(1,0), A(1,1), A(1,2),
A(2,0), A(2,1), A(2,2));
printf("Vector v:\n");
printf("%f\n%f\n%f\n\n", v(0), v(1), v(2));
Vector3f result = A * v;
printf("A * v =\n");
printf("%f\n%f\n%f\n\n", result(0), result(1), result(2));
// 行列の転置と逆行列
printf("A transpose:\n");
Matrix3f AT = A.transpose();
printf("%f %f %f\n%f %f %f\n%f %f %f\n\n",
AT(0,0), AT(0,1), AT(0,2),
AT(1,0), AT(1,1), AT(1,2),
AT(2,0), AT(2,1), AT(2,2));
printf("A inverse:\n");
Matrix3f AI = A.inverse();
printf("%f %f %f\n%f %f %f\n%f %f %f\n\n",
AI(0,0), AI(0,1), AI(0,2),
AI(1,0), AI(1,1), AI(1,2),
AI(2,0), AI(2,1), AI(2,2));
// 固有値と固有ベクトル
EigenSolver es(A);
printf("Eigenvalues of A:\n");
for (int i = 0; i < 3; i++) {
printf("%f + %fi\n", es.eigenvalues()(i).real(), es.eigenvalues()(i).imag());
}
printf("\n");
printf("Eigenvectors of A:\n");
for (int i = 0; i < 3; i++) {
for (int j = 0; j < 3; j++) {
printf("%f + %fi ", es.eigenvectors()(i,j).real(), es.eigenvectors()(i,j).imag());
}
printf("\n");
}
printf("\n");
// 行列分解 (LU分解)
FullPivLU lu(A);
printf("LU decomposition of A:\n");
printf("L:\n");
Matrix3f L = lu.matrixLU().triangularView();
L.diagonal().setOnes(); // Set diagonal elements to 1
printf("%f %f %f\n%f %f %f\n%f %f %f\n\n",
L(0,0), L(0,1), L(0,2),
L(1,0), L(1,1), L(1,2),
L(2,0), L(2,1), L(2,2));
printf("U:\n");
Matrix3f U = lu.matrixLU().triangularView();
printf("%f %f %f\n%f %f %f\n%f %f %f\n\n",
U(0,0), U(0,1), U(0,2),
U(1,0), U(1,1), U(1,2),
U(2,0), U(2,1), U(2,2));
return 0;
}
実行手順
- 以下の操作をx64 Native Tools コマンドプロンプト (x64 Native Tools Command Prompt)で実行する
(手順:スタートメニュー →
」の下の「x64 Native Tools コマンドプロンプト (x64 Native Tools Command Prompt)」を選ぶ)。 - cd コマンドでソースファイルのあるディレクトリに移動する.
- 次のコマンドでコンパイルする:
プログラムを,ファイル名 a.cpp で保存しているものとする.
cl /EHsc /utf-8 /I "C:\eigen\include\eigen3" a.cpp
- 実行する
a.exe