ClusterPool

컴퓨터 클러스터에 워커로 구성된 병렬 풀

설명

parpool을 사용하여 컴퓨터 클러스터에 워커로 구성된 병렬 풀을 만듭니다. 풀을 만든 후에는 parfor 또는 parfeval 같은 병렬 풀 기능이 워커에서 실행됩니다. ClusterPool 객체를 사용하여 병렬 풀과 상호 작용할 수 있습니다.

생성

• parpool 함수를 사용하여 컴퓨터 클러스터에 병렬 풀을 만듭니다.

  pool = parpool("myCluster")

  여기서 myCluster는 컴퓨터 클러스터의 클러스터 프로파일 이름입니다.

• partition 함수를 사용하여 기존 병렬 풀에서 풀 파티션을 만듭니다. (R2025a 이후)

속성

AttachedFiles — 워커로 복사되는 파일과 폴더

문자형 벡터로 구성된 셀형 배열

워커로 복사되는 파일과 폴더로, 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 파일과 폴더를 풀에 첨부하려면 addAttachedFiles를 사용하십시오.

AutoAddClientPath — 클라이언트 경로에서 사용자가 추가한 항목을 워커 경로에 추가할지 여부에 대한 표시

읽기 전용: true (디폴트 값) | false

읽기 전용 속성입니다.

클라이언트 경로에서 사용자가 추가한 항목을 워커 경로에 추가할지 여부에 대한 표시로, 논리값으로 지정됩니다.

데이터형: logical

Cluster — 병렬 풀이 실행되고 있는 클러스터

읽기 전용: cluster 객체

읽기 전용 속성입니다.

병렬 풀이 실행되고 있는 클러스터로, parallel.Cluster 객체로 지정됩니다.

Connected — 병렬 풀이 실행 중인지 여부를 나타내는 플래그

읽기 전용: true | false

읽기 전용 속성입니다.

병렬 풀이 실행 중인지 여부를 나타내는 플래그로, 논리값으로 지정됩니다.

데이터형: logical

EnvironmentVariables — 워커로 복사되는 환경 변수

읽기 전용: 문자형 벡터로 구성된 셀형 배열

읽기 전용 속성입니다.

워커로 복사되는 환경 변수로, 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

FevalQueue — 병렬 풀에서 실행할 FevalFutures의 대기열

읽기 전용: FevalQueue

읽기 전용 속성입니다.

병렬 풀에서 실행할 FevalQueue의 대기열로, FevalFutures 객체로 반환됩니다. 이 속성을 사용하여 병렬 풀의 보류 중인 Future 변수와 실행 중인 Future 변수를 확인할 수 있습니다. Future 변수를 만들려면 parfeval 및 parfevalOnAll을 사용하십시오. Future 변수에 대한 자세한 내용은 Future 항목을 참조하십시오.

데이터형: FevalQueue

FileStore — 클라이언트와 워커 모두가 액세스할 수 있는 파일 저장소

FileStore

클라이언트와 워커 모두가 액세스할 수 있는 파일 저장소로, FileStore 객체로 지정됩니다.

IdleTimeout — 풀이 유휴 상태인 경우 종료되기까지의 시간

음이 아닌 정수

풀이 유휴 상태인 경우 종료되기까지의 시간(단위: 분)으로, 0보다 큰 정수로 지정됩니다. 풀은 워커에서 코드를 실행하지 않을 경우 유휴 상태로 간주됩니다. 기본적으로 'IdleTimeout'은 병렬 설정의 값과 동일합니다. 병렬 설정에 대한 자세한 내용은 병렬 설정 지정하기를 참조하십시오.

NumWorkers — 병렬 풀을 구성하는 워커 개수

읽기 전용: 정수

읽기 전용 속성입니다.

병렬 풀을 구성하는 워커 개수로, 정수로 지정됩니다.

ClusterPool 객체는 최대 2,000개의 워커가 있는 풀을 지원합니다. (R2024a 이후)

Busy — 병렬 풀이 처리 중인지 여부를 나타내는 플래그

읽기 전용: true | false

읽기 전용 속성입니다.

병렬 풀이 처리 중인지 여부를 나타내는 플래그로, true 또는 false로 지정됩니다. 풀에 완료해야 하는 미해결 작업이 있다면 풀은 처리 중인 것입니다.

SpmdEnabled — 풀이 spmd 코드를 실행할 수 있는지에 대한 표시

읽기 전용: true (디폴트 값) | false

읽기 전용 속성입니다.

풀이 spmd 코드를 실행할 수 있는지에 대한 표시로, 논리값으로 지정됩니다.

데이터형: logical

ValueStore — 클라이언트와 워커 모두가 액세스할 수 있는 데이터 저장소

ValueStore

클라이언트와 워커 모두가 액세스 할 수 있는 데이터 저장소로, ValueStore 객체로 지정됩니다.

Workers — 병렬 풀을 구성하는 워커에 대한 정보

읽기 전용: parallel.Worker 객체로 구성된 배열

R2025a 이후

읽기 전용 속성입니다.

병렬 풀을 구성하는 워커에 대한 정보는 parallel.Worker 객체의 배열로 반환됩니다.

객체 함수

addAttachedFiles	병렬 풀에 파일 또는 폴더 첨부
Composite	여러 워커에 분산되지 않은 변수를 클라이언트에서 생성 및 액세스
delete	병렬 풀 종료
listAutoAttachedFiles	List of files automatically attached to job, task, or parallel pool
parfeval	병렬 풀 워커에서 함수 실행
parfevalOnAll	병렬 풀의 모든 워커에서 비동기식으로 함수 실행
parforOptions	Options set for parfor
partition	Partition parallel pool
ticBytes	병렬 풀 내에서 전송된 바이트 수 계산 시작
tocBytes	Read how many bytes have been transferred since calling ticBytes
updateAttachedFiles	Update attached files or folders on parallel pool
spmd	병렬 풀의 워커에서 코드를 병렬로 실행

버전 내역

R2020a에 개발됨

R2025a: 워커 정보를 조회할 수 있는 새로운 속성

풀의 워커를 식별하려면 Workers 속성을 사용합니다.

R2024a: 최대 2,000개의 워커가 있는 풀에 대한 지원

R2024a부터는 ClusterPool 객체가 최대 2,000개의 워커가 있는 풀을 지원합니다. R2024a 이전 릴리스에서는 ClusterPool이 최대 1,000개의 워커가 있는 풀을 지원합니다.

참고 항목

parpool

도움말 항목

• 병렬 풀에서 코드 실행하기
• 스레드 기반 환경과 프로세스 기반 환경 중에서 선택하기