MATLAB Programming/Basic Reading and Writing data from a file

MATLAB file typesEdit

There are two file types used by MATLAB namely .m and .mat files

  • .m / .mat files: Standard MATLAB files (Most functions in .mat can be supported by the older version off MATLAB)
  • .mlx files: Live Code File Format. This format were just introduced on MATLAB version R2016a. This type of files storing the live scripts/live functions that uses the Live Code file format.

Import functionsEdit

The function that usually are used to import data into MATLAB : importdata(filename)
importdata(filename) can loads data into array.

 % sample script of loading an images
 >> A = importdata('example1.png');

Loading DataEdit

load(filename) can loads data from filename. The files can be text, images , and even audio files.

 % sample script of loading an audio
 >> B = load('example2.mp3');

The load command is used to load data from a file into the current workspace.

  • Load all variables from the file mySave.mat into the current workspace.
 >> load('mySave.mat')
 >> load(fullfile(pwd, 'mySave.mat'))
  • Load just the variables myData1 and myData2.
 >> load('mySave.mat', 'myData1', 'myData2')
  • Load all myData variables.
 >> load('mySave.mat', 'myData*')
  • Get a cell array of variables in saved file.
 >> whos('-file', 'mySave.mat')

Saving DataEdit

The save command is used to save workspace data to a file.

  • Save all workspace data to the file mySave.mat in the current directory.
 >> save('mySave.mat')
 >> save(fullfile(pwd, 'mySave.mat'))
  • Save just the variables myData1 and myData2 to mySave.mat.
 >> save('mySave.mat', 'myData1', 'myData2')
  • Save all myData variables to mySave.mat.
 >> save('mySave.mat', 'myData*')
  • Save all myData variables to a mySave.mat file compatible with version 6 of MATLAB.
 >> save('mySave.mat', 'myData*', '-v6')
  • Save all myData variables to an ASCII file.
 >> save('mySave.mat', 'myData*', '-ASCII')
  • Append new variables to the data file.
 >> save('mySave.mat', 'newData*', '-append')

Excel Spreadsheets I/OEdit

Since analyzing data is one of the more common motivations for using input output I will start with reading and writing from a spreadsheet. I cover the command line first since it is often necessary to import the data while an m-function is being evaluated.

Reading Excel SpreadsheetsEdit

MATLAB makes it easy to read from an Excel spreadsheet. It has the built in command "xlsread". To use the xlsread function use the syntax:


This line of code reads filename.xls (from the current directory) and places it in an identical array inside MATLAB called g. You can then manipulate the array g any way you want. Make sure that the file you choose is in the same directory were you save your M-files (usually the work directory) otherwise you get an error. You can specify the path to a file but, this can get messy.

Writing Excel SpreadsheetsEdit

To write data to an .xls the procedure is very similar. The xlswrite command below creates a spreadsheet called filename.xls in the current directory from the variable g:

>> xlswrite('filename',g);

NOTE: if you are using MATLAB 6.5 there is no "xlswrite" command (that I'm aware of). There are several ways to write to a file. The simplest way I have found is

fid=fopen('newFile.xls', 'w');
fprintf(fid,'%6.3f %6.3f %10.3f\n', g);           

You can substitute newFile.xls with .txt. Also, there might be some issues with formatting in Excel. The formatting issues can usually be handled inside Excel but if they can't you might have to play around with the fopen command parameters. This is pretty similar (if not the same) way you would write to a file in C.

Text files I/OEdit

Reading Text FilesEdit

If a file is not an excel spreadsheet, it can still be read using "load" function:

>> load newfile.txt

This works only if the text is entirely numerical, without special formatting. Otherwise you get an 'unrecognized character' error.

The easiest way to write to a non-excel file, or using MATLAB 6.5 or less, is to use the same code as that for writing excel files but change the extension. Usually there are no formatting difficulties with plain text files.

For reading more general text files, MATLAB does not have a function to do it easily (unless you have excel), but you can read very general text files (with different delimiters for both cells and text within cells) using the "textread.m" function in the MATLAB file exchange (do a google search to find it). You can also try to use fscanf if the formatting is consistent enough (i.e. consistent numbers of spaces, no mixing of strings and numbers in columns, and so on).

MATLAB File I/O: from the Graphical User InterfaceEdit

MATLAB contains a nice GUI application that will guide you through importing data from any recognized data file (usually .mat, .txt, or .xls on a Windows system). To use it, go to file > import data, and select the file you want. Then, choose what column separators are present (by selecting the appropriate radio button). Finally, click "next".

MATLAB saves the variable under a name similar to that of the file, but with modifications to make it conform with MATLAB syntax. Spaces are omitted, plusses and minuses are turned into other characters. To see the name MATLAB generated (and probably change it) type "who" in the command prompt.

External ResourcesEdit