Main Content

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

Python® セッション内で MATLAB® エンジンを開始するには、まず Python パッケージとしてエンジン API をインストールする必要があります。その他の要件については、Python 用 MATLAB エンジン API のシステム要件を参照してください。

構成の確認

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

  • 使用しているシステムに Python のサポートされているバージョンと MATLAB R2014b 以降がインストールされていることを確認します。詳細については、Versions of Python Supported by MATLAB Products by Release を参照してください。

  • システムに Python がインストールされていることを確認するには、オペレーティング システムのプロンプトで 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="matlab22aPy39"
    

    Python で、次のコマンドを使って PYTHONPATH を更新します。

    sys.path.append("matlab22aPy39")
  • トラブルシューティングの詳細については、Python での MATLAB エラーのトラブルシューティングを参照してください。

関連するトピック