This example shows how to sort data about patients into lists of smokers and nonsmokers in Python® and plot blood pressure readings for the patients with MATLAB®.
Start the engine, and read data about a set of patients into
a MATLAB table. MATLAB provides a sample comma-delimited
file, patients.dat
, which contains information
on 100 different patients.
import matlab.engine eng = matlab.engine.start_matlab() eng.eval("T = readtable('patients.dat');",nargout=0)
The MATLAB readtable
function reads
the data into a table. The engine does not support the MATLAB table
data type. However, with the MATLAB table2struct
function
you can convert the table to a scalar structure, which is a data type
the engine does support.
eng.eval("S = table2struct(T,'ToScalar',true);",nargout=0) eng.eval("disp(S)",nargout=0)
LastName: {100x1 cell} Gender: {100x1 cell} Age: [100x1 double] Location: {100x1 cell} Height: [100x1 double] Weight: [100x1 double] Smoker: [100x1 double] Systolic: [100x1 double] Diastolic: [100x1 double] SelfAssessedHealthStatus: {100x1 cell}
You can pass S
from the MATLAB workspace
into your Python session. The engine converts S
to
a Python dictionary, D
.
D = eng.workspace["S"]
S
has fields that contain arrays. The engine
converts cell arrays to Python list
variables,
and numeric arrays to MATLAB arrays. Therefore, D["LastName"]
is
of data type list
, and D["Age"]
is
of data type matlab.double
.
Sort blood pressure readings into lists of smokers and nonsmokers.
In patients.dat
, the column Smoker
indicated
a smoker with logical 1 (true), and a nonsmoker with a logical 0 (false).
Convert D["Smoker"]
to a matlab.logical
array
for sorting.
smoker = matlab.logical(D["Smoker"])
Convert the Diastolic
blood pressure readings
and Smoker
indicators into 1-by-100 MATLAB arrays
for sorting.
pressure = D["Diastolic"] pressure.reshape((1,100)) pressure = pressure[0] smoker.reshape((1,100)) smoker = smoker[0]
Sort the pressure
array into lists of blood pressure readings for smokers
and non-smokers. Python list comprehensions provide a compact method for iterating over sequences.
With the Python
zip
function, you can iterate over multiple sequences in a single
for
loop.
sp = [p for (p,s) in zip(pressure,smoker) if s is True] nsp = [p for (p,s) in zip(pressure,smoker) if s is False]
Display the length of sp
, the blood pressure
readings for smokers in a list
.
print(len(sp))
34
Display the length of nsp
, the list
of
readings for nonsmokers.
print(len(nsp))
66
Calculate the mean blood pressure readings for smokers and nonsmokers.
Convert sp
and nsp
to MATLAB arrays
before passing them to the MATLAB mean
function.
sp = matlab.double(sp) nsp = matlab.double(nsp) print(eng.mean(sp))
89.9117647059
Display the mean blood pressure for the nonsmokers.
print(eng.mean(nsp))
79.3787878788
Plot blood pressure readings for the smokers and nonsmokers. To define two
x-axes for plotting, call the MATLAB
linspace
function. You can plot the 34 smokers and 66 nonsmokers on
the same scatter
plot.
sdx = eng.linspace(1.0,34.0,34) nsdx = eng.linspace(1.0,34.0,66)
Show the axes boundaries with the box
function.
eng.figure(nargout=0) eng.hold("on",nargout=0) eng.box("on",nargout=0)
You must call the figure
, hold
,
and box
functions with nargout=0
,
because these functions do not return output arguments.
Plot the blood pressure readings for the smokers and nonsmokers, and label the plot. For many MATLAB functions, the engine can return a handle to a MATLAB graphics object. You can store a handle to a MATLAB object in a Python variable, but you cannot manipulate the object properties in Python. You can pass MATLAB objects as input arguments to other MATLAB functions.
eng.scatter(sdx,sp,10,'blue')
<matlab.object object at 0x22d1510>
In the rest of this example, assign the output argument of MATLAB functions
to h
as a placeholder.
h = eng.scatter(nsdx,nsp,10,'red') h = eng.xlabel("Patient (Anonymized)") h = eng.ylabel("Diastolic Blood Pressure (mm Hg)") h = eng.title("Blood Pressure Readings for All Patients") h = eng.legend("Smokers","Nonsmokers")
Draw lines showing the average blood pressure readings for smokers and nonsmokers.
x = matlab.double([0,35]) y = matlab.double([89.9,89.9]) h = eng.line(x,y,"Color","blue") h = eng.text(21.0,88.5,"89.9 (Smoker avg.)","Color","blue") y = matlab.double([79.4,79.4]) h = eng.line(x,y,"Color","red") h = eng.text(5.0,81.0,"79.4 (Nonsmoker avg.)","Color","red")