Python을 사용하도록 시스템 구성하기

Python 지원

MATLAB^®에서 Python^® 모듈을 호출하려면 지원되는 버전의 참조 구현(CPython)이 시스템에 설치되어 있어야 합니다. https://www.python.org/downloads/에서 Python 배포판을 다운로드하여 설치합니다. MATLAB은 Microsoft^® 스토어에서 설치한 CPython 버전을 지원하지 않습니다. 지원되는 버전 정보에 대해서는 Versions of Python Compatible with MATLAB Products by Release를 참조하십시오.

Windows^®를 사용 중인 경우 Python을 아직 설치하지 않았다면 Python 배포판을 설치해야 합니다. 자세한 내용은 지원되는 Python 구현 설치하기 항목을 참조하십시오.
Linux^® 플랫폼을 사용 중인 경우 Python이 이미 설치되어 있을 수 있습니다. 지원되는 버전이 설치되어 있는지 확인하려면 pyenv를 호출하십시오. 다운로드 정보는 지원되는 Python 구현 설치하기 항목을 참조하십시오.
Mac 플랫폼을 사용 중인 경우 MATLAB 및 Python 빌드가 아키텍처(Apple Silicon 또는 Intel^® 프로세서)와 일치하는지 확인합니다. 자세한 내용은 How to use Python from MATLAB on Mac with Apple Silicon 항목을 참조하십시오.

py 네임스페이스(예: py.list)를 사용하여 MATLAB에서 Python 표현식을 입력하면 MATLAB이 Python 인터프리터를 선택하여 불러옵니다. 인터프리터를 변경하려면 다음을 수행하십시오.

Python을 InProcess ExecutionMode로 불러온 경우 MATLAB을 다시 시작하고 새로운 버전 정보로 pyenv를 실행합니다.
Python을 OutOfProcess 모드로 불러온 경우 terminate를 호출하고 새로운 버전 정보로 pyenv를 실행합니다.

MATLAB은 Python 인터프리터를 불러올 때 다음 설정에 액세스합니다.

pyenv 함수를 사용하여 구성한 Python 환경에 대한 사용자 설정. 지정한 버전이 PYTHONHOME에서 지정한 버전과 충돌하는 경우, pyenv를 호출하기 전에 환경 변수를 삭제하십시오. pyenv에 의해 설정된 값은 MATLAB 세션 간에 지속적으로 유지됩니다. 자세한 내용은 Windows 플랫폼에서 Python 버전 설정하기 또는 Mac과 Linux 플랫폼에서 Python 버전 설정하기 항목을 참조하십시오.
PYTHONHOME 환경 변수. 이 환경 변수는 pyenv.Status의 값이 NotLoaded인 경우 표준 Python 라이브러리를 찾을 수 있는 위치를 지정합니다. MATLAB에서 변수 값을 보려면, getenv("PYTHONHOME")을 입력하십시오. 자세한 내용은 PYTHONHOME 환경 변수 사용하기 항목을 참조하십시오.
시스템 PATH 환경 변수. MATLAB의 시스템 경로를 확인하려면 getenv("PATH")를 입력하십시오.
Windows 레지스트리

Python이 시스템에 설치되었는지 확인하려면 시스템 프롬프트에서 Python 인터프리터를 열고 Python 함수를 호출하십시오.

MATLAB이 사용 중인 버전을 확인하려면 pyenv를 호출하십시오. 예를 들어, Windows에서는 다음과 같습니다.

pe = pyenv

pe = 

  PythonEnvironment with properties:

          Version: "3.10"
       Executable: "C:\Users\username\AppData\Local\Programs\Python\Python310\pythonw.exe"
          Library: "C:\Users\username\AppData\Local\Programs\Python\Python310\python310.dll"
             Home: "C:\Users\username\AppData\Local\Programs\Python\Python310"
           Status: NotLoaded
    ExecutionMode: InProcess

Linux의 경우:

pe = pyenv

pe = 

  PythonEnvironment with properties:

          Version: "3.9"
       Executable: "/usr/bin/python3"
          Library: "libpython3.9.so.1.0"
             Home: "/usr"
           Status: NotLoaded
    ExecutionMode: InProcess

지원되는 Python 구현 설치하기

https://www.python.org/downloads/에 액세스한 후 스크롤하여 Looking for a specific release 섹션을 찾습니다.
원하는 버전을 찾아 Download를 클릭합니다. 지원되는 버전 정보에 대해서는 Versions of Python Compatible with MATLAB Products by Release를 참조하십시오.
64비트 버전의 원하는 형식을 클릭하고 온라인 지침에 따릅니다.

이름 py.myfunc를 확인할 수 없음 오류 메시지가 표시되는 경우 설치 문제 때문일 수 있습니다.

가상 환경에 Python 설치하기

Python venv 모듈을 사용하여 특정 버전의 Python을 위한 가상 환경을 만들 수 있습니다. 가상 환경에 Python용 MATLAB Engine API를 설치할 수도 있습니다. venv에 대한 자세한 지침은 MATLAB Answers™ 게시물 Python virtual environments with Python Interface를 참조하십시오. 가상 Python 환경에 대한 자세한 내용은 Python 튜토리얼 Virtual Environments and Packages를 참조하십시오.

Windows 플랫폼에서 Python 버전 설정하기

Windows 플랫폼에서 다음 명령 중 하나를 사용하십시오.

pyenv(Version="version")

또는

pyenv(Version="executable")

여기서 executable은 Python 실행 파일의 전체 경로입니다. 자세한 내용은 pyenv에 대한 Version 이름- 값 인수를 참조하십시오. 예를 들어, 다음을 입력합니다.

pyenv(Version="3.11");

참고

Python 인터프리터를 다운로드했지만 Windows 레지스트리에 등록하지 않은 경우에는 다음 명령을 사용하십시오.

pyenv(Version="executable")

예를 들어, 다음을 입력합니다.

pyenv(Version="C:\Users\username\AppData\Local\Programs\Python\Python311\python.exe");

Windows 플랫폼에서 64비트 버전의 Python 다운로드하기

Python의 아키텍처는 MATLAB의 아키텍처와 일치해야 합니다. 자세한 내용은 지원되는 Python 구현 설치하기 항목을 참조하십시오.

Mac과 Linux 플랫폼에서 Python 버전 설정하기

버전을 설정하려면 다음을 입력하십시오.

pyenv(Version="executable")

pyenv(Version="/usr/bin/python3.11")

Python 실행 파일 빌드를 위한 요구 사항

Linux와 Mac 시스템에서 Python 실행 파일을 빌드하는 경우에는 --enable-shared 옵션을 사용하여 빌드를 구성하십시오.

`PYTHONHOME` 환경 변수 사용하기

가능한 경우 pyenv를 사용하여 Python 인터프리터를 설정하십시오. 예를 들어 pyenv를 사용할 수 없는 경우 MATLAB 앱 실행 시 인터프리터를 설정하는 또 다른 방법은 PYTHONHOME 환경 변수를 사용하는 것입니다. pyenv와 PYTHONHOME으로 버전을 설정하는 경우 버전이 동일해야 합니다.

MATLAB에서 변수를 보려면 getenv("PYTHONHOME")을 입력하십시오. pyenv로 설정된 버전을 보려면 e = pyenv; e.Version을 입력하십시오.
PYTHONHOME을 설정하려면 https://docs.python.org/3/using/cmdline.html#envvar-PYTHONHOME 항목을 참조하십시오. 환경 변수 설정에 대한 자세한 내용은 운영 체제 문서를 참조하십시오. setenv를 사용하여 변수를 설정할 수도 있습니다. 그러나 이 설정은 현재 MATLAB 세션에만 적용됩니다.
현재 MATLAB 세션에 대해 PYTHONHOME을 삭제하려면 unsetenv("PYTHONHOME")을 입력하십시오.

이미 인터프리터를 불러온 경우 Python 버전을 변경할 수 없습니다. py 네임스페이스(예: py.sys.path)를 사용하여 MATLAB에서 Python 명령문을 입력하면 MATLAB이 Python 인터프리터를 불러옵니다. 인터프리터를 변경하려면 다음을 수행하십시오.

단일 MATLAB 세션에서 Python을 InProcess ExecutionMode로 불러온 경우 MATLAB을 다시 시작하고 새로운 버전 정보로 pyenv를 실행합니다.
Python을 OutOfProcess 모드로 불러온 경우 terminate를 호출하고 새로운 버전 정보로 pyenv를 실행합니다.