Main Content


Save instrument objects and variables to MAT-file


save filename
save filename obj1 obj2 ...



The MAT-file name.

obj1 obj2 ...

Instrument objects or arrays of instrument objects.


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.


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

s = serial('COM1');
save MySerial1 s


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 character vectors. For example, on a Windows® machine, save the serial port object s to the file MySerial.mat,

s = serial('COM1');

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.

Version History

Introduced before R2006a

See Also

| |