MATLAB Compiler SDK Python パッケージのインストールとインポート
MATLAB® Compiler SDK™ を使用して Python® パッケージを生成した後、ターゲット マシンに MATLAB Runtime とパッケージをインストールする必要があります。Python アプリケーションにパッケージをインポートし、コンパイルされた MATLAB 関数を呼び出します。
Python パッケージのインストール
ライブラリ コンパイラを使用してパッケージを作成する場合、アプリは for_redistribution
フォルダーにインストーラーを生成します。このインストーラーは、MATLAB Runtime と、生成された Python パッケージのインストールに必要なファイルをインストールします。compiler.build.pythonPackage
または mcc
を使用してパッケージを作成する場合、関数 compiler.package.installer
を使用してインストーラーを生成できます。
Python パッケージ ファイルの手動配布もできます。MATLAB Runtime は個別にインストールする必要があります。
生成されたインストーラーの使用
インストーラーを目的の場所に配布します。
インストーラーを実行します。
インストーラーが Python パッケージ ファイルを書き込む場所をメモします。
インストーラーが終了したら、システム コマンド プロンプト ウィンドウを開き、Python パッケージ ファイルが含まれているフォルダーに移動します。
Python セットアップ スクリプトを実行します。既定以外の場所にインストールするには、公式 Python ドキュメンテーションの「Python モジュールのインストール」を参照してください。
python setup.py install
MATLAB Runtime フォルダーをライブラリ パス環境変数に追加します。詳細については、デプロイ用の MATLAB Runtime パスの設定を参照してください。
パッケージ ファイルの使用
次のファイルを配布して Python パッケージをアプリケーションに統合します。
デプロイされた MATLAB 関数の関数シグネチャ
_init_.py
— Python パッケージの初期化スクリプトsetup.py
— 生成された Python インストーラー
システム コマンド プロンプト ウィンドウを開き、Python パッケージ ファイルが含まれているフォルダーに移動します。
Python セットアップ スクリプトを実行します。既定以外の場所にインストールするには、公式 Python ドキュメンテーションの「Python モジュールのインストール」を参照してください。
python setup.py install
Python パッケージのコンパイルに使用された MATLAB のバージョンと一致する MATLAB Runtime をインストールします。詳細については、MATLAB Runtime のインストールと構成を参照してください。
MATLAB Runtime フォルダーをライブラリ パス環境変数に追加します。詳細については、デプロイ用の MATLAB Runtime パスの設定を参照してください。
Python パッケージのインポート
コンパイル時に、パッケージの名前空間を指定します。これは、companyname.groupname.packageName
のようにピリオドで区切られたリストです。
関数
compiler.build.pythonPackage
を使用する場合は、PackageName
オプションを使用して名前空間を指定します。生成されたパッケージの名前は、ピリオドで区切られたリストの最後のエントリに設定されます。指定しない場合、
PackageName
の既定値は、FunctionFiles
引数内にリストされている最初の MATLAB ファイルの名前です。ライブラリ コンパイラ アプリを使用する場合は、[ライブラリ名] フィールドにパッケージ名、[名前空間] フィールドに名前空間を指定します。
[ライブラリ名] フィールドの既定値は、アプリ内にリストされている最初の MATLAB ファイルの名前です。[名前空間] フィールドは空のままにすることができます。
関数
mcc
を使用する場合は、-W python:
フラグの一部としてパッケージ名と名前空間を指定します。namespace
.packageName
指定しない場合、名前空間の既定値は、コマンドにリストされている最初の MATLAB ファイルの名前です。
import
ステートメントの後に完全な名前空間を使用し、Python アプリケーションにパッケージをインポートします。
たとえば、MATLAB 関数をコンパイルして、パッケージ名を addmatrix
として指定し、名前空間を指定しない場合は、次のようにインポートします。
import addmatrix
名前空間 com.mathworks.addmatrix
を使用して MATLAB 関数をコンパイルする場合は、次のようにインポートします。
import com.mathworks.addmatrix
参考
compiler.build.pythonPackage
| mcc
関連するトピック
- MATLAB 関数のパッケージ化と Python アプリケーションへのデプロイ
- パッケージ化された MATLAB 関数の呼び出し
- MATLAB Runtime のインストールと構成
- MATLAB Runtime の初期化