Octave has been mainly built with MATLAB compatibility in mind. It has a lot of features in common with MATLAB:
- Matrices as fundamental data type.
- Built-in support for complex numbers.
- Powerful built-in math functions and extensive function libraries.
- Extensibility in the form of user-defined functions.
Some of the differences that do exist between Octave and MATLAB can be worked around using "user preference variables."
GNU Octave is mostly compatible with MATLAB. However, Octave's parser allows some (often very useful) syntax that MATLAB's does not, so programs written for Octave might not run in MATLAB. For example, Octave supports the use of both single and double quotes. MATLAB only supports single quotes, which means parsing errors will occur if you try to use double quotes (e.g. in an Octave script when run on MATLAB). Octave and MATLAB users who must collaborate with each other need to take note of these issues and program accordingly.
- Note: Octave can be run in "traditional mode" (by including the --traditional flag when starting Octave) which makes it give an error when certain Octave-only syntax is used.
This chapter documents instances where MATLAB's parser will fail to run code that will run in Octave, and instances where Octave's parser will fail to run code that will run in MATLAB. This page also contains notes on differences between things that are different between Octave (in traditional mode) and MATLAB.
C-Style Autoincrement and Assignment operatorsEdit
Octave supports C-style autoincrement and assignment operators:
i++; ++i; i+=1; etc.
MatLab does not.
Octave and MATLAB support temporary expressions.
tmp = size(mtx); columns = tmp(2); % works in both columns = size(mtx)(2); % works in Octave, fails in MATLAB columns = size(mtx,2); % works in both
Product of booleansEdit
MATLAB (R2011b) and Octave (3.6.4) responds differently when computing the product of boolean values:
X = ones(2,2) ; prod(size(X)==1) MATLAB: PROD is only supported for floating point input. Octave: ans = 0
Nargin returns the number of input arguments of a function. MATLAB (R2011b) will not allow the following; Octave will.
function myfun = testfun(c) if (nargin == 1) nargin = 2; else nargin = 3 end
MATLAB will execute a file named 'startup.m' in the directory it was called from on the command line. Octave does not. It will, however, execute a file named '.octaverc' which can be edited to execute existing files. This means that '.octaverc' can be edited to look for and execute a 'startup.m' file.
if ( exist ('startup.m', 'file') ) source ('startup.m') # load startup.m like MATLAB endif
['abc ';'abc'] is allowed in Octave; MATLAB returns: ?? Error using ==> vertcat
In Octave the result will be a 2 by 4 matrix.
the "! STRING" syntax calls a shell with command STRING in MATLAB. Octave does not recognize ! as system call, since it is used in logical operations. Always use 'system (STRING)' for compatibility.
If you really miss the one-character shortcut, for convenience on the command line you can create a similar shortcut by defining the following in your '.octaverc' file:
function S(a), system(a); end
Now "S STRING" will evaluate the string in the shell.
Attempting to load empty filesEdit
MATLAB lets you load empty files, OCTAVE does not.
system('touch emptyfile'); A = load('emptyfile')
MATLAB R2011b : A= Octave 3.6.2 : error: load: file `emptyfile' seems to be empty! error: load: unable to extract matrix size from file `emptyfile'
fprintf and printfEdit
Octave supports both
fprintf as a command for printing to the screen. MATLAB requires
foo = 5; printf ('My result is: %d\n', foo) % Prints to STDOUT. Octave only
fprintf covers writing both to the screen and to a file by omitting the optional file-handle argument:
foo = 5; fprintf('My result is: %d\n', foo) % Prints to STDOUT. Octave and MATLAB
MATLAB does not allow whitespace before the transpose operator but Octave does (it is just an operator like others).
[0 1]' % works in MATLAB and Octave [0 1] ' % works only in Octave
MATLAB always requires
... for line continuation.
rand (1, ... 2)
while Octave also supports
rand (1, 2)
rand (1, \ 2)
Logical operator NOTEdit
Octave allows users to use both ~ and ! with boolean values. The first is for MATLAB compatibility, while ! will be more familiar to C/Java/etc programmers. If you use the latter, however, you'll be writing code that MATLAB will not accept:
- For not-equal comparison, Octave can use both '~=' or '!='. MATLAB requires '~='.
GNU Octave Control PackageEdit
Both MATLAB and Octave have toolboxes intended to control system design. In Octave, the toolbox is called the Octave Control Package. The package can be downloaded, compiled and installed with the command
pkg install control from the Octave prompt. Users of Debian and its derivatives can install it by installing the package "octave-control", if it is not installed by default.
For more information about functions' syntax, type help <name of function>. For more information about the Control Package, view the PDF manual in the package's "doc" folder.
Small differences exist - an example is c2d. Here are the two formats for the bilinear transformation with an analog model C:
- discrete = c2d(C,0.5,'tustin'); % Matlab
- discrete = c2d(C,0.5,'bi'); % GNU Octave
Some other differencesEdit
- MATLAB uses the percent sign '%' to begin a comment. Octave uses both the hash symbol
#and the percent sign
- For exponentiation, Octave can use
**; MATLAB requires
- For string delimiters, Octave can use
"; MATLAB requires
- To end blocks, Octave can use
endor specify the block with
endif, endfor, ...; MATLAB requires
- Octave supports C-style hexadecimal notation (e.g. "0xF0"); MATLAB requires the
hex2decfunction (e.g. "hex2dec('F0')").
- If something (like Netlab) need a function called fcnchk, you can just put the following into a file called fcnchk.m and put it somewhere Octave can find it:
function f=fcnchk(x, n) f = x; end
- The main difference is the lack of GUI for Octave. There have been many attempts to solve this issue though they are all eventually abandoned once they no longer work with new Octave versions. There is an experimental GUI as part of Octave already released, which is planned to become official with the next release.
Notes about specific functionsEdit
- For "dbstep, in" use "dbstep"; for "dbstep", use "dbnext"
- For "eig(A,B)" use "qz(A,B)"
- fputs function is not available in MATLAB. Use fprintf instead.
- page_output_immediately = 1 should this be default in --traditional?
- strread and textscan in Octave 3.4.0 are not fully compatible with their implementations in MATLAB 2009b (and probably later versions as well). For instance, the N=-1 option (repeat reading format until end of string) is not implemented in Octave 3.4.0 . Using a value of N=a positive integer (read format N times) does work the same as in MATLAB.
- textscan function is not included in Octave versions prior to 3.4.0. Use fscanf instead.
- For the linprog function, MATLAB is more permissive by allowing the "a" and "b" inputs to be either row or column vectors. Octave requires that they be column vectors.
- In Octave, one can specify data labels (or legends) with the plot function, while in MATLAB, one can only use the legend function.
Octave: plot(x, y, ';label;') MATLAB/Octave: plot(x, y); legend('label')
- The error(msg) function in MATLAB is a no-op if the message is empty. In Octave, it results in an error.