Main Content

PythonMATLAB Engine API 설치하기

Python® 세션 내에서 MATLAB® 엔진을 시작하려면 먼저 Engine API를 Python 패키지로 설치해야 합니다. 다른 요구 사항은 Python용 MATLAB Engine API에 대한 시스템 요구 사항 항목을 참조하십시오.

구성 확인하기

설치하기 전에 다음과 같은 Python 구성과 MATLAB 구성을 확인하십시오.

  • 시스템에 지원되는 버전의 Python과 MATLAB R2014b 이상이 설치되어 있는지 확인합니다. 자세한 내용은 Versions of Python Compatible with MATLAB Products by Release를 참조하십시오.

  • Python이 시스템에 설치되어 있는지 확인하려면 운영 체제 프롬프트에서 Python을 실행하십시오. Python 경로가 시스템 경로 환경 변수에 포함되어 있는지 확인하십시오.

  • Python 인터프리터가 포함된 폴더가 아직 경로에 없다면 해당 폴더를 추가하십시오.

Engine API 설치하기

pip 명령 또는 Python 설정 스크립트 setup.py를 사용하여 Python용 MATLAB Engine API를 설치할 수 있습니다.

pip를 사용하여 설치하기

MATLAB R2022b부터 pip 명령을 사용하여 API를 설치할 수 있습니다. 다음 절차 중 하나를 선택하고 시스템 프롬프트에서 실행하십시오.

  • Windows®에 있는 MATLAB 폴더에서 설치하려면 다음을 입력합니다.

    cd "matlabroot\extern\engines\python"
    python -m pip install .
  • https://pypi.org/project/matlabengine에서 Engine API 설치하려면 다음 명령을 입력합니다.

    python -m pip install matlabengine

setup.py를 사용하여 설치하기

MATLAB은 Python setuptools를 사용하여 엔진을 빌드하고 설치하기 위한 표준 Python setup.py 파일을 제공합니다. 플랫폼별 명령은 MATLAB Engine API 설치를 위한 Python 설정 스크립트 항목을 참조하십시오.

MATLAB Engine 시작하기

Python을 시작합니다. Python 프롬프트에서 다음 명령을 입력하여 MATLAB 모듈을 가져오고 엔진을 시작합니다.

import matlab.engine
eng = matlab.engine.start_matlab()

자세한 내용은 Python용 MATLAB 엔진 시작 및 중지하기 항목을 참조하십시오.

PythonMATLAB Engine API 설치 관련 문제 해결하기

  • MATLAB 릴리스가 Python 버전을 지원하는지 확인하십시오. Versions of Python Compatible with MATLAB Products by Release를 참조하십시오.

  • 운영 체제 프롬프트에서 설치 명령을 실행할 충분한 권한이 있는지 확인하십시오. 필요하면 Windows에서 관리자 권한으로 실행 옵션을 사용하여 명령 프롬프트를 여십시오.

  • 지정된 MATLAB 폴더에서 Python 설치 명령을 실행해야 합니다. 자세한 지침은 Engine API 설치하기에 나와 있는 플랫폼 링크 중 하나를 선택하십시오.

    python setup.py install
    
  • 인스톨러는 디폴트 Python 폴더에 엔진을 설치합니다. 디폴트가 아닌 위치를 사용하려면 디폴트가 아닌 위치에 Python용 MATLAB Engine API 설치하기 항목을 참조하십시오.

  • --prefix를 사용하여 디폴트가 아닌 폴더에 패키지를 설치한 경우 PYTHONPATH 환경 변수를 설정해야 합니다. 예를 들어 다음 설치 명령을 사용한다고 가정해 보겠습니다.

    python setup.py install --prefix="matlab22aPy39"
    

    Python에서 다음 명령을 사용하여 PYTHONPATH를 업데이트합니다.

    sys.path.append("matlab22aPy39\Lib\site-packages")
  • 자세한 문제 해결 정보는 Python에서 MATLAB 오류 해결하기 항목을 참조하십시오.

관련 항목