Instrument Control Toolbox

save

Save instrument objects and variables to a MAT-file

Syntax

• save filename
  save filename obj1 obj2...
  

Arguments

filename	The MAT-file name.
obj1 obj2...	Instrument objects or arrays of instrument objects.

Description

save filename saves all MATLAB variables to the MAT-file filename. If an extension is not specified for filename, then a .mat extension is used.

save filename obj1 obj2,... saves the instrument objects obj1 obj2 ... to the MAT-file filename.

Remarks

You can use save in the functional form as well as the command form shown above. When using the functional form, you must specify the filename and instrument objects as strings. For example, to save the serial port object s to the file MySerial.mat:

• s = serial('COM1');
  save('MySerial','s')
  

Any data that is associated with the instrument object is not automatically stored in the MAT-file. For example, suppose there is data in the input buffer for obj. To save that data to a MAT-file, you must bring the data into the MATLAB workspace using one of the synchronous read functions, and then save the data to the MAT-file using a separate variable name. You can also save data to a text file with the record function.

You return objects and variables to the MATLAB workspace with the load command. 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

This example illustrates how to use the command form and the functional form of save.

• s = serial('COM1');
  set(s,'BaudRate',2400,'StopBits',1)
  save MySerial1 s
  set(s,'BytesAvailableFcn',@mycallback)
  save('MySerial2','s')
  

See Also

Functions

instrhelp, load, propinfo, record

Properties

Status

resolvehost

scanstr