Instrument Control Toolbox

load

Load instrument objects and variables into the MATLAB workspace

Syntax

load filename
load filename obj1 obj2 ...
out = load('filename','obj1','obj2',...)

Arguments

filename	The MAT-file name.
obj1 obj2 ...	Instrument objects or arrays of instrument objects.
out	A structure containing the specified instrument objects.

Description

load filename returns all variables from the MAT-file specified by filename into the MATLAB workspace.

load filename obj1 obj2 ... returns the instrument objects specified by obj1 obj2... from the MAT-file filename into the MATLAB workspace.

out = load('filename','obj1','obj2',...) returns the specified instrument objects from the MAT-file filename as a structure to out instead of directly loading them into the workspace. The field names in out match the names of the loaded instrument objects.

Remarks

Values for read-only properties are restored to their default values upon loading. For example, the Status property is restored to closed. To determine if a property is read-only, examine its reference pages or use the propinfo function.

Example

Suppose you create the GPIB objects g1 and g2, configure a few properties for g1, and connect both objects to their associated instruments.

g1 = gpib('ni',0,1);
g2 = gpib('ni',0,2);
set(g1,'EOSMode','read','EOSCharCode',13)
fopen([g1 g2])

The read-only Status property is automatically configured to open.

get([g1 g2],'Status')
ans = 
    'open'
    'open'

Save g1 and g2 to the file MyObject.mat, and then load the objects into the MATLAB workspace.

save MyObject g1 g2
load MyObject g1 g2

Values for read-only properties are restored to their default values upon loading, while all other property values are honored.

get([g1 g2],{'EOSMode','EOSCharCode','Status'})
ans = 
    'read'    [13]    'closed'
    'none'    [10]    'closed'

See Also

Functions

instrhelp, propinfo, save

length

memmap