スレッド数を設定する手法

インテル® MKL で使用する OpenMP* スレッド数を指定するには、以下の手法を使用します。

OpenMP* またはインテル® MKL 環境変数のいずれかを設定します。
- OMP_NUM_THREADS
- MKL_NUM_THREADS
- MKL_DOMAIN_NUM_THREADS
OpenMP* またはインテル® MKL 関数のいずれかを呼び出します。
- omp_set_num_threads()
- mkl_set_num_threads()
- mkl_domain_set_num_threads()
- mkl_set_num_threads_local()

注

mkl_set_num_threads または mkl_domain_set_num_threads 関数の呼び出しは、(ほかのスレッドで) 処理中のすべての呼び出しと以降のインテル® MKL 呼び出しで利用可能な OpenMP* スレッド数を変更します。これにより、インテル® MKL のパフォーマンスが低下したり、インテル® Inspector などのランタイムツールによって競合状態が報告されることがあります。

このような状況を回避するには、mkl_set_num_threads_local 関数を使用します (関数の説明は、『インテル® MKL デベロッパー・リファレンス』の「Support Functions」セクションの章を参照してください。

手法を選択する場合、以下の規則を考慮してください。

インテル® MKL スレッド化コントロールは最初に検査されるため、OpenMP* コントロールよりも優先されます。
関数呼び出しは環境設定よりも優先されます。ただし、OpenMP* サブルーチン omp_set_num_threads() の呼び出しは例外で、インテル® MKL 環境変数 (MKL_NUM_THREADS など) の設定が優先されます。詳細は、「新しいスレッド化コントロールの使用」を参照してください。
環境変数はインテル® MKL を最初に呼び出したときに一回のみ読み込まれるため、環境変数を使用して実行中の動作を変更することはできません。

インテル® TBB スレッディング・テクノロジーを使用してプログラムをスレッド化する場合のスレッド数の指定方法は、https://www.threadingbuildingblocks.org/documentation にある tbb::task_scheduler_init クラスの説明を参照してください。