Pasar datos entre MATLAB y Python desde MATLAB
R2026bCuando llama a una función de Python® en MATLAB®, la interfaz de Python convierte los datos de entrada de MATLAB en tipos que representan mejor los datos en el lenguaje de Python. La interfaz de Python también convierte algunos datos devueltos de Python en tipos de datos de MATLAB.
Pasar datos de MATLAB a Python
Cuando pasa datos de MATLAB a Python, el tipo de Python resultante depende de si los datos de MATLAB son un valor escalar o un arreglo.
Pasar valores escalares de MATLAB a Python
En MATLAB, cuando pasa un valor escalar como entrada a una función de Python, la interfaz de Python convierte automáticamente los datos en el tipo de datos de Python equivalente.
Tipo de entrada de MATLAB | Tipo de datos de Python resultante | Ejemplos |
|---|---|---|
|
| Use Python Numeric Variables in MATLAB |
|
| z = complex(1,2); py.cmath.polar(z) ans =
Python tuple with values:
(2.23606797749979, 1.1071487177940904)
|
|
| |
|
|
n = NaN; py.float(n) ans =
Python float with properties:
imag: 0
real: NaN
nan |
|
|
i = Inf; py.float(i) ans =
Python float with properties:
imag: 0
real: Inf
inf
|
escalar de |
| Use Python str Variables in MATLAB |
Valor | Valor " | s = string(missing); py.str(s) ans =
Python str with no properties.
None
|
|
|
b = true; py.type(b) ans =
Python type with no properties.
<class 'bool'> |
|
| Utilizar variables dict de Python en MATLAB |
| pandas.DataFrame | Use Python Pandas DataFrames in MATLAB |
datetime |
| Use Python Datetime Types in MATLAB |
duration |
| Use Python Duration Types in MATLAB |
Objeto Python — |
| - |
Identificador de función |
| Pass Python Function to Python map Function |
Pasar datos de arreglos de MATLAB a Python
En MATLAB, cuando pasa un arreglo de MATLAB como entrada a una función de Python y el módulo NumPy está disponible en el entorno de Python, la interfaz de Python convierte automáticamente el arreglo en un arreglo de NumPy de Python. Si el módulo NumPy no está disponible al pasar un arreglo de MATLAB como entrada a una función de Python, la interfaz de Python trata la entrada de vectores como una entrada de matriz; la interfaz de Python convierte esas entradas en objetos memoryview de Python (desde la versión R2025a).
Antes de R2025a: Cuando pasa un vector de MATLAB con o sin el paquete NumPy a una función de Python, la interfaz de Python convierte el vector en un objeto array.array de Python.
Tipo de arreglo de entrada de MATLAB (solo para datos de arreglos) | Tipo de datos de Python resultante con NumPy |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
vector de |
|
vector de |
|
Vector |
|
Arreglo | Arreglo |
Arreglo | Arreglo |
Matriz | Sin conversión automática. |
Si NumPy no está instalado y se pasa un arreglo numérico de MATLAB a Python, la interfaz de Python crea un objeto memoryview que apunta al contenido del arreglo. Este objeto memoryview implementa el protocolo de buffer de Python y no realiza una copia del arreglo. En este ejemplo, array.array se construye a partir del objeto memoryview creado a partir del arreglo de MATLAB.
mArr = [1,2,3];
pyArr = py.array.array('d',mArr);
Convertir de forma explícita tipos de MATLAB en tipos de Python
Aunque la interfaz de Python no convierte automáticamente datos de cadenas multidimensionales de MATLAB, puede convertir explícitamente los datos en un tipo de datos de Python.
Tipo de MATLAB | Tipo de Python resultante | Función de conversión de MATLAB |
|---|---|---|
arreglo de cadenas | Arreglo |
Pasar datos de GPU de MATLAB a Python
Puede convertir datos de arreglos de GPU en MATLAB a tipos de datos de GPU de Python, incluyendo arreglos CuPy, cápsulas DLPack y tensores de PyTorch® (desde R2026b). Para obtener más información, consulte Pass GPU Data Between MATLAB and Python (Parallel Computing Toolbox).
Tipos de MATLAB no compatibles
Python no admite estos tipos de MATLAB:
Arreglos dispersos
Arreglos
structno escalarescategoricalcontainers.Mapobjetos MATLAB
matlab.metadata.Class(py.class)
Pasar datos de Python a MATLAB
Cuando llama a funciones de Python desde dentro de MATLAB, las funciones pueden devolver datos de cualquier tipo de datos. Dependiendo del tipo de datos devuelto por la función de Python, es posible que la interfaz de Python convierta automáticamente la salida en un tipo de datos de MATLAB. Si la interfaz de Python no convierte los datos automáticamente, la función de Python devuelve una salida de un tipo de datos de Python, que después puede convertir en un tipo de datos de MATLAB.
Devolver valores escalares de Python a MATLAB
Cuando una función de Python devuelve un valor escalar de cualquiera de estos tipos de datos de Python, la interfaz de Python convierte automáticamente el valor en estos tipos de MATLAB.
Tipo de retorno de Python, como se muestra en Python | Tipo de datos de MATLAB resultante |
|---|---|
|
|
| Complejo |
|
|
datetime |
|
Objeto | string |
Convertir de forma explícita tipos de Python en tipos de MATLAB
Cuando una función de Python devuelve cualquier otro tipo de datos, la interfaz de Python no convierte los datos automáticamente. Puede convertir de forma explícita los tipos de datos de Python en tipos de MATLAB con estas funciones de MATLAB.
Tipo de retorno o protocolo de Python, como se muestra en MATLAB | Función de conversión de MATLAB | Ejemplos |
|---|---|---|
|
| Use Python str Variables in MATLAB |
Objeto con método |
| py.help('datetime.date.__str__')Help on wrapper_descriptor in datetime.date:
datetime.date.__str__ = __str__(self, /) unbound datetime.date method
Return str(self).d = py.datetime.date(...
int32(2020),int32(3),int32(4));
char(d)ans = '2020-3-04' |
|
| Use Python Numeric Variables in MATLAB |
py.bool |
|
x = py.bool(true); double(x) ans =
1
|
|
|
b = py.bytes("MATLAB",'utf-8'); uint8(b) ans = 1×6 uint8 row vector 77 65 84 76 65 66 |
|
| Use Python Numeric Variables in MATLAB |
|
| |
|
| Use Python list Variables in MATLAB |
|
| Utilizar variables dict de Python en MATLAB |
py.pandas.DataFrame |
| Use Python Pandas DataFrames in MATLAB |
|
| Use Python Datetime Types in MATLAB |
|
| Use Python Duration Types in MATLAB |
| NaN |
pynan = py.numpy.nan pynan = NaN |
| Inf | pyinf = py.numpy.inf pyinf = Inf |
Tipos de Python no compatibles
El tipo enum de Python no se admite en MATLAB.
Pasar datos de GPU de Python a MATLAB
Puede convertir tipos de datos de GPU de Python, incluyendo arreglos CuPy, cápsulas DLPack y tensores de PyTorch, en datos de arreglos de GPU en MATLAB (desde R2026b). Para obtener más información, consulte Pass GPU Data Between MATLAB and Python (Parallel Computing Toolbox).
Convertir ndarray de Python en un arreglo de MATLAB
Si la salida de una función de Python tiene un tipo, como numpy.ndarray, que implementa el protocolo de buffer de Python, MATLAB muestra:
El tipo real de Python.
Los datos subyacentes.
La correspondiente función de conversión de MATLAB. Utilice esta función para convertir por completo el objeto de Python en un arreglo de MATLAB.
Por ejemplo, suponga que una función de Python devuelve este arreglo p:
p =
Python ndarray:
8 1 6
3 5 7
4 9 2
Use details function to view the properties of the Python object.
Use double function to convert to a MATLAB array.Convierta p en una matriz M de MATLAB utilizando la función de conversión sugerida.
M = double(p)
M = 3×3
8 1 6
3 5 7
4 9 2
Obtenga información específica acerca de las propiedades de Python de p.
details(p)
py.numpy.ndarray handle with properties:
T: [1×1 py.numpy.ndarray]
base: [1×1 py.NoneType]
ctypes: [1×1 py.numpy.core._internal._ctypes]
data: [1×3 py.memoryview]
dtype: [1×1 py.numpy.dtype[float64]]
flags: [1×1 py.numpy.flagsobj]
flat: [1×1 py.numpy.flatiter]
imag: [1×1 py.numpy.ndarray]
itemsize: [1×1 py.int]
nbytes: [1×1 py.int]
ndim: [1×1 py.int]
real: [1×1 py.numpy.ndarray]
shape: [1×2 py.tuple]
size: [1×1 py.int]
strides: [1×2 py.tuple]
Methods, Events, SuperclassesSi el módulo de Python proporciona contenido en su atributo __doc__, MATLAB enlaza a esa información.