Main Content

matlab.engine.connect_matlab

공유 MATLAB 세션을 PythonMATLAB Engine에 연결

설명

예제

eng = matlab.engine.connect_matlab(name=None)은 공유 MATLAB® 세션 name에 연결되고, MatlabEngine 객체를 eng로 반환합니다. 입력 인수 name은 로컬 컴퓨터에서 이미 실행 중인 MATLAB 세션의 이름을 지정합니다.

  • name을 지정한 경우 엔진에서 동일한 이름의 공유 MATLAB 세션을 찾지 못하면, EngineError 예외가 발생합니다.

  • name을 지정하지 않은 경우 엔진에서 공유 MATLAB 세션을 찾지 못하면 공유 MATLAB 세션이 새로 시작됩니다.

  • name을 지정하지 않았고 엔진에서 실행 중인 공유 MATLAB 세션을 여러 개 찾으면 가장 먼저 생성된 세션에 연결됩니다.

eng = matlab.engine.connect_matlab(___,background)backgroundTrue이면 비동기식으로 연결됩니다. 이 구문은 위에 열거된 구문의 name 입력 인수와 함께 사용할 수 있습니다.

eng = matlab.engine.connect_matlab(___,async)asyncTrue이면 비동기식으로 연결됩니다. 권장되지 않습니다. 대신 background 인수를 사용하십시오. Python® 버전 3.7 이상에는 사용하지 마십시오. 자세한 내용은 호환성 관련 고려 사항 항목을 참조하십시오.

예제

모두 축소

로컬 컴퓨터에서 이미 실행 중인 공유 MATLAB 세션에 연결합니다.

import matlab.engine
eng = matlab.engine.connect_matlab()
eng.sqrt(4.0)
2.0

matlab.engine.connect_matlab은 가장 먼저 생성된 공유 MATLAB 세션에 연결됩니다. 공유된 MATLAB 세션이 없으면 matlab.engine.connect_matlab은 새 세션을 시작합니다.

로컬 컴퓨터에 공유 MATLAB 세션이 여러 개 있으면, 이름을 지정하여 서로 다른 두 세션에 한 번에 하나씩 연결합니다.

가장 먼저 생성된 MATLAB 세션에 연결합니다.

import matlab.engine
names = matlab.engine.find_matlab()
names
('MATLAB_6830', 'MATLAB_7090')

그다음 MATLAB 세션에 연결합니다.

eng = matlab.engine.connect_matlab('MATLAB_7090')
eng.sqrt(4.0)
2.0

입력 인수

모두 축소

공유 MATLAB 세션의 이름으로, 문자형 배열로 지정됩니다. 이름은 유효한 MATLAB 변수 이름이어야 합니다.

MATLAB에 동기식 또는 비동기식으로 연결하며, 논리형 키워드 인수로 지정됩니다.

예: matlab.engine.connect_matlab(background=True)

MATLAB에 동기식 또는 비동기식으로 연결하며, 논리형 키워드 인수로 지정됩니다. 권장되지 않습니다. 대신 background 인수를 사용하십시오. 자세한 내용은 호환성 관련 고려 사항 항목을 참조하십시오.

출력 인수

모두 축소

MATLAB과의 통신을 위한 Python 변수로, MatlabEngine 객체로 반환됩니다. eng는 로컬 컴퓨터에서 이미 실행 중인 공유 MATLAB 세션과 통신합니다.

제한 사항

  • 동일한 공유 MATLAB 세션에 엔진을 여러 번 연결하지 마십시오.

버전 내역

R2015b에 개발됨

모두 확장