インテル^® マス・カーネル・ライブラリー 9.0
Mac OS* 版入門ガイド 

資料番号: 310706-003J

目次

概要
はじめに
    ディレクトリー構造の概要
    ディレクトリー構造の詳細
インテル MKL の構成
アプリケーションとインテル MKL のリンク
スレッド化
著作権と商標について

概要

本ガイドは、インストール後に実行する必要のある手順や簡単な使用例など、インテル^® マス・カーネル・ライブラリー (インテル^® MKL) Mac OS* 版の習得に役立つ情報を提供します。アプリケーションのライブラリーへのリンク方法、ライブラリーの構成方法、その他の基本的な手順について説明します。

本ガイドは、インテル MKL が既にマシンにインストールされていることを前提として説明しています。

製品をまだインストールしていない場合は、「インストール・ガイド」 (Install.txt ファイル) を参照してください。

はじめに

インテル MKL のインストール後、インストールとライブラリーの構成が適切に行われたかどうかを次の手順で確認すると良いでしょう。 

1. 指定したインストール・ディレクトリーが作成されたか確認します。デフォルトは、/Library/Frameworks/Intel_MKL.framework/Versions/9.0 です。
2. 複数のバージョンのインテル MKL をマシンにインストールしている場合は、ビルドスクリプトを更新して、使用するバージョンのインテル MKL を指定します。1 台のマシンに複数のバージョンのインテル MKL をインストールすることができますが、ベータ版はアンインストールしなければならない点に注意してください。
3. mklvars32.sh ファイルが tools/environment ディレクトリーに配置されていることを確認します。
   これらのファイルを使用して、ユーザーシェルで環境変数 INCLUDE および DYLD_LIBRARY_PATH を設定することができます。

ディレクトリー構造の概要

インストール後のインテル MKL のディレクトリー構造を以下に示します。

ディレクトリー構造の詳細

インテル MKL Mac OS 版は、次の 2 つで構成されています。

• 高度なライブラリー (LAPACK)
• libmkl_ia32.a のカーネル

また、スレッド化アプリケーションは次のように提供されます。

• (libguide.a) 静的にリンクするスタティック・リンク・ライブラリー (階層化されたソフトウェアの複数のコピーで静的リンクを行うと性能上の問題が、複数のコピーが初期化された場合は正当性問題がそれぞれ発生することがあるため、非推奨)
• (libguide.dylib) インテル MKL に動的にリンクするダイナミック・リンク・ライブラリー (推奨)

ライブラリーの詳細なディレクトリー構造を次に示します。

以下のインターフェイス・ライブラリーとモジュールは、interfaces フォルダーにある makefile を処理すると生成されます。

インテル MKL の構成

インストール後、tools/environment ディレクトリーにある mklvars32.sh ファイルを使用して、ユーザーシェルで環境変数 INCLUDE と DYLD_LIBRARY_PATH を設定できます。

アプリケーションとインテル MKL のリンク

インテル MKL のライブラリーへリンクするための一般的な形式を次に示します。

<リンクするファイル>
-L<MKL パス>
{[-lmkl_lapack] -lmkl_ia32, [-lmkl_lapack{32,64}] -lmkl, -lvml}
-lguide -lpthread

各ファイルには、次のものが含まれています。
libmkl_lapack.a、libmkl_lapack32.dylib および libmkl_lapack64.dylib: LAPACK 関数。
libmkl_ia32.a: BLAS、DFT、VML、VSL、区間演算関数。
libmkl_lapack95.a、 libmkl_blas95.a: それぞれ LAPACK95 インターフェイスと BLAS95 インターフェイス。これらは、オリジナルのディストリビューションには含まれないため、インターフェイスを使用する前にビルドする必要があります (ライブラリーのビルドについての詳細は、次の「Fortran-95 インターフェイスおよび LAPACK と BLAS へのラッパーを使用する際の注意」を参照してください)。

すべての場合において、ランタイム時に適切なライブラリーがロードされます。インテル・コンパイラーを使用してリンクする場合の例をいくつか以下に示します。

ifort myprog.f -L$MKLPATH -lmkl_lapack -lmkl_ia32 -lguide -lpthread
        ユーザーコード myprog.f、LAPACK、カーネルのスタティック・リンク。
ifort myprog.f -L$MKLPATH -lmkl_lapack95 -lmkl_lapack -lmkl_ia32 -lguide -lpthread
        Fortran-95 LAPACK インターフェイスとカーネルのスタティック・リンク。
icc myprog.c -L$MKLPATH -lmkl_ia32 -lguide -lpthread -lm
        ユーザーコード myprog.c、BLAS、VML/VSL、区間演算、DFT のスタティック・リンク。
icc myprog.c -L$MKLPATH -lmkl -lguide -lpthread
        ユーザーコード myprog.c、BLAS またはインテル MKL の DFT のスタティック・リンク。

注意: libguide を静的にリンクする場合 (非推奨)

• インテル・コンパイラーを使用する場合、コンパイラー付属の libguide バージョンにリンクしてください。つまり、-openmp オプションを使用してください。
• インテル・コンパイラーを使用しない場合は、インテル MKL 付属の libguide バージョンにリンクしてください。

インテル MKL に動的にリンクする場合 (libguide.dylib) (推奨)、DYLD_LIBRARY_PATH が定義されていることを確認し、正確にこのバージョンの libguide が検出され、ランタイム時に使用されるようにしてください。

インテル MKL を使用したリンクおよびアプリケーションの実行に関する詳細は、「テクニカル・ユーザー・ノート」を参照してください。

Fortran-95 インターフェイスは、純粋なプロシージャーのために、ラッパーとともにソースとして提供されます。これらを使用する最も簡単な方法は、対応するライブラリーをビルドし、ユーザー・ライブラリーとしてリンクする方法です。この方法では、ユーザーは管理者権限を保持していることが前提です。製品ディレクトリーに書き込み権限があれば、手順は簡単です。mkl/9.0/interfaces/blas95 または mkl/9.0/interfaces/lapack95 に移動し、次のコマンドを入力します。

make lib

この結果、必要なライブラリーと .mod ファイルがビルドされ、リリースの標準カタログにインストールされます。.mod ファイルは、ifort -c mkl_lapack.f90 インターフェイスまたは ifort -c mkl_blas.f90 インターフェイスのファイルからも入手できます。ファイルは include ディレクトリーに保存されています。
管理者権限がない場合は、次の操作を行ってください。

1. ディレクトリー全体 (mkl/9.0/interfaces/blas95 または mkl/9.0/interfaces/lapack95) をユーザー定義のディレクトリー <user_dir> にコピーします。
2. 対応するファイル (mkl_blas.f90 または mkl_lapack.f90) を mkl/9.0/include からユーザー定義のディレクトリー <user_dir>/blas95 または <user_dir>/lapack95 にそれぞれコピーします。
3. <user_dir>/blas95 または <user_dir>/lapack95 で環境変数を追加し、上記コマンドを実行します。例を以下に示します。
   make INTERFACE=mkl_blas.f90 lib.

これで、必要なライブラリーと .mod ファイルがビルドされ、それぞれ <user_dir>/blas95 ディレクトリーまたは <user_dir>/lapack95 ディレクトリーにインストールされます。

デフォルトでは、ifort コンパイラーが使用されると想定されています。make FC=<compiler> のパラメーターでこれを変更することができます。

上級ユーザーの場合は、ライブラリーをビルドしなくてもインターフェイスを使用することができます。

ビルド・ディレクトリーからライブラリーを削除するには、make clean コマンドを使用します。

スレッド化

インテル MKL は、多くの個所でスレッド化されています。また、OpenMP* ソフトウェアを使用しています。

OpenMP ソフトウェアは、使用するスレッド数を設定する OMP_NUM_THREADS 環境変数を基にスレッド化を実行します。スレッド数は、プログラムを実行するシェルで設定することができます。

変数 OMP_NUM_THREADS が設定されていない場合、インテル MKL ソフトウェアはスレッド数を 1 として実行します。OMP_NUM_THREADS は、常にアプリケーションで使用するプロセッサー数に設定しておくことを推奨します。

1D FFT における 2 の累乗データについては、インテル MKL はインテル^® Itanium^® プロセッサー用にのみ並列化を行うことに注意してください。

スレッド数を変更するには、プログラムを実行するコマンドライン・シェルで次のように入力します。

export OMP_NUM_THREADS=<使用するスレッド数>

インテル MKL のテクニカル情報に関する詳細は、「テクニカル・ユーザー・ノート 」 (mkluse.html) を参照してください。

著作権と商標について

本資料に掲載されている情報は、インテル製品の概要説明を目的としたものです。本資料は、明示されているか否かにかかわらず、また禁反言によるとよらずにかかわらず、いかなる知的財産権のライセンスを許諾するためのものではありません。製品に付属の売買契約書『Intel's Terms and Conditions of Sale』に規定されている場合を除き、インテルはいかなる責を負うものではなく、またインテル製品の販売や使用に関する明示または黙示の保証 (特定目的への適合性、商品性に関する保証、第三者の特許権、著作権、その他、知的所有権を侵害していないことへの保証を含む) にも一切応じないものとします。インテル製品は、医療、救命、延命措置、重要な制御または安全システム、核施設などの目的に使用することを前提としたものではありません。
インテル製品は、予告なく仕様や説明が変更される場合があります。

本資料で説明されているソフトウェアには、不具合が含まれている可能性があり、公開されている仕様とは異なる動作をする場合があります。現在までに判明している不具合の情報については、インテルのサポートサイトをご覧ください。

本資料およびこれに記載されているソフトウェアはライセンス契約に基づいて提供されるものであり、その使用および複製はライセンス契約で定められた条件下でのみ許可されます。本資料で提供される情報は、情報供与のみを目的としたものであり、予告なく変更されることがあります。また、本資料で提供される情報は、インテルによる確約と解釈されるべきものではありません。インテルは本資料の内容およびこれに関連して提供されるソフトウェアにエラー、誤り、不正確な点が含まれていたとしても一切責任を負わないものとします。

ライセンス契約で許可されている場合を除き、インテルからの文書による承諾なく、本書のいかなる部分も複製したり、検索システムに保持したり、他の形式や媒体によって転送したりすることは禁じられています。

機能または命令の一覧で「留保」または「未定義」と記されているものがありますが、その「機能が存在しない」あるいは「性質が留保付である」という状態を開発の前提にしないでください。留保または未定義の機能を不適当な方法で使用すると、開発したソフトウェア・コードをインテル・プロセッサー上で実行する際に、予測不可能な動作や障害が発生するおそれがあります。これらの機能や命令は、インテルが将来のために留保しているものです。不正な使用により、衝突が生じたり互換性が失われたりしても、インテルは一切責任を負いません。

Intel、インテル、Intel ロゴ、Itanium、Pentium は、米国およびその他の国における Intel Corporation またはその子会社の商標または登録商標です。

* その他の社名、製品名などは、一般に各社の表示、商標または登録商標です。

© 2005-2006 Intel Corporation.