MATLAB에서 사용하기 위해 Python 설치 및 구성하기

R2026b

MATLAB^®에서 Python^®을 호출하려면 지원되는 버전의 참조 구현(CPython)이 시스템에 설치되어 있어야 합니다. 또한 MATLAB에서 사용할 수 있도록 Python 환경을 구성해야 합니다.

기존에 설치된 Python 확인하기

Python이 이미 설치되어 있는 경우, 릴리스별 MATLAB 제품과 호환되는 Python의 버전에서 MATLAB이 해당 Python 버전을 지원하는지 확인하십시오.

기존에 설치된 Python은 다음과 같은 플랫폼별 요구 사항도 충족해야 합니다.

Windows^® — 64비트 버전의 Python이 설치되어 있어야 합니다. 32비트 버전은 지원되지 않습니다.
Windows — Python을 Microsoft^® Store에서 설치한 것이 아니어야 합니다.
Linux^® 및 Mac — Python을 소스에서 빌드한 경우 --enable-shared 옵션을 사용하여 구성된 빌드여야 합니다. 자세한 내용은 Python 문서의 Configure Python을 참조하십시오.
Mac — MATLAB과 Python 설치가 동일한 아키텍처(Apple silicon 또는 Intel^® 프로세서)를 사용해야 합니다. 자세한 내용은 How to use Python from MATLAB on Mac with Apple Silicon 항목을 참조하십시오.

Python 설치하기

지원되는 버전의 Python이 시스템에 설치되어 있지 않은 경우, MATLAB의 애드온 패널 또는 python.org에서 설치할 수 있습니다.

MATLAB 애드온 패널에서 Python 설치하기

R2026b 이후

MATLAB의 애드온 패널에서 Python을 설치하려면 다음 단계를 따르십시오.

데스크탑의 왼쪽 사이드바에 있는 애드온 아이콘 을 클릭하여 애드온 패널을 엽니다. 애드온 아이콘이 없으면 패널 더 열기 버튼 을 클릭하고 애드온 패널을 선택합니다.
텍스트 MATLAB Support for Python을 검색합니다.
설치하려는 Python 버전에 해당하는 애드온을 선택합니다.
설치 버튼을 클릭합니다.

이제 pyenv 또는 외부 언어 패널을 사용하여 이 Python 버전을 Python 환경으로 선택할 수 있습니다. 자세한 내용은 Manage Python Environments Using External Languages Panel 항목을 참조하십시오.

`python.org`에서 Python 설치하기

python.org에서 Python을 설치하려면 다음 단계를 따르십시오.

https://www.python.org/downloads/로 이동한 후 스크롤하여 Looking for a specific release 섹션을 찾습니다.
원하는 버전을 찾아 Download를 클릭합니다. 지원되는 버전 정보에 대해서는 릴리스별 MATLAB 제품과 호환되는 Python의 버전 항목을 참조하십시오.
설치할 형식을 클릭하고 온라인 지침에 따릅니다.
- Windows에서는 64비트 형식을 선택합니다.
- Linux와 Mac에서, Python 실행 파일을 소스에서 빌드하는 경우에는 --enable-shared 옵션을 사용하여 빌드를 구성합니다. 자세한 내용은 Python 문서의 Configure Python을 참조하십시오.

MATLAB에서 사용할 Python 환경 구성하기

MATLAB은 기본 환경(시스템 전체에 설치된 Python) 또는 가상 환경(특정 프로젝트용으로 격리된 Python 패키지 폴더)을 사용하도록 구성할 수 있습니다. 아직 가상 환경이 없는 경우, 외부 언어 패널을 사용하여 기본 환경으로부터 가상 환경을 만들 수 있습니다(Manage Python Environments Using External Languages Panel 참조). 또는, 프로그래밍 방식으로 가상 환경을 만들려면 MATLAB 게시물 Python virtual environments with MATLAB 및 Python 튜토리얼 Virtual Environments and Packages를 참조하십시오.

Python 환경을 설정하려면 외부 언어 패널, pyenv 함수 또는 PYTHONHOME 환경 변수를 사용하십시오.

외부 언어 패널을 사용하여 Python 환경 선택하기

R2026a 이후

MATLAB에서 Python을 사용하도록 구성하는 가장 간단한 방법은 외부 언어 패널을 사용하여 기본 환경 또는 가상 환경을 선택하는 것입니다.

외부 언어 패널에서 Python 뷰를 열려면 어느 사이드바에서든 패널 더 열기 버튼 을 클릭하고 외부 언어를 클릭합니다. 그런 다음, 패널의 왼쪽 위에 있는 언어 목록에서 Python 옵션을 선택합니다.
모든 Python 환경 섹션에서 환경을 마우스 오른쪽 버튼으로 클릭하고 선택한 환경으로 설정을 선택하여 기본 또는 가상 Python 환경 중 원하는 환경을 선택합니다.

선택한 환경이 외부 언어 패널의 선택한 Python 환경 섹션에 나타납니다.

자세한 내용은 Manage Python Environments Using External Languages Panel 항목을 참조하십시오.

Windows에서 Python 버전 설정하기

표준 인스톨러를 사용하여 Python을 설치한 경우 Python이 Windows 레지스트리에 등록됩니다. pyenv의 Version 이름-값을 사용하여 사용할 Python 버전을 설정할 수 있습니다. 예를 들어, 다음과 같이 입력합니다.

pyenv(Version="3.13");

인스톨러를 실행하지 않고 Python 파일을 컴퓨터에 복사하는 것과 같이 비표준 설치를 수행한 경우, 기본 환경 또는 가상 환경의 Python 실행 파일의 경로를 사용하여 Python 버전을 설정하십시오. 예를 들어, 다음과 같이 입력합니다.

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

pyenv는 현재 Python 환경에 대한 정보가 포함된 PythonEnvironment 객체를 반환합니다.

  PythonEnvironment with properties:

          Version: "3.13"
       Executable: "C:\Users\username\AppData\Local\Programs\Python\Python313\python.exe"
          Library: "C:\Users\username\AppData\Local\Programs\Python\Python313\python313.dll"
             Home: "C:\Users\username\AppData\Local\Programs\Python\Python313"
           Status: NotLoaded
    ExecutionMode: InProcess

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

Mac과 Linux에서 사용할 Python 버전을 설정하려면 pyenv의 Version 이름-값을 사용하여 기본 환경 또는 가상 환경의 Python 실행 파일에 대한 전체 경로를 지정하십시오. 예를 들어, 다음과 같이 입력합니다.

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

pyenv는 현재 Python 환경에 대한 정보가 포함된 PythonEnvironment 객체를 반환합니다.

  PythonEnvironment with properties:

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

`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 환경을 선택한 후에도 MATLAB은 Python 인터프리터를 즉시 불러오지 않습니다. MATLAB에서 Python 함수를 처음 호출할 때 불러옵니다. 첫 호출 전에, 필요하면 Python의 실행 모드를 변경할 수 있습니다. Python은 MATLAB과 동일한 프로세스(InProcess 모드) 또는 별도의 프로세스(OutOfProcess 모드)에서 실행할 수 있습니다.

기본적으로 Python은 InProcess 모드에서 실행됩니다. 이 실행 모드는 성능상의 이점이 있으며 기존 Python 코드를 실행하는 경우 권장됩니다.
Python 코드를 활발히 개발 중인 경우에는 실행 모드를 OutOfProcess로 설정하십시오. 이 모드에서는 불안정한 코드로 인해 MATLAB 세션이 비정상 종료되지 않도록 보호하며, Ctrl+C를 사용하여 장시간 실행되는 Python 코드를 중단할 수 있습니다. MATLAB과 충돌하는 타사 라이브러리를 사용해야 하는 경우에도 OutOfProcess 모드를 사용하십시오.

실행 모드를 설정하려면, 외부 언어 패널에서 설정 버튼 을 클릭하고 OutOfProcess를 선택하십시오. 또는 MATLAB 명령 프롬프트에 pyenv(ExecutionMode="OutOfProcess")를 입력합니다. 자세한 내용은 Python 기능의 별도 프로세스(Out-of-Process) 실행 항목을 참조하십시오.

Python이 MATLAB에서 작동하는지 확인하기

Python이 MATLAB에서 작동하는지 확인하려면 MATLAB에서 Python 표현식을 입력하여 Python 인터프리터를 불러옵니다. 예를 들어, 다음과 같이 입력합니다.

py.list

ans = 

  Python list with values:

    []

    Use string, double, datetime or cell function to convert to a MATLAB array.

Unable to resolve the name py.myfunc 오류 메시지(여기서 myfunc는 함수 이름임)가 표시되면 설치 문제가 있는 것일 수 있습니다. 문제 해결에 대한 도움말을 보려면 이름 py.myfunc를 확인할 수 없음 항목을 참조하십시오.

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

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

Python 환경 전환하기

외부 언어 패널을 통해 또는 pyenv를 호출하여, MATLAB이 사용하는 Python 환경을 변경할 수 있습니다. Python 환경을 변경하는 절차는 실행 모드에 따라 다릅니다.

Python을 InProcess 모드로 불러온 경우, 먼저 MATLAB을 다시 시작합니다. 그런 다음, 외부 언어 패널 또는 pyenv를 사용하여 Python 환경을 변경합니다.
Python을 OutOfProcess 모드로 불러온 경우, 먼저 terminate(pyenv)를 호출하여 Python 프로세스를 종료합니다. 그런 다음, 외부 언어 패널 또는 pyenv를 사용하여 Python 환경을 변경합니다.

외부 언어 패널에서 이전 Python 환경을 제거하려면 모든 Python 환경 목록에서 해당 환경을 마우스 오른쪽 버튼으로 클릭하고 환경 제거를 선택하십시오. 환경을 제거해도 시스템에서 해당 환경이 삭제되지는 않습니다. 나중에 다시 추가할 수 있습니다. MATLAB Support for Python 애드온에서 설치된 환경은 이런 방식으로 제거할 수 없습니다. 이러한 환경을 제거하려면, 애드온 패널에서 지원 패키지를 제거한 다음 새로 고침 버튼을 사용하여 외부 언어 패널을 새로 고치십시오.

MATLAB에서 사용하기 위해 Python 설치 및 구성하기

기존에 설치된 Python 확인하기

Python 설치하기

MATLAB 애드온 패널에서 Python 설치하기

`python.org`에서 Python 설치하기

MATLAB에서 사용할 Python 환경 구성하기

외부 언어 패널을 사용하여 Python 환경 선택하기

Windows에서 Python 버전 설정하기

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

`PYTHONHOME` 환경 변수 사용하기

실행 모드 변경하기(선택 사항)

Python이 MATLAB에서 작동하는지 확인하기

Python 환경 전환하기

참고 항목

함수

도움말 항목

외부 웹사이트

MATLAB에서 사용하기 위해 Python 설치 및 구성하기

기존에 설치된 Python 확인하기

Python 설치하기

MATLAB 애드온 패널에서 Python 설치하기

python.org에서 Python 설치하기

MATLAB에서 사용할 Python 환경 구성하기

외부 언어 패널을 사용하여 Python 환경 선택하기

Windows에서 Python 버전 설정하기

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

PYTHONHOME 환경 변수 사용하기

실행 모드 변경하기(선택 사항)

Python이 MATLAB에서 작동하는지 확인하기

Python 환경 전환하기

참고 항목

함수

도움말 항목

외부 웹사이트

`python.org`에서 Python 설치하기

`PYTHONHOME` 환경 변수 사용하기