Good for:
Why Matlab:
Recommended setups:
You can install Octave on MacOS, Linux or Windows. It can be run as a GUI (looks kind of similar to Matlab) or directly from the command line.
Best resource to learn quickly:
Matlab On-Ramp (create free account with illinois.edu email)
Toolboxes are loaded with the Matlab Installer, and have to be loaded before you launch Matlab. If you use the UIUC Virtual client (the one over Citrix), all the available toolboxes should be loaded for you. If you install your own version, you should be able to select at install which toolboxes to install. The default student version should install all toolboxes that comes with the installer.
In Octave, additional functionality is achieved through the download and installation of Packages. Then, at each time you start Octave, you need to load the package much like a library in R or Python.
# To install a package for Octave, download the package image to your computer.
# Then run:
pkg install pkgname-1.0.0.tar.gz;
# after the package installs, you use it as:
pkg load pkgname;
How to use functions from other files
# to access a function from another script located in the same folder,
# simply treat the name of the script like a function.
# Note: Only the first (outermost) function will be called from another script
# multiple functions can be defined in the other script, but they can't be accessed directly
# from another script. Look at the other_script.m file to understand this.
# You'll also get a warning the first time if the top function doesn't match the filename,
# but it will still run the first function no matter what it's called.
# In this example, other_script.m has two functions:
# other_function(a,b) and helper(n).
# other_function(a,b) calls function helper(n) to print out whatever 'a' was,
# then returns a + (b/2).
# This is what happens when we call other_script like a function:
res = other_script(2,4)
# Note you can call it again too.
res2 = other_script(1,8)
How to import data into Matlab. Very useful for previewing and processing all kinds of information.
# For well organized, purely numerical data (NO TEXT), you have two choices.
# For csv files containing numbers only, you can use csvread()
#csvdata = csvread('Path/to/file.csv', delimiter, rows, columns)
# If you have saved a variable/matrix to a .mat file, you can read it into Matlab with the load() function:
#matlab_data = load('path/to/mat/file.mat');
# if you are okay reading in without interpretation of data headers, just call import data on the file.
data2 = importdata('data/ExampleDataClean2.csv');
data2(1:10)
# to read into a table/matrix with column labels, use
#data = readtable('data/ExampleDataClean2.csv')
# For Octave, reading in the importdata() with headers allows Octave to determine numerical data from text.
# for this reason, it dumps the data in a struct which you can unpack as follows:
# if you have dirty data (not all numeric, unequal rows/columns), read in your data with importdata()
# the second parameter is the delimeter (CSV uses commas, TSV uses \t [tab], and still others use semicolons)
data = importdata('data/ExampleDataClean2.csv', ',', 1);
typeinfo(data)
all_fields = fieldnames(data)
data.textdata(1:10)
data.data(1:10)
How to read in data from an excel data file
# In Octave, the Matlab 'table' datatype is not implemented.
# This means mixed data (ie, text and numbers) takes a bit more effort to work with.
# An example is shown below that highlights how you
pkg load io
pkg load dataframe
# in Matlab, you should use readtable() or readcell(). Although xlsread will still work as of 2020.
A = xlsread('data/ExampleDataClean.xlsx');
typeinfo(A)
B = datestr(A(:,1), f=2);
C = [num2cell(B, 2), num2cell(A(:,2:end))];
D = dataframe(C);
A(1:5,:) # data read in. If it can be converted to number it is. If only text, it shows up as NaN.
B(1:5,:) # first column converted to date strings.
C(1:5,:) # to blend text and numerical data, use a cell array. each cell can hold different types of data
D(1:5,:) # there's also a dataframe in Octave, which is the closest thing currently to a Matlab table.
How to generate a basic data plot
# To plot data, use the plot() function.
# we'll demonstrate by plotting from a csv file.
pkg load io
A = xlsread('data/ExampleDataClean.xlsx');
# plot the third and fourth columns as time series
# first, generate the 'x' values. Our data are columns,
# so we need to match the dimensions, hence the transpose
x = transpose(linspace(1, 60, size(A, 1)));
# Now we plot the third and fourth columns.
# The third column will be a blue line, and the second red stars.
plot(x, A(:,3), 'b-', x, A(:,4), 'r*')
A fully functional code snippet that may be useful.
# here is a function for reading in WFDB format files from physionet (raw EMG data, for example)
function [times, data] = readWFDB(filename)
fid = fopen(filename);
% get HEA info like offset, format, frequency, gain
offset = 20;
gain = 500;
sample_frequency = 23437.5;
precision = "int16";
format = 'l'; % little endian
data = fread(fid, Inf, precision, 0, format);
data = data([offset:end],:);
data(:,1) = data(:,1) ./ gain;
len = size(data,1);
times = linspace(0, len -1, len)';
times = times./sample_frequency;
fclose(fid);
end