parfor
Parallel for-loop
Syntax
parfor loopvar = initval:endval;
statements
;
end
parfor (loopvar = initval:endval, M); statements
;
end
Description
parfor loopvar = initval:endval;
executes a series of MATLAB® statements for values
of statements
;
endloopvar
between initval
and endval
,
inclusive, which specify a vector of increasing integer values. The
loop runs in parallel when you have the Parallel Computing Toolbox™ or
when you create a MEX function or standalone code with MATLAB
Coder™.
Unlike a traditional for
-loop, iterations are not
executed in a guaranteed order. You cannot call scripts directly in
a parfor
-loop. However, you can call functions
that call scripts.
parfor (loopvar = initval:endval, M);
executes statements in a loop using a maximum of statements
;
endM
workers or
threads, where M
is a nonnegative integer.
Examples
Perform three large eigenvalue computations using three workers or cores with Parallel Computing Toolbox software:
parpool(3) parfor i=1:3, c(:,i) = eig(rand(1000)); end
Tips
If you have Parallel Computing Toolbox software, see the function reference pages for
parfor
(Parallel Computing Toolbox) andparpool
(Parallel Computing Toolbox) for additional information.If you have MATLAB Coder software, see the
parfor
(MATLAB Coder) function reference page for additional information.
Extended Capabilities
Version History
Introduced in R2008a