Python 用の MATLAB エンジン API のインストール

Python^® セッション内で MATLAB^® エンジンを開始するには、まず Python パッケージとしてエンジン API をインストールする必要があります。

構成の確認

インストールする前に、Python の構成と MATLAB の構成を確認してください。

使用しているシステムに Python のサポートされているバージョンと MATLAB R2014b 以降がインストールされていることを確認します。詳細については、Versions of Python Supported by MATLAB Products by Release を参照してください。
システムに Python がインストールされていることを確認するには、オペレーティングシステムのプロンプトで Python を実行します。
Python インタープリターがパス上にない場合は、それを含むフォルダーをパスに追加します。

エンジン API のインストール

pip コマンドまたは Python セットアップスクリプト setup.py を使用して、Python 用の MATLAB エンジン API をインストールできます。

`pip` を使用したインストール

MATLAB R2022b 以降、pip コマンドを使用して API をインストールできます。次のいずれかの手順を選択して、システムプロンプトから実行します。

MATLAB フォルダーからインストールするには、Windows^® で以下を入力します。
```
cd "matlabroot\extern\engines\python"
python -m pip install .
```
次のコマンドを使用して、https://pypi.org/project/matlabengineからエンジン API をインストールします。
```
python -m pip install matlabengine
```

`setup.py` を使用したインストール

MATLAB では、Python setuptools を使用してエンジンをビルドおよびインストールするための、標準の Python setup.py ファイルを提供しています。プラットフォーム固有のコマンドについては、MATLAB エンジン API をインストールするための Python セットアップスクリプトを参照してください。

MATLAB エンジンの起動

Python を起動します。以下のコマンドを Python プロンプトから入力すると、MATLAB モジュールがインポートされ、エンジンが起動します。

import matlab.engine
eng = matlab.engine.start_matlab()

詳細については、Python 用 MATLAB エンジンの起動と停止を参照してください。

Python インストール用の MATLAB エンジン API のトラブルシューティング

使用している MATLAB リリースが Python のバージョンをサポートしていることを確認します。Versions of Python Supported by MATLAB Products by Release を参照してください。
オペレーティングシステムのプロンプトからインストールコマンドを実行するための管理者権限があることを確認します。Windows の場合は、[管理者として実行] オプションを指定してコマンドプロンプトを開きます。
Python インストールコマンドは、指定された MATLAB フォルダーから実行しなければなりません。詳細な手順については、エンジン API のインストールのプラットフォームリンクのいずれかを選択してください。
```
python setup.py install
```
インストーラーは既定の Python フォルダー内にエンジンをインストールします。既定以外の場所を使用する場合については、既定以外の場所への Python 用の MATLAB エンジン API のインストールを参照してください。
--prefix を使用してパッケージを既定以外のフォルダーにインストールした場合は、必ず環境変数 PYTHONPATH を設定します。たとえば、次のインストールコマンドを使用したとします。
```
python setup.py install --prefix="matlab19bPy36"
```
Python で、次のコマンドを使って PYTHONPATH を更新します。
```
sys.path.append("matlab19bPy36")
```
トラブルシューティングの詳細については、Python での MATLAB エラーのトラブルシューティングを参照してください。

外部の Web サイト

Python 2.7 ドキュメンテーション — Installing Python Modules