dload
Load distributed arrays and Composite
objects
Syntax
Description
dload
loads all variables from the
file with the name filename
filename
. If you do not specify an extension, the
function assumes that the extension is .mat. The function loads the contents of
distributed arrays and Composite
objects onto parallel pool workers. The
function loads other data types directly into the workspace of the MATLAB® client.
When you load distributed arrays, the function distributes the data over the current parallel pool workers using the default distribution scheme. You do not need to have the same size pool open when you load variables using this function.
When you load
Composite
objects, the function sends the data to the current parallel pool workers. If theComposite
is too large to fit on the current parallel pool, the software does not load the data. If theComposite
is smaller than the current parallel pool, the software returns a warning.
If a parallel pool is not open, by default the dload
function
starts a parallel pool of workers using the default profile.
dload -scatter ___
attempts to distribute
nondistributed data. If dload
cannot distribute the data, it returns
a warning.
dload(
performs the same operation
as filename
)dload filename
.
For example, these function calls are equivalent:
dload("test.mat")
dload test.mat
Examples
Input Arguments
Tips
The
dload
function loads a distributed array orComposite
object on the workers of the existing parallel pool. If no pool exists, thedload
function starts a new parallel pool, unless automatically starting pools is disabled in your parallel preferences. If no parallel pool exists anddload
cannot start one,dload
loads distributed objects but cannot loadComposite
objects.
Version History
Introduced in R2010a
See Also
load
| Composite
| distributed
| dsave
| parpool