MATLAB エンジン API をインストールするための Python セットアップスクリプト

MATLAB^® では、Python^® setuptools を使用してエンジンをビルドおよびインストールするための、標準の Python setup.py ファイルを提供しています。MATLAB setup.py スクリプトは、MATLAB コマンドプロンプトまたはオペレーティングシステムのプロンプトから、Windows^®、macOS、または Linux^® プラットフォームで使用できます。

setup.py を使用して API をインストールするには、以下のコマンドに示すとおり、スクリプトを特定のフォルダーで呼び出す必要があります。システムプロンプトからスクリプトを呼び出すには、MATLAB フォルダーへのパスが必要です。MATLAB を起動し、コマンドウィンドウで matlabroot と入力します。次に、matlabroot をコマンドで返されたパス値に置き換えます。

Windows へのインストール

以下のいずれかのコマンドを選択します。

Windows オペレーティングシステムのプロンプト (これらのコマンドの実行には、管理者権限が必要な場合があります) で、以下のように入力します。
```
cd "matlabroot\extern\engines\python"
python setup.py install
```

MATLAB コマンドプロンプトで、以下のように入力します。

cd (fullfile(matlabroot,'extern','engines','python'))
system('python setup.py install')

既定以外のフォルダーを使用するには、既定以外の場所への Python 用の MATLAB エンジン API のインストールを参照してください。

Linux へのインストール

以下のいずれかのコマンドを選択します。

Linux システムのプロンプト (これらのコマンドの実行には、管理者権限が必要な場合があります) で、以下のように入力します。
```
cd "matlabroot/extern/engines/python"
python setup.py install
```

MATLAB コマンドプロンプトで、以下のように入力します。

cd (fullfile(matlabroot,'extern','engines','python'))
system('python setup.py install')

既定以外のフォルダーを使用するには、既定以外の場所への Python 用の MATLAB エンジン API のインストールを参照してください。

macOS へのインストール

以下のいずれかのコマンドを選択します。

macOS 端末のプロンプト (これらのコマンドの実行には、管理者権限が必要な場合があります) で、以下のように入力します。
```
cd "matlabroot/extern/engines/python"
python setup.py install
```

MATLAB コマンドプロンプトで、以下のように入力します。

cd (fullfile(matlabroot,'extern','engines','python'))
system('python setup.py install')

既定以外のフォルダーを使用するには、既定以外の場所への Python 用の MATLAB エンジン API のインストールを参照してください。

複数の MATLAB バージョンに対応したインストール

MATLAB の各リリースには Python setup.py パッケージが備わっています。このパッケージを使用すると、指定された MATLAB のバージョンが実行されます。MATLAB のバージョンを切り替えるには、Python パッケージを切り替える必要があります。

MATLAB Python パッケージをバージョン専用の場所にインストールすることにより、Python スクリプトから実行する MATLAB のバージョンを指定できます。たとえば、MATLAB R2021b または R2022a を Python version 3.9 のスクリプトから呼び出すとします。エンジン API は、matlab21bPy39 および matlab22aPy39 という名前のローカルフォルダーにインストールできます。手順は次のとおりです。

MATLAB R2021b Python エンジンフォルダーに移動します。
setup.py を呼び出して matlab21bPy39 という名前のローカルフォルダーにインストールします。
MATLAB R2022a フォルダーに移動します。
setup.py を呼び出して matlab22aPy39 という名前のローカルフォルダーにインストールします。

Windows システムプロンプトから、次のように入力します。

cd "c:\Program Files\MATLAB\R2021b\extern\engines\python" 
python setup.py install --prefix="c:\work\matlab21bPy39"
cd "c:\Program Files\MATLAB\R2022a\extern\engines\python" 
python setup.py install --prefix="c:\work\matlab22aPy39"

Linux システムプロンプトから、次のように入力します。

cd "/usr/local/MATLAB/R2021b/bin/matlab/extern/engines/python"
python setup.py install --prefix="/local/work/matlab21bPy39"
cd "/usr/local/MATLAB/R2022a/bin/matlab/extern/engines/python"
python setup.py install --prefix="/local/work/matlab22aPy39"

macOS 端末から、次のように入力します。

cd "/Applications/MATLAB_R2021b.app/extern/engines/python"
python setup.py install --prefix="/local/work/matlab21bPy39"
cd "/Applications/MATLAB_R2022a.app/extern/engines/python"
python setup.py install --prefix="/local/work/matlab22aPy39"