Call Python from MATLAB

Directly call Python^® functionality from MATLAB^®

You can access Python libraries directly from MATLAB by adding the py. prefix to the Python name. See Access Python Modules from MATLAB - Getting Started. For example:

py.list({'This','is a','list'})      % Call built-in function list
py.textwrap.wrap('This is a string') % Call wrap function in module textwrap

You can execute Python statements in the Python interpreter directly from MATLAB using the pyrun or pyrunfile functions. For example:

pyrun("l = ['A','new','list']")  % Call list in Python interpreter

If instead you want to call MATLAB functions from Python applications, see Call MATLAB from Python for more information.

Functions

`pyenv`	Change default environment of Python interpreter
`PythonEnvironment`	Python environment information

`pyrun`	Run Python statements from MATLAB (Since R2021b)
`pyrunfile`	Run Python script file from MATLAB (Since R2021b)

pyargs Create keyword arguments for Python function

matlab.exception.PyException Capture error information for Python exception

Run Python statements or script files in the Live Editor (Since R2024a)

Access Python Modules from MATLAB - Getting Started
How to create and use a Python object in MATLAB.
Configure Your System to Use Python
How to verify you have installed a supported version of Python.
Call User-Defined Python Module
Create a Python module used by examples in this documentation.
Understand Python Function Arguments
Python method syntax which might be unfamiliar to MATLAB users.
Advanced Topics
Code pattern differences you should be aware of.
Out-of-Process Execution of Python Functionality
Execute Python scripts in processes that are separate from the MATLAB process.
Reload Out-of-Process Python Interpreter
Reload out-of-process Python interpreter without restarting MATLAB.

Directly Call Python Functionality from MATLAB
Ways to call Python from MATLAB.

Pass MATLAB Data to Python
How MATLAB converts MATLAB data into compatible Python data types.
Handle Data Returned from Python Function
MATLAB automatically converts these data types returned from Python functions to MATLAB types.
Access Elements in Python Container Types
A Python container is typically a sequence type (list or tuple) or a mapping type (dict).
Use MATLAB datetime Types with Python
MATLAB supports conversions between MATLAB datetime values and Python datetime or NumPy datetime64 values.
Use MATLAB duration Types with Python
MATLAB supports conversions between MATLAB duration values and Python timedelta or NumPy timedelta64 values.
Pass Python Function to Python map Function
This example shows how to display the length of each word in a list.