Python 用の MATLAB エンジン API のインストール
Python® 用の MATLAB® エンジン API を使用することで、Python 環境内から MATLAB 関数を呼び出し、MATLAB コマンドを実行できます。MATLAB エンジンを使用するには、サポートされているバージョンの Python がマシンにインストールされている必要があり、Python 用の MATLAB エンジン API を Python パッケージとしてインストールする必要があります。
構成の確認および Python のインストール
Python がインストールされている場合は、MATLAB エンジンでサポートされているバージョンを使用していることを確認してください。Windows® システムでは、オペレーティング システムのプロンプトで「python -V」と入力することで、インストールされている Python のバージョンを確認できます。Linux® または macOS システムでは、代わりに python3 -V を使用します。次に、Versions of Python Compatible with MATLAB Products by Release ページを確認して、Python バージョンがご使用の MATLAB リリースと互換性があるかどうかを判別します。
さらに、Python の 64 ビット バージョンを使用していることを確認してください。MATLAB のアーキテクチャと一致させるために、Python の 64 ビット バージョンが必要です。使用している Python のバージョンが 32 ビットなのか 64 ビットなのかをテストするには、次のコードを Python プロンプトで入力します。このコードは、バージョンが 64 ビットの場合は True を返し、バージョンが 32 ビットの場合は False を返します。
import sys
print(sys.maxsize > 2**32)Python がインストールされていない場合、または別のバージョンが必要な場合は、Python を使用するためのシステムの構成を参照してください。
Python 用の MATLAB エンジン API のインストール
MATLAB では、Python 用の MATLAB エンジン API をインストールするためのさまざまな方法が用意されています。また、MATLAB に付属している、Python 用の MATLAB エンジン API のプレインストール済みバージョンを使用することもできます。 (R2026a 以降)
MATLAB からのインストール
MATLAB エンジンは MATLAB から直接インストールできます。MATLAB を起動し、次のコマンドを実行します。
| システム | MATLAB コマンド |
|---|---|
Windows |
cd (fullfile(matlabroot,"extern","engines","python")) system("python -m pip install .") |
Linux および macOS |
cd (fullfile(matlabroot,"extern","engines","python")) system("python3 -m pip install .") |
オペレーティング システムからのインストール
あるいは、オペレーティング システムのプロンプトから MATLAB エンジンをインストールすることもできます。まず、Python 用の MATLAB エンジン API のフォルダーのパスが必要です。このフォルダーを見つけるには、MATLAB を起動し、コマンド ウィンドウに「matlabroot」と入力します。次に、次のコマンドの matlabroot を、MATLAB から返されたパス値に置き換えます。
オペレーティング システムのプロンプトから install コマンドを実行するための十分な権限があることを確認します。Windows では、必要に応じて、[管理者として実行] オプションを指定してコマンド プロンプトを開きます。
| システム | システム コマンド |
|---|---|
Windows |
cd "matlabroot\extern\engines\python"
python -m pip install .
|
Linux および macOS |
cd "matlabroot/extern/engines/python"
python3 -m pip install .
|
Python Package Index からのインストール
あるいは、Python Package Index (PyPI) から MATLAB エンジンをインストールすることもできます。他のインストール オプションとは異なり、先に Python 用の MATLAB エンジン API のフォルダーに移動する必要はありません。
PyPI から入手可能な最新バージョンの MATLAB エンジンをインストールするには、オペレーティング システムのプロンプトから次のコマンドを実行します。
python -m pip install matlabengine
最新の MATLAB エンジン バージョンは、最新の MATLAB リリース (現在は R2026a) とのみ互換性があります。MATLAB のプレリリース バージョンとの互換性はありません。
MATLAB の最新リリースを使用していない場合は、ご使用のリリースと互換性のある MATLAB エンジンのバージョンを指定します。オペレーティング システムのプロンプトから次のコマンドを実行します。ここで、n.n.n
python -m pip install matlabengine==n.n.n
ご使用の MATLAB リリースと互換性のあるバージョンを確認するには、次のようにします。
各 MATLAB エンジン リリースのページを開き、[Required MathWorks Products] の下に示されている MATLAB リリースを、ご使用の MATLAB リリースと一致するものが見つかるまで比較します。
その後、
n.n.n
PyPI は、MATLAB エンジン インストーラーを呼び出すために使用された Python インタープリターの既定のパッケージ フォルダーに MATLAB エンジンをインストールします。エンジンを既定以外のフォルダーにインストールするには、オペレーティング システムのプロンプトから次のコマンドを実行します。ここで、installdir
python -m pip install --target installdir matlabengine
Python パッケージの検索パスに installdirinstalldirPYTHONPATH 環境変数に追加します。
Python 用の MATLAB エンジン API のプレインストール済みバージョンの使用
R2026a 以降
MATLAB には、Python 用の MATLAB エンジン API のプレインストール済みバージョンが含まれています。このプレインストール済みバージョンのエンジンは、matlabroot/extern/engines/python/distmatlabrootmatlabroot を実行したときに表示されるフォルダーです。
プレインストール済みバージョンの MATLAB エンジンを使用するには、matlabroot/extern/engines/python/distPYTHONPATH 環境変数に追加します。あるいは、エンジンをインポートする前に、Python の sys.path に挿入することもできます。
バーチャル環境へのインストール
バーチャル環境に Python 用の MATLAB エンジン API をインストールできます。バーチャル環境で Python 用の MATLAB エンジン API をインストールする詳細な手順については、MATLAB Answers™ の記事 Use the MATLAB Engine API for Python with a Virtual Environment を参照してください。Python バーチャル環境の詳細については、Python チュートリアルの Virtual Environments and Packages を参照してください。インストール コマンドを実行する前に、バーチャル環境をアクティブにする必要があります。
Python での MATLAB エンジンの起動
Python 用の MATLAB エンジン API のパッケージをインポートし、MATLAB エンジンを起動するには、Python プロンプトから次のコマンドを実行します。
import matlab.engine
eng = matlab.engine.start_matlab()
詳細については、Python 用 MATLAB エンジンの起動と停止を参照してください。
