Main Content

이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

PythonMATLAB Engine API 설치하기

Python® 세션 내에서 MATLAB® 엔진을 시작하려면 먼저 Engine API를 Python 패키지로 설치해야 합니다. MATLAB은 distutils 모듈을 사용하여 엔진을 빌드하고 설치하기 위한 표준 Python setup.py 파일을 제공합니다. Windows®, Mac 또는 Linux® 시스템에서 동일한 setup.py 명령을 사용하여 엔진을 빌드하고 설치할 수 있습니다.

각 MATLAB 릴리스에는 Python setup.py 패키지가 있습니다. 패키지를 사용하면 지정된 MATLAB 버전이 실행됩니다. MATLAB 버전 간에 전환하려면 Python 패키지 간의 전환이 필요합니다. 자세한 내용은 지원되는 Python 구현 설치하기 항목을 참조하십시오.

구성 확인하기

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

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

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

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

  • MATLAB 폴더의 경로를 찾습니다. MATLAB을 시작하고 명령 창에 matlabroot를 입력합니다. matlabroot에서 반환되는 경로를 복사합니다.

Engine API 설치하기

Engine API를 설치하려면 다음 방법 중 하나를 선택하십시오. 지정된 폴더에서 다음 python 설치 명령을 호출해야 합니다.

  • Windows 운영 체제 프롬프트에서(이런 명령을 실행할 때 관리자 권한이 필요할 수 있음) —

    cd "matlabroot\extern\engines\python"
    python setup.py install
    
  • macOS 또는 Linux 운영 체제 프롬프트에서(이런 명령을 실행할 때 관리자 권한이 필요할 수 있음) —

    cd "matlabroot/extern/engines/python"
    python setup.py install
    
  • MATLAB 명령 프롬프트에서 —

    cd (fullfile(matlabroot,'extern','engines','python'))
    system('python setup.py install')
  • 디폴트가 아닌 위치에 Python용 MATLAB Engine API 설치하기에 설명되어 있는 디폴트가 아닌 옵션 중 하나를 사용합니다.

MATLAB Engine 시작하기

Python을 시작하고 모듈을 가져온 후 MATLAB 엔진을 시작하십시오.

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

여러 MATLAB 버전용 Python Engine 설치하기

MATLAB Python 패키지를 버전별 위치에 설치하여 Python 스크립트에서 실행할 MATLAB 버전을 지정할 수 있습니다. 예를 들어 Python 버전 3.6 스크립트에서 MATLAB R2019a 또는 R2019b를 호출한다고 가정하겠습니다.

Windows 시스템 프롬프트에서 matlab19aPy36이라는 하위 폴더에 R2019a 패키지를 설치합니다.

cd "c:\Program Files\MATLAB\R2019a\extern\engines\python" 
python setup.py install --prefix="c:\work\matlab19aPy36"

matlab19bPy36 하위 폴더에 R2019b 패키지를 설치합니다.

cd "c:\Program Files\MATLAB\R2019b\extern\engines\python" 
python setup.py install --prefix="c:\work\matlab19bPy36"

Linux 시스템 프롬프트에서:

cd "/usr/local/MATLAB/R2019a/bin/matlab/extern/engines/python"
python setup.py install --prefix="/local/work/matlab19aPy36"
cd "/usr/local/MATLAB/R2019b/bin/matlab/extern/engines/python"
python setup.py install --prefix="/local/work/matlab19bPy36"

Mac 터미널에서:

cd "/Applications/MATLAB_R2019a.app/extern/engines/python"
python setup.py install --prefix="/local/work/matlab19aPy36"
cd "/Applications/MATLAB_R2019b.app/extern/engines/python"
python setup.py install --prefix="/local/work/matlab19bPy36"

특정 MATLAB Engine 버전 시작하기

MATLAB Engine의 특정 버전을 시작하려면 PYTHONPATH 환경 변수를 패키지의 위치로 설정하십시오. 다음 코드는 사용자가 이전 섹션에 나온 설정을 사용한다고 가정합니다. Windows에서 MATLAB R2019b를 호출하도록 PYTHONPATH를 설정하려면 다음을 입력하십시오.

sys.path.append("c:\work\matlab19bPy36")

Linux 또는 Mac의 경우에는 다음을 입력하십시오.

sys.path.append("/local/work/matlab19bPy36")

가져오는 MATLAB 버전을 확인하려면 Python에서 다음을 입력하십시오.

import matlab
print(matlab.__file__)

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

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

  • 지정된 MATLAB 폴더에서 Python 설치 명령을 실행해야 합니다. Engine API 설치하기를 참조하십시오.

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

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

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

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

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

    sys.path.append("matlab19bPy36")

관련 항목

외부 웹 사이트