parfevalOnAll

백그라운드의 모든 워커에 대해 함수 실행

구문

F = parfevalOnAll(backgroundPool,fcn,numFcnOut,X1,...,Xm)

F = parfevalOnAll(fcn,numFcnOut,X1,...,Xm)

설명

F = parfevalOnAll(backgroundPool,fcn,numFcnOut,X1,...,Xm)은 함수 fcn을 백그라운드의 모든 워커에서 실행하도록 예약합니다. MATLAB^®이 함수 fcn을 실행하는 동안 다른 코드를 실행할 수 있습니다. 워커 및 백그라운드에 대한 자세한 내용은 백그라운드 워커 항목을 참조하십시오.

참고

BackgroundPool은 Parallel Computing Toolbox™가 있는 경우에만 여러 개의 워커를 가집니다.

backgroundPool을 사용하여 백그라운드에서 코드를 실행할 경우 parfevalOnAll 함수를 사용하여 환경 변수를 설정할 필요가 없습니다.

병렬 풀의 모든 워커에서 함수를 실행하려면 parfevalOnAll (Parallel Computing Toolbox) 항목을 참조하십시오.

MATLAB은 각 워커에서 X1, X2,...,Xm 입력 인수와 함께 함수 fcn을 비동기식으로 실행하고 numFcnOut 출력 인수를 반환합니다.

MATLAB은 모든 백그라운드 워커에서 함수 fcn의 실행이 완료되기 전에 Future 객체 F를 반환합니다. fetchOutputs를 사용하여 Future 객체에서 결과값을 가져올 수 있습니다. 함수 fcn의 실행을 중지하려면 cancel 함수를 사용하십시오. Future 객체에 대한 자세한 내용은 Future 항목을 참조하십시오.

F = parfevalOnAll(fcn,numFcnOut,X1,...,Xm)은 함수 fcn을 실행하도록 예약합니다.

MATLAB은 함수 fcn의 실행이 완료되기 전에 Future 객체 F를 반환합니다.

Parallel Computing Toolbox와 함께 사용하도록 설계된 코드에서 이 구문을 사용합니다.

• Parallel Computing Toolbox가 없으면 병렬 리소스를 사용하지 않습니다. 함수는 직렬로 실행됩니다.

• Parallel Computing Toolbox가 있으면 parfevalOnAll 함수는 자동으로 병렬 리소스를 사용합니다.

입력 인수

fcn — 실행할 함수

함수 핸들

실행할 함수로, 함수 핸들로 지정됩니다.

예: fcn = @magic

numFcnOut — 요청된 출력 인수의 개수

음이 아닌 정수 스칼라

함수 fcn에서 요청된 출력 인수의 개수로, 음이 아닌 정수 스칼라로 지정됩니다.

numFcnOut은 fcn(X1,...,Xm)을 실행할 때 요청하는 출력 인수의 개수입니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

X1,...,Xm — 입력 인수

쉼표로 구분된 변수 또는 표현식 목록

입력 인수로, 쉼표로 구분된 변수 또는 표현식 목록으로 지정됩니다.

출력 인수

F — 출력 Future

parallel.Future 객체

출력 Future로, parallel.Future 객체로 반환됩니다.

• fetchOutputs 또는 fetchNext를 사용하여 F에서 결과값을 가져옵니다.

• afterEach 또는 afterAll을 사용하여 F가 완료될 때 함수를 실행합니다.

확장 기능

자동 병렬 지원

Parallel Computing Toolbox™를 사용해 자동 병렬 계산을 실행하여 코드 실행 속도를 높일 수 있습니다.

사용법 관련 참고 및 제한 사항:

• Parallel Computing Toolbox가 있는 경우 구문 parfevalOnAll(fcn,numFcnOut,X1,...,Xm)은 자동 병렬 연산을 지원합니다.

자세한 내용은 자동 병렬 연산을 지원하는 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

참고 항목

parfevalOnAll (Parallel Computing Toolbox) | cancel | afterEach | afterAll | fetchNext | fetchOutputs | wait | Future

도움말 항목

• 익명 함수