Python용 MATLAB Engine API 설치하기
Python®용 MATLAB® Engine API를 사용하면 Python 환경 내에서 MATLAB 함수를 호출하고 MATLAB 명령을 실행할 수 있습니다. MATLAB 엔진을 사용하려면 지원되는 Python 버전이 컴퓨터에 설치되어 있어야 하며, Python용 MATLAB Engine API를 Python 패키지로 설치해야 합니다.
구성 확인 및 Python 설치하기
Python이 설치되어 있다면 MATLAB 엔진에서 지원하는 버전을 사용하고 있는지 확인하십시오. 운영 체제 프롬프트에 python -V를 입력하여 Windows® 시스템에 설치된 Python 버전을 확인할 수 있습니다. Linux® 또는 macOS 시스템에서는 대신 python3 -V를 사용합니다. 그런 다음, 릴리스별 MATLAB 제품과 호환되는 Python의 버전 페이지를 확인하여 Python 버전이 MATLAB 릴리스와 호환되는지 확인합니다.
또한 64비트 버전의 Python을 사용하고 있는지 확인합니다. MATLAB의 아키텍처와 호환되려면 64비트 버전의 Python이 필요합니다. 사용 중인 Python 버전이 32비트인지 64비트인지 테스트하려면 Python 프롬프트에 다음 코드를 입력하십시오. 다음 코드는 버전이 64비트이면 True, 32비트이면 False를 반환합니다.
import sys
print(sys.maxsize > 2**32)Python을 설치하지 않았거나 다른 버전이 필요한 경우 Python을 사용하도록 시스템 구성하기 항목을 참조하십시오.
Python용 MATLAB Engine API 설치하기
MATLAB에서는 다양한 방법으로 Python용 MATLAB Engine API를 설치할 수 있습니다. MATLAB에 포함된 Python용 MATLAB Engine 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 Engine 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 Engine 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 릴리스와 호환되는 버전을 확인하는 방법은 다음과 같습니다.
PyPI release history page for MATLAB Engine API for Python로 이동합니다.
각 MATLAB 엔진 릴리스 페이지를 열고 필수 MathWorks 제품 아래에 표시된 MATLAB 릴리스와 사용 중인 MATLAB 릴리스를 비교하여 일치하는 릴리스를 찾습니다.
그런 다음 일치하는 페이지에 표시된 MATLAB 엔진 버전으로
n.n.n
PyPI는 MATLAB 엔진 인스톨러를 호출하는 데 사용된 Python 인터프리터의 디폴트 패키지 폴더에 MATLAB 엔진을 설치합니다. 디폴트가 아닌 폴더에 엔진을 설치하려면 운영 체제 프롬프트에서 다음 명령을 실행하십시오. 여기서 installdir
python -m pip install --target installdir matlabengine
Python 패키지의 검색 경로에 installdirinstalldirPYTHONPATH 환경 변수에 추가하십시오.
Python용 MATLAB Engine API의 사전 설치된 버전 사용하기
R2026a 이후
Python용 MATLAB Engine API는 MATLAB에 사전 설치되어 있습니다. 이 사전 설치된 엔진 버전은 matlabroot/extern/engines/python/distmatlabrootmatlabroot를 실행할 때 표시되는 폴더입니다.
MATLAB 엔진의 사전 설치된 버전을 사용하려면 matlabroot/extern/engines/python/distPYTHONPATH 환경 변수에 추가하십시오. 또는 엔진을 가져오기 전에 Python의 sys.path에 삽입할 수도 있습니다.
가상 환경에 설치하기
가상 환경에 Python용 MATLAB Engine API를 설치할 수 있습니다. 가상 환경에 Python용 MATLAB Engine API를 설치하는 방법에 대한 자세한 지침은 MATLAB Answers™ 문서 Use the MATLAB Engine API for Python with a Virtual Environment를 참조하십시오. 가상 Python 환경에 대한 자세한 내용은 Python 튜토리얼 Virtual Environments and Packages를 참조하십시오. 설치 명령을 실행하기 전에 먼저 가상 환경을 활성화해야 합니다.
Python에서 MATLAB 엔진 시작하기
Python용 MATLAB Engine API 패키지를 가져오고 MATLAB 엔진을 시작하려면 Python 프롬프트에서 다음 명령을 실행하십시오.
import matlab.engine
eng = matlab.engine.start_matlab()
자세한 내용은 Python용 MATLAB 엔진 시작 및 중지하기 항목을 참조하십시오.
