matlab.engine.MatlabEngine

네임스페이스: matlab.engine

Python 세션 내에서 MATLAB을 계산 엔진으로 사용하는 Python 객체

설명

MatlabEngine 클래스는 MATLAB^® 프로세스를 Python^®의 계산 엔진으로 사용합니다. MATLAB 함수를 호출하면 동적으로 불러오기 때문에, 이 함수를 MatlabEngine 객체의 메서드로 호출할 수 있습니다. 정의한 함수와 스크립트도 호출할 수 있습니다. MatlabEngine 객체와 연결된 MATLAB 작업 공간에 데이터를 보내거나 이 작업 공간에서 데이터를 가져올 수 있습니다.

생성

matlab.engine.start_matlab 메서드는 호출될 때마다 MatlabEngine 객체를 생성합니다. 자체 MatlabEngine 객체를 생성하기 위해 matlab.engine.MatlabEngine()을 호출할 필요는 없습니다.

특성

특성	설명
workspace	MATLAB 변수에 대한 참조를 포함하는 Python 사전. workspace를 통해 MATLAB 변수에 데이터를 할당하거나 이 변수에서 데이터를 가져올 수 있습니다. 생성하는 각 MATLAB 변수의 이름은 workspace 사전에서 키가 됩니다. workspace의 키는 유효한 MATLAB 식별자여야 합니다. 예를 들어, 숫자는 키로 사용할 수 없습니다.

메서드

퍼블릭 메서드

matlab.engine.start_matlab	MATLAB을 시작합니다.
matlab.engine.find_matlab	Python용 MATLAB Engine에 연결할 공유 MATLAB 세션을 찾습니다.
matlab.engine.connect_matlab	공유 MATLAB 세션에 연결합니다.

특화된 연산자와 함수

모든 MATLAB 함수는 MatlabEngine 객체의 메서드로 호출할 수 있습니다. MATLAB 함수를 호출하면 엔진은 이 함수를 동적으로 불러옵니다. 구문에 함수 호출의 위치 인수, 키워드 인수 및 출력 인수가 표시됩니다.

ret = MatlabEngine.matlabfunc(*args,nargout=1,background=False,stdout=sys.stdout,stderr=sys.stderr)

matlabfunc를 MATLAB 함수 이름(예: isprime 또는 sqrt)으로 바꾸십시오. *args를 호출하는 MATLAB 함수의 입력 인수로 바꾸십시오. 키워드 인수는 다음을 지정합니다.

• 함수에서 반환하는 출력 인수의 개수

• 엔진이 함수를 비동기식으로 호출하는지 여부

• 엔진이 함수에서 발생하는 표준 출력과 표준 오류를 전송하는 경우

구문에 표시된 디폴트 값이 아닌 값을 지정할 경우에만 키워드 인수를 지정하십시오.

MATLAB 함수의 입력 인수

인수	설명	Python 유형
*args	MATLAB 함수의 입력 인수로, 위치 인수로 지정됨	엔진이 MATLAB 유형으로 변환할 수 있는 모든 Python 유형

엔진에 대한 키워드 인수

인수	설명	Python 유형
nargout	MATLAB 함수에서 생성된 출력 인수의 개수	int 디폴트 값: 1
background	MATLAB 함수를 비동기식으로 호출하는 플래그 background는 async의 별칭입니다. 하지만 Python 버전 3.7부터는 async가 키워드이므로 인수로 사용할 수 없습니다. 지원되는 모든 Python 버전에 대해 async 대신 background 인수를 사용하십시오.	bool 디폴트 값: False
stdout	표준 출력	io.StringIO 객체 디폴트 값: sys.stdout
stderr	표준 오류	io.StringIO 객체 디폴트 값: sys.stderr

출력 인수

출력 유형	설명	필수 키워드 인수
Python 변수	MATLAB 함수에서 생성된 출력 인수 한 개	디폴트 값
tuple	MATLAB 함수에서 생성된 출력 인수 여러 개	nargout=n(여기서 n > 1임)
None	MATLAB 함수에서 생성된 출력 인수 없음	nargout=0
FutureResult 객체	MATLAB 함수에 대한 비동기식 호출에서 생성된 출력 인수의 자리 표시자	background=True

예외

예외	설명
MatlabExecutionError	함수 호출이 실행되지 못함
RejectedExecutionError	MATLAB Engine이 종료됨
SyntaxError	함수 호출에 구문 오류가 있음
TypeError	입력 인수나 출력 인수의 데이터형이 지원되지 않음

예제

Python에서 MATLAB 함수 호출하기

엔진을 사용하여 Python에서 MATLAB sqrt 함수를 호출합니다.

import matlab.engine
eng = matlab.engine.start_matlab()
ret = eng.sqrt(4.0)
print(ret)

2.0

배열을 MATLAB 작업 공간에 두기

Python에서 배열을 만들어 MATLAB 작업 공간에 둡니다.

import matlab.engine
eng = matlab.engine.start_matlab()
px = eng.linspace(0.0,6.28,1000)

px는 MATLAB 배열이지만, eng.linspace가 이 배열을 Python에 반환했습니다. MATLAB에서 이 배열을 사용하려면 배열을 MATLAB 작업 공간에 두어야 합니다.

eng.workspace['mx'] = px

항목을 엔진 workspace 사전에 추가할 때 MATLAB 변수를 생성할 수도 있습니다. 엔진에서 데이터를 MATLAB 데이터형으로 변환합니다.

MATLAB 작업 공간에서 데이터 가져오기

pi를 MATLAB 작업 공간에서 가져온 다음, Python 변수에 복사합니다.

import matlab.engine
eng = matlab.engine.start_matlab()
eng.eval('a = pi;',nargout=0)
mpi = eng.workspace['a']
print(mpi)

3.14159265359

버전 내역

R2014b에 개발됨

참고 항목

matlab.engine.start_matlab | matlab.engine.connect_matlab | matlab.engine.find_matlab | matlab.engine.FutureResult

도움말 항목

• Python에서 MATLAB 함수 호출하기
• Python에서 MATLAB 함수를 비동기식으로 호출하기
• 표준 출력 및 표준 오류를 Python으로 리디렉션하기
• Python에서 MATLAB 호출하기