Contenido principal

Pasar datos entre MATLAB y Python desde MATLAB

R2026b

Cuando 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
(solo para valores escalares)

Tipo de datos de Python resultante

Ejemplos

double (real)
single (real)

float (predeterminado) o int

Use Python Numeric Variables in MATLAB

De forma predeterminada, la interfaz de Python convierte el tipo double o single en float de Python. No obstante, para valores enteros basados en sugerencias de tipos de Python, la interfaz de Python puede convertir el tipo double o single en int de Python.

double (complejo)
single (complejo)

complex

z = complex(1,2);
py.cmath.polar(z)
ans = 
  Python tuple with values:

    (2.23606797749979, 1.1071487177940904)

int8
uint8
int16
uint16
int32
uint32
int64
uint64

int

Use Python Numeric Variables in MATLAB

NaN

float("nan")

n = NaN;
py.float(n)
ans = 

  Python float with properties:

    imag: 0
    real: NaN

    nan

Inf

float("inf")

i = Inf;
py.float(i)
ans = 

  Python float with properties:

    imag: 0
    real: Inf

    inf

escalar de string vector de
char

str

Use Python str Variables in MATLAB

Valor <missing> en string
string(missing)

Valor "None" en str

s = string(missing);
py.str(s)
ans = 

  Python str with no properties.

    None

logical

bool

b = true;
py.type(b)
ans = 

  Python type with no properties.

    <class 'bool'>

dictionary
struct

dict

Utilizar variables dict de Python en MATLAB

table
timetable

pandas.DataFrameUse Python Pandas DataFrames in MATLAB
datetime

datetime.datetime

Use Python Datetime Types in MATLAB
duration

datetime.timedelta

Use Python Duration Types in MATLAB

Objeto Python — py.type

type

-

Identificador de función @py.module.function, solo para funciones de Python

module.function

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

double (real)

numpy.array(dtype=np.float64)

single (real)

numpy.array(dtype=np.float32)

int8 (real)

numpy.array(dtype=np.int8)

uint8 (real)

numpy.array(dtype=np.uint8)

int16 (real)

numpy.array(dtype=np.int16)

uint16 (real)

numpy.array(dtype=np.uint16)

int32 (real)

numpy.array(dtype=np.int32)

uint32 (real)

numpy.array(dtype=np.uint32)

int64 (real)

numpy.array(dtype=np.int64)

uint64 (real)

numpy.array(dtype=np.uint64)

double (complejo)

numpy.array(dtype=np.complex128)

single (complejo)

numpy.array(dtype=np.complex64)

logical

numpy.array(dtype=np.bool)

vector de char

str

vector de cell

tuple

Vector string de 1 por N o M por 1

list

Arreglo datetime

Arreglo numpy.datetime64

Arreglo duration

Arreglo numpy.timedelta64

Matriz char
Matriz cell
Arreglo string de M por N donde M y N son mayores que 1

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 StringDType de NumPy

pystringarray

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 struct no escalares

  • categorical

  • containers.Map

  • objetos 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
(solo para valores escalares)

float

double

complex

Complejo double

bool

logical

datetime

datetime

Objeto str en pandas.DataFrame
Objeto str en dict

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

py.str

string
char

Use Python str Variables in MATLAB

Objeto con método __str__

char

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'

py.int
py.long
py.float

double
single
int8
uint8
int16
uint16
int32
uint32
int64
uint64

Use Python Numeric Variables in MATLAB
py.bool

logical
double
single
int8
uint8
int16
uint16
int32
uint32
int64
uint64

x = py.bool(true);
double(x)
ans =

     1

py.bytes

uint8

b = py.bytes("MATLAB",'utf-8');
uint8(b)
ans =

  1×6 uint8 row vector

   77   65   84   76   65   66

py.array.array
py.memoryview

double
single
int8
uint8
int16
uint16
int32
uint32
int64
uint64

Use Python Numeric Variables in MATLAB

py.numpy.ndarray

double
single
int8
uint8
int16
uint16
int32
uint32
int64
uint64
string

Convertir ndarray de Python en un arreglo de MATLAB

py.list
py.tuple

double
single
int8
uint8
int16
uint16
int32
uint32
int64
uint64
logical
string
cell

Use Python list Variables in MATLAB
Use Python tuple Variables in MATLAB

Para obtener más información, consulte Error Converting Elements of list or tuple.

py.dict y otros objetos que implementan el protocolo de asignación

dictionary
struct

Utilizar variables dict de Python en MATLAB
py.pandas.DataFrame

table
timetable

Use Python Pandas DataFrames in MATLAB

py.datetime.datetime
py.numpy.datetime64

datetime

Use Python Datetime Types in MATLAB

py.datetime.timedelta
py.numpy.timedelta64

duration

Use Python Duration Types in MATLAB

py.numpy.nan

NaN

pynan = py.numpy.nan
pynan =

  NaN

py.numpy.inf

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, Superclasses

Si el módulo de Python proporciona contenido en su atributo __doc__, MATLAB enlaza a esa información.

Consulte también

Temas