load

Load variables from file into workspace

Syntax

load(filename)

load(filename,variables)

load(filename,'-ascii')

load(filename,'-mat')

load(filename,'-mat',variables)

S = load(___)

load filename

Description

load(filename) loads data from filename.

• If filename is a MAT-file, then load(filename) loads variables in the MAT-file into the MATLAB^® workspace.

• If filename is an ASCII file, then load(filename) creates a double-precision array containing data from the file.

Note

Security Considerations: The load command might execute code contained in the MAT-file as it initializes variables. Avoid calling load on untrusted MAT-files.

load(filename,variables) loads the specified variables from the MAT-file, filename.

load(filename,'-ascii') treats filename as an ASCII file, regardless of the file extension.

load(filename,'-mat') treats filename as a MAT-file, regardless of the file extension.

load(filename,'-mat',variables) loads the specified variables from filename.

S = load(___) loads data into S, using any of the input arguments in the previous syntax group.

• If filename is a MAT-file, then S is a structure array.

• If filename is an ASCII file, then S is a double-precision array containing data from the file.

load filename is the command form of the syntax. Command form requires fewer special characters. You do not need to type parentheses or enclose input in single or double quotes. Separate inputs with spaces instead of commas.

For example, to load a file named durer.mat, these statements are equivalent:

load durer.mat      % command form
load('durer.mat')   % function form

You can include any of the inputs described in previous syntaxes. For example, to load the variable named X:

load durer.mat X       % command form
load('durer.mat','X')  % function form

Do not use command form when any of the inputs, such as filename, are variables or strings.

Examples

Load All Variables from MAT-File

Load all variables from the example MAT-file, gong.mat. Check the contents of the workspace before and after the load operation.

disp('Contents of workspace before loading file:')
whos

disp('Contents of gong.mat:')
whos('-file','gong.mat')

load('gong.mat')
disp('Contents of workspace after loading file:')
whos

You also can use command syntax to load the variables. Clear the previously loaded variables and repeat the load operation.

clear y Fs

load gong.mat

Load Specific Variable From MAT-File

Load only variable y from example file handel.mat. If the workspace already contains variable y, the load operation overwrites it with data from the file.

load('handel.mat','y')

You also can use command syntax to load the variable, y.

load handel.mat y

Use Regular Expressions to Load Specific Variables

View the contents of the example file, accidents.mat.

whos -file accidents.mat

 Name              Size            Bytes  Class     Attributes

  datasources       3x1              2724  cell                
  hwycols           1x1                 8  double              
  hwydata          51x17             6936  double              
  hwyheaders        1x17             2758  cell                
  hwyidx           51x1               408  double              
  hwyrows           1x1                 8  double              
  statelabel       51x1              6596  cell                
  ushwydata         1x17              136  double              
  uslabel           1x1               138  cell                

Use function syntax to load all variables with names not beginning with 'hwy', from the file.

load('accidents.mat', '-regexp', '^(?!hwy)...')

Alternatively, use command syntax to load the same variables.

load accidents.mat -regexp '^(?!hwy)...'

Load List of Variables into Structure Array

The file, durer.mat, contains variables X, caption, and map. Create a cell array of variable names to load.

filename = 'durer.mat';
myVars = {'X','caption'};
S = load(filename,myVars{:})

S = struct with fields:
          X: [648x509 double]
    caption: [2x28 char]

Only the variables X and caption are loaded into the structure array, S.

Load ASCII File

Create an ASCII file from several 4-column matrices, and load the data back into a double-precision array.

a = magic(4);
b = ones(2, 4) * -5.7;
c = [8 6 4 2];
save -ascii mydata.dat a b c
clear a b c

load mydata.dat -ascii

load creates an array of type double named mydata.

View information about mydata.

whos mydata

  Name        Size            Bytes  Class     Attributes

  mydata      7x4               224  double              

Input Arguments

filename — Name of file

matlab.mat (default) | character vector | string scalar

Name of file, specified as a character vector or string scalar. If you do not specify filename, the load function searches for a file named matlab.mat.

If filename has no extension (that is, no text after a period), load looks for a file named filename.mat. If filename has an extension other than .mat, the load function treats the file as ASCII data.

Depending on the location of your file, filename can take on one of these forms.

Location	Form
Current folder or folder on the MATLAB path	Specify the name of the file in filename. Example: 'myFile.mat'
File in a folder	If the file is not in the current folder or in a folder on the MATLAB path, then specify the full or relative path in filename. Example: 'C:\myFolder\myFile.mat' Example: 'dataDir\myFile.mat'
Remote Locations (version 7.3 MAT-files only)	If the file is stored at a remote location, then filename must be a uniform resource locator (URL) of this form: scheme_name://path_to_file/my_file.mat Based on your remote location, scheme_name can be one of the values in this table. Remote Location scheme_name Amazon S3™ s3 Windows Azure® Blob Storage wasb, wasbs HDFS™ hdfs The load function only supports loading version 7.3 MAT-files from remote locations. For more information on setting up MATLAB to access your online storage service, see Work with Remote Data. Example: 's3://bucketname/path_to_file/my_file.mat'

When using the command form of load, you do not need to enclose the input in single quotes. However, if filename contains a space, you must enclose the argument in single quotes. For example, load 'filename withspace.mat'.

Note

Do not use command form when filename is a string.

ASCII files must contain a rectangular table of numbers, with an equal number of elements in each row. The file delimiter (the character between elements in each row) can be a blank, comma, semicolon, or tab character. The file can contain MATLAB comments (lines that begin with a percent sign, %).

variables — Names of variables to load

character vector | string scalar

Names of variables to load, specified as one or more character vector or string scalar. When using the command form of load, you do not need to enclose the input in single quotes.

Note

Do not use command form when variables is a string.

variables can be in one of the following forms.

Form of variables Input	Variables to Load
var1,...,varN	Load the listed variables, specified as individual character vectors or strings. Use the '*' wildcard to match patterns. For example, load('filename.mat','A*') or load filename.mat A* loads all variables in the file whose names start with A.
'-regexp',expr1,...,exprN	Load only the variables or fields whose names match the regular expressions, specified as character vectors or strings. For example, load('filename.mat','-regexp','^Mon','^Tues') or load filename.mat -regexp ^Mon ^Tues loads only the variables in the file whose names begin with Mon or Tues.

Output Arguments

S — Loaded variables or data

structure array | m-by-n array

Loaded variables, returned as a structure array, if filename is a MAT-File.

Loaded data, returned as an m-by-n array of type double, if filename is an ASCII file. m is equal to the number of lines in the file, and n is equal to the number of values on a line.

Limitations

• When working with remote data, load does not support treating the input file as an ASCII file.

Algorithms

If you do not specify an output for the load function, MATLAB creates a variable named after the loaded file (minus any file extension). For example, the command

load mydata.dat

reads data into a variable called mydata.

To create the variable name, load precedes any leading underscores or digits in filename with an X and replaces any other nonalphabetic characters with underscores. For example, the command

load 10-May-data.dat

creates a variable called X10_May_data.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• Use load only when generating MEX functions or code for Simulink^® simulation. To load compile-time constants, use coder.load.

• Does not support use of the function without assignment to a structure or array. For example, use S = load(filename), not load(filename).

• The output S must be the name of a structure or array without any subscripting. For example, S(i) = load('myFile.mat') is not supported.

• Arguments to load must be compile-time constant character vectors.

• If the MAT-file contains unsupported constructs, use S = load(filename,variables) to load only the supported constructs.

• In a function intended for code generation, the use of save or the use of coder.extrinsic with save is not supported. To save the workspace data to a MAT-file, use the save function prior to generating code.

• When using the load function to load variables whose size can change at run time, you must explicitly declare the variables as variable-size data by using coder.varsize.

Version History

Introduced before R2006a