Python용 MATLAB Engine API 설치하기

Python®용 MATLAB® Engine API를 사용하면 Python 환경 내에서 MATLAB 함수를 호출하고 MATLAB 명령을 실행할 수 있습니다. MATLAB 엔진을 사용하려면 지원되는 Python 버전이 컴퓨터에 설치되어 있어야 하며, Python용 MATLAB Engine API를 Python 패키지로 설치해야 합니다.

구성 확인하기

Python이 이미 설치되어 있는 경우 MATLAB 엔진에서 지원하는 버전을 사용하고 있는지 확인하십시오. 운영 체제 프롬프트에 python -V를 입력하여 어떤 Python 버전을 설치했는지 확인할 수 있습니다. 그런 다음, 릴리스별 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에서 설치하기

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에서 설치하려면 운영 체제 프롬프트에서 이 명령을 실행하십시오. 

python -m pip install matlabengine
이 명령은 Python Package Index에서 제공되는 Python용 MATLAB Engine API의 최신 버전을 설치합니다. MATLAB의 최신 릴리스를 사용하지 않는 경우, 사용 중인 릴리스와 호환되는 MATLAB 엔진의 버전을 지정해야 합니다. PyPI 페이지 MATLAB Engine API for Python를 참조하여 호환되는 MATLAB 엔진의 버전을 확인할 수 있습니다. 릴리즈 이력(Release history) 탭에서 각 MATLAB 엔진 릴리스에 대한 Required MathWorks Products 섹션을 검토하십시오.

Python용 MATLAB Engine API 설치 위치

MATLAB, 운영 체제, 또는 Python Package Index에서 설치할 수 있으며, Python 인터프리터 아래의 디폴트 위치, 디폴트가 아닌 다른 위치 또는 가상 환경에 설치할 수 있습니다. 기본적으로, 인스톨러는 matlabroot/extern/engines/python 폴더에 Python용 MATLAB Engine API를 빌드합니다. 그런 다음, 인스톨러는 디폴트 Python 폴더에 MATLAB 엔진을 설치합니다. MATLAB에서 설치하기, 운영 체제에서 설치하기 또는 Python Package Index에서 설치하기 섹션의 설치 방법을 사용하면 MATLAB 엔진이 디폴트 위치에 빌드하고 설치합니다.

setup.py를 사용하여 디폴트가 아닌 폴더에 설치하기

디폴트 설치 폴더에 대한 쓰기 권한이 없거나 다른 폴더에 MATLAB 엔진을 설치하려는 경우 다른 위치를 지정할 수 있습니다.

디폴트가 아닌 폴더 builddir에 엔진을 빌드하고 설치하려면 운영 체제 프롬프트에서 다음 명령을 실행하십시오. 

cd "matlabroot/extern/engines/python"
python setup.py build --build-base="builddir"
Python 패키지의 검색 경로에 builddir을 포함시키려면 builddir을 PYTHONPATH 환경 변수에 추가하십시오.

Python Package Index를 사용하여 디폴트가 아닌 폴더에 설치하기

디폴트가 아닌 폴더 installdir에 엔진을 설치하려면 운영 체제 프롬프트에서 다음 명령을 실행하십시오. 이 설치 방법에서는 Python Package Index를 사용합니다. 

python -m pip install --target installdir matlabengine

Python 패키지의 검색 경로에 installdir을 포함시키려면 installdir을 PYTHONPATH 환경 변수에 추가하십시오.

가상 환경에 설치하기

가상 환경에 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 엔진 시작 및 중지하기 항목을 참조하십시오.

참고 항목

도움말 항목

외부 웹사이트