permute

Permutar dimensiones de un arreglo

Sintaxis

B = permute(A,dimorder)

Descripción

B = permute(A,dimorder) reorganiza las dimensiones de un arreglo en el orden especificado por el vector dimorder. Por ejemplo, permute(A,[2 1]) cambia las dimensiones de fila y columna de una matriz A. En general, la i-ésima dimensión del arreglo de salida es la dimensión dimorder(i) del arreglo de entrada.

Ejemplos

Arreglo 3D

Cree un arreglo de 3 por 4 por 2 y permútelo para cambiar la primera y la tercera dimensión, lo que resulta en un arreglo de 2 por 4 por 3.

rng default
A = rand(3,4,2)

A = 
A(:,:,1) =

    0.8147    0.9134    0.2785    0.9649
    0.9058    0.6324    0.5469    0.1576
    0.1270    0.0975    0.9575    0.9706


A(:,:,2) =

    0.9572    0.1419    0.7922    0.0357
    0.4854    0.4218    0.9595    0.8491
    0.8003    0.9157    0.6557    0.9340

B = permute(A,[3 2 1])

B = 
B(:,:,1) =

    0.8147    0.9134    0.2785    0.9649
    0.9572    0.1419    0.7922    0.0357


B(:,:,2) =

    0.9058    0.6324    0.5469    0.1576
    0.4854    0.4218    0.9595    0.8491


B(:,:,3) =

    0.1270    0.0975    0.9575    0.9706
    0.8003    0.9157    0.6557    0.9340

szB = size(B)

szB = 1×3

     2     4     3

Argumentos de entrada

A — Arreglo de entrada

vector | matriz | arreglo multidimensional

Arreglo de entrada, especificado como vector, matriz o arreglo multidimensional.

dimorder — Orden de las dimensiones

vector fila

Orden de las dimensiones, especificado como vector fila con elementos enteros positivos únicos que representan las dimensiones del arreglo de entrada.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

Esta función es compatible con arreglos altos, con la siguiente limitación:

No se admite permutar la dimensión alta (dimensión uno).

Para obtener más información, consulte Arreglos altos para datos con memoria insuficiente.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• dimorder debe ser un vector fila de tamaño fijo.

• Si B es un arreglo de celdas heterogéneo, dimorder debe ser una constante. Para obtener más información sobre los arreglos de celdas heterogéneos, consulte Code Generation for Cell Arrays (MATLAB Coder).

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función permute es totalmente compatible con los arreglos de GPU. Para ejecutar la función en una GPU, especifique los datos de entrada como un gpuArray (Parallel Computing Toolbox). Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2025a: Compatibilidad con la generación de código

Puede generar código C/C++ para esta función.

R2019b: Los argumentos de orden de las dimensiones no enteros o complejos generan errores

A partir de la versión R2019b, la sintaxis permute(A,dimorder) genera un error cuando dimorder es un valor no entero o complejo. En su lugar, especifique valores enteros positivos reales para dimorder.

Consulte también

ipermute | reshape | shiftdim | transpose