User`s guide

11 Functions — Alphabetical List
11-74
dload
Load distributed arrays and Composite objects from disk
Syntax
dload
dload filename
dload filename X
dload filename X Y Z ...
dload -scatter ...
[X,Y,Z,...] = dload('filename','X','Y','Z',...)
Description
dload without any arguments retrieves all variables from the binary file named
matlab.mat. If matlab.mat is not available, the command generates an error.
dload filename retrieves all variables from a file given a full pathname or a relative
partial pathname. If filename has no extension, dload looks for filename.mat. dload
loads the contents of distributed arrays and Composite objects onto parallel pool workers,
other data types are loaded directly into the workspace of the MATLAB client.
dload filename X loads only variable X from the file. dload filename X Y Z ...
loads only the specified variables. dload does not support wildcards, nor the -regexp
option. If any requested variable is not present in the file, a warning is issued.
dload -scatter ... distributes nondistributed data if possible. If the data cannot be
distributed, a warning is issued.
[X,Y,Z,...] = dload('filename','X','Y','Z',...) returns the specified
variables as separate output arguments (rather than a structure, which the load
function returns). If any requested variable is not present in the file, an error occurs.
When loading distributed arrays, the data is distributed over the available parallel pool
workers using the default distribution scheme. It is not necessary to have the same size
pool open when loading as when saving using dsave.