Read instrument objects from memory to MATLAB workspace
out = instrfind
out = instrfind('PropertyName
',PropertyValue,...)
out = instrfind(S)
out = instrfind(obj,'PropertyName
',PropertyValue,...)
| A property name for |
| A property value supported by |
| A structure of property names and property values. |
| An instrument object, or an array of instrument objects. |
| An array of instrument objects. |
out = instrfind
returns
all valid instrument objects as an array to out
.
out = instrfind('
returns
an array of instrument objects whose property names and property values
match those specified.PropertyName
',PropertyValue,...)
out = instrfind(S)
returns
an array of instrument objects whose property names and property values
match those defined in the structure S
. The field
names of S
are the property names, while the field
values are the associated property values.
out = instrfind(obj,'
restricts
the search for matching property name/property value pairs to the
instrument objects listed in PropertyName
',PropertyValue,...)obj
.
Suppose you create the following two GPIB objects.
g1 = gpib('ni',0,1); g2 = gpib('ni',0,2); g2.EOSCharCode = 'CR'; fopen([g1 g2])
You can use instrfind
to return instrument
objects based on property values.
out1 = instrfind('Type','gpib'); out2 = instrfind({'Type','EOSCharCode'},{'gpib','CR'});
You can also use instrfind
to return cleared
instrument objects to the MATLAB® workspace.
clear g1 g2 newobjs = instrfind Instrument Object Array Index: Type: Status: Name: 1 gpib open GPIB0-1 2 gpib open GPIB0-2
Assign the instrument objects their original names.
g1 = newobjs(1); g2 = newobjs(2);
Close both g1
and g2
.
fclose(newobjs)
instrfind
will not return an instrument
object if its ObjectVisibility
property is configured
to off
.
You must specify property values using the same format property
requires. For example, if the Name
property value
is specified as MyObject
, instrfind
will
not find an object with a Name
property value of myobject
.
However, this is not the case for properties that have a finite set
of character vector values. For example, instrfind
will
find an object with a Parity
property value of Even
or even
.
You can use the propinfo
function
to determine if a property has a finite set of character vector values.
You can use property name/property value character vector pairs,
structures, and cell array pairs in the same call to instrfind
.
To get a list of options you can use on a function, press the Tab key after entering a function on the MATLAB command line. The list expands, and you can scroll to choose a property or value. For information about using this advanced tab completion feature, see Using Tab Completion for Functions.
ObjectVisibility
| clear
| get
| instrfindall
| propinfo