ProcessPool - Parallel pool of process workers on the local machine - MATLAB (original) (raw)
Main Content
Parallel pool of process workers on the local machine
Since R2020a
Description
Use parpool to create a parallel pool of process workers on your local machine. After you create the pool, parallel pool features, such asparfor or parfeval, run on the workers. With theProcessPool object, you can interact with the parallel pool.
Creation
Create a parallel pool of process workers on the local machine by using the parpool function.
pool = parpool('Processes')
Properties
AttachedFiles — Files and folders copied to workers
cell array of character vectors
Files and folders copied to workers, specified as a cell array of character vectors. To attach files and folders to the pool, use addAttachedFiles.
AutoAddClientPath — Indication whether user-added entries on client path are added to worker paths
true (default) | false
This property is read-only.
Indication whether user-added entries on client path are added to worker paths, specified as a logical value.
Data Types: logical
Cluster — Cluster on which the parallel pool is running
cluster object
This property is read-only.
Cluster on which the parallel pool is running, specified as a parallel.Cluster object.
Connected — Flag that indicates whether the parallel pool is running
true | false
This property is read-only.
Flag that indicates whether the parallel pool is running, specified as a logical value.
Data Types: logical
EnvironmentVariables — Environment variables copied to the workers
cell array of character vectors
This property is read-only.
Environment variables copied to the workers, specified as a cell array of character vectors.
FevalQueue — Queue of FevalFuture objects to run on the parallel pool
FevalQueue
This property is read-only.
Queue of FevalFutures to run on the parallel pool, specified as an FevalQueue object. You can use this property to check the pending and running future variables of the parallel pool. To create future variables, useparfeval and parfevalOnAll. For more information on future variables, see Future.
Data Types: FevalQueue
FileStore — Store of files accessible to both client and workers
FileStore
Store of files accessible to both client and workers, specified as a FileStore object.
IdleTimeout — Time after which the pool shuts down if idle
nonnegative integer
Time in minutes after which the pool shuts down if idle, specified as an integer greater than zero. A pool is idle if it is not running code on the workers. By default'IdleTimeout' is the same as the value in your parallel preferences. For more information on parallel preferences, see Specify Your Parallel Preferences.
NumWorkers — Number of workers comprising the parallel pool
integer
This property is read-only.
Number of workers comprising the parallel pool, specified as an integer.
Busy — Flag that indicates whether the parallel pool is busy
true | false
This property is read-only.
Flag that indicates whether the parallel pool is busy, specified astrue or false. The pool is busy if there is outstanding work for the pool to complete.
SpmdEnabled — Indication if pool can run spmd code
true (default) | false
This property is read-only.
Indication if pool can run spmd code, specified as a logical value.
Data Types: logical
ValueStore — Store of data accessible to both client and workers
ValueStore
Store of data accessible to both client and workers, specified as a ValueStore object.
Object Functions
Version History
Introduced in R2020a
R2022b: local profile is not recommended
Starting in R2022b, the local profile has been renamed toProcesses. There are no plans to remove local. To start a parallel pool of process workers on the local machine, useProcesses instead.