Main Content

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 は個別にインストールする必要があります。

生成されたインストーラーの使用

  1. インストーラーを目的の場所に配布します。

  2. インストーラーを実行します。

  3. インストーラーが Python パッケージ ファイルを書き込む場所をメモします。

  4. インストーラーが終了したら、システム コマンド プロンプト ウィンドウを開き、Python パッケージ ファイルが含まれているフォルダーに移動します。

  5. Python セットアップ スクリプトを実行します。既定以外の場所にインストールするには、公式 Python ドキュメンテーションの「Python モジュールのインストール」を参照してください。

    python setup.py install
  6. MATLAB Runtime フォルダーをライブラリ パス環境変数に追加します。詳細については、デプロイ用の MATLAB Runtime パスの設定を参照してください。

パッケージ ファイルの使用

  1. 次のファイルを配布して Python パッケージをアプリケーションに統合します。

    • デプロイされた MATLAB 関数の関数シグネチャ

    • _init_.py — Python パッケージの初期化スクリプト

    • setup.py — 生成された Python インストーラー

  2. システム コマンド プロンプト ウィンドウを開き、Python パッケージ ファイルが含まれているフォルダーに移動します。

  3. Python セットアップ スクリプトを実行します。既定以外の場所にインストールするには、公式 Python ドキュメンテーションの「Python モジュールのインストール」を参照してください。

    python setup.py install
  4. Python パッケージのコンパイルに使用された MATLAB のバージョンと一致する MATLAB Runtime をインストールします。詳細については、MATLAB Runtime のインストールと構成を参照してください。

  5. 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

参考

|

関連するトピック

外部の Web サイト