coder.LAPACKCallback クラス

パッケージ: coder

生成されたコードでの LAPACK 呼び出しの LAPACK ライブラリおよび LAPACKE ヘッダーファイルを指定するための抽象クラス

説明

coder.LAPACKCallback は LAPACK コールバッククラスを定義するための抽象クラスです。LAPACK コールバッククラスは、MATLAB^® コードから生成されたコードでの LAPACK 呼び出しに使用する LAPACK ライブラリと LAPACKE ヘッダーファイルを指定します。MATLAB Coder™ を使用してスタンドアロンコードを生成するか、MATLAB Function ブロックのコードを生成する場合、特定の線形代数関数の呼び出しでは、LAPACK 呼び出しを生成できます。LAPACK 呼び出しを生成するには、適切な構成パラメーターを LAPACK コールバッククラスの名前に設定します。

MATLAB Coder の codegen コマンドを使用したコード生成の場合、CustomLAPACKCallback を設定します。
MATLAB Coder アプリを使用したコード生成の場合、[カスタム LAPACK ライブラリのコールバック] を設定します。
Simulink^® Coder を使用した MATLAB Function ブロックのコード生成の場合、[カスタム LAPACK ライブラリのコールバック] を設定します。

useMyLAPACK という名前の LAPACK コールバッククラスを定義するには、次の行をクラス定義ファイルの最初の行にします。

classdef useMyLAPACK < coder.LAPACKCallback

メソッドにリストされているすべてのメソッドを定義しなければなりません。これらのメソッドは静的で、コンパイルされません。

メソッド

すべて展開する

パブリックメソッド

`coder.LAPACKCallback.getHeaderFilename`	LAPACKE ヘッダーファイルのファイル名を返す
`coder.LAPACKCallback.updateBuildInfo`	特定の LAPACK ライブラリにリンクするためのビルド情報の更新

例

すべて折りたたむ

LAPACK コールバッククラスを記述する

以下の例では、LAPACK コールバッククラスの記述方法を説明します。

この LAPACK コールバッククラスの例をテンプレートとして使用します。

classdef useMyLAPACK < coder.LAPACKCallback
    methods (Static)
        function hn = getHeaderFilename()
            hn = 'mylapacke_custom.h';
        end
        function updateBuildInfo(buildInfo, buildctx)
            buildInfo.addIncludePaths(fullfile(pwd,'include'));
            libName = 'mylapack';
            libPath = fullfile(pwd,'lib');
            [~,linkLibExt] = buildctx.getStdLibInfo();
            buildInfo.addLinkObjects([libName linkLibExt], libPath, ...
                '', true, true);
            buildInfo.addDefines('HAVE_LAPACK_CONFIG_H');
            buildInfo.addDefines('LAPACK_COMPLEX_STRUCTURE');
            buildInfo.addDefines('LAPACK_ILP64'); 
        end
    end
end

useMyLAPACK をコールバッククラスの名前に置き換えます。

getHeaderFilename メソッドは、LAPACK ライブラリへの LAPACKE C インターフェイスのヘッダーファイルの名前を返します。mylapacke_custom.h を LAPACKE ヘッダーファイルの名前で置き換えます。

updateBuildInfo メソッドはビルド情報をヘッダーファイルの場所と LAPACK ライブラリの名前と場所で更新します。mylapack を LAPACK ライブラリの名前で置き換えます。

コンパイラが構造体として表される複素数データ型のみをサポートしている場合は、updateBuildInfo メソッドに次の行を含めます。

buildInfo.addDefines('HAVE_LAPACK_CONFIG_H');
buildInfo.addDefines('LAPACK_COMPLEX_STRUCTURE');

LAPACK ライブラリで使用される整数型を指定しなければなりません。この整数型を指定しないと、結果として不正確な動作やクラッシュが生じる可能性があります。次のいずれかを行います。

updateBuildInfo メソッドに次の行を含めます。

buildInfo.addDefines('HAVE_LAPACK_CONFIG_H');
buildInfo.addDefines('LAPACK_ILP64');

あるいは、LAPACK ライブラリで使用される整数型を直接指定することもできます。たとえば、整数型が long long の場合、updateBuildInfo メソッドに次の行を含めます。
```
buildInfo.addDefines('lapack_int=long long');
```