permute

Permutieren von Array-Dimensionen

Syntax

B = permute(A,dimorder)

Beschreibung

B = permute(A,dimorder) ordnet die Dimensionen eines Arrays in der vom Vektor dimorder angegebenen Reihenfolge neu an. Beispielsweise werden mit permute(A,[2 1]) die Zeilen- und Spaltendimensionen einer Matrix A vertauscht. Im Allgemeinen ist die i. Dimension des Ausgabearrays die Dimension dimorder(i) aus dem Eingabearray.

Beispiele

Permutation einer 2D-Matrix

Erstellen Sie eine 4x3-Matrix. Permutieren Sie diese Matrix, um die Zeilen- und Spaltendimensionen zu vertauschen.

A = [1 2 3; 4 5 6; 7 8 9; 10 11 12]

A = 4×3

     1     2     3
     4     5     6
     7     8     9
    10    11    12

B = permute(A,[2 1])

B = 3×4

     1     4     7    10
     2     5     8    11
     3     6     9    12

Permutation eines 3D-Arrays

Erstellen Sie ein 3x4x2-Array. Permutieren Sie dieses Array, sodass die erste und die dritte Dimension vertauscht werden und ein 2x4x3-Array entsteht.

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

Eingabeargumente

A — Input Array

Vektor | Matrix | mehrdimensionales Array

Input Array, angegeben als Vektor, Matrix oder mehrdimensionales Array.

dimorder — Dimensionsreihenfolge

Zeilenvektor

Dimensionsreihenfolge, angegeben als Zeilenvektor mit eindeutigen, positiven ganzzahligen Elementen, die die Dimensionen des Input Array darstellen.

Erweiterte Fähigkeiten

Tall Arrays

Rechnen mit Arrays, die mehr Zeilen haben, als in den Speicher passen.

Diese Funktion unterstützt Tall-Arrays mit folgender Einschränkung:

Die Permutation der Tall-Dimension (Dimension eins) wird nicht unterstützt.

Weitere Informationen finden Sie unter Tall Arrays for Out-of-Memory Data.

C/C++ Codegenerierung

Generieren Sie C und C++ Code mit MATLAB® Coder™.

Hinweise zur Verwendung und Einschränkungen:

• dimorder muss ein Zeilenvektor fester Größe sein.

• Wenn B ein heterogenes Zellenarray ist, muss dimorder eine Konstante sein. Weitere Informationen über heterogene Zellenarrays finden Sie unter Code Generation for Cell Arrays (MATLAB Coder).

GPU-Codegenerierung

Generieren von CUDA® Code für NVIDIA® Grafikprozessoren mit dem GPU Coder™.

Siehe die Verwendungshinweise und Einschränkungen im Abschnitt zur C/C++ Codegenerierung. Dieselben Verwendungshinweise und Einschränkungen gelten auch für die Grafikkarten-Codegenerierung.

Thread-Based Environment

Führen Sie mithilfe von MATLAB® backgroundPool den Code im Hintergrund aus oder machen Sie den Code mit der Parallel Computing Toolbox™ ThreadPool schneller.

Die Funktion permute bietet vollständige Unterstützung für Thread-basierte Umgebungen. Weitere Informationen finden Sie unter Run MATLAB Functions in Thread-Based Environment.

GPU-Arrays

Schnellere Codeausführung durch Ausführen auf einer Grafikkarte (GPU) mit der Parallel Computing Toolbox™.

Die Funktion permute bietet vollständige Unterstützung für Grafikkarten-Arrays. Zum Ausführen der Funktion auf einer Grafikkarte geben Sie die Eingabedaten als gpuArray (Parallel Computing Toolbox) an. Weitere Informationen finden Sie unter Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Verteilte Arrays

Partitionieren von großen Arrays über den kombinierten Speicher Ihres Clusters mit Parallel Computing Toolbox™.

Die Funktion permute bietet vollständige Unterstützung für verteilte Arrays. Weitere Informationen finden Sie unter Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Versionsverlauf

Eingeführt vor R2006a

R2025a: Unterstützung für Codegenerierung

Sie können C/C++ Code für diese Funktion generieren.

R2019b: Nicht ganzzahlige oder komplexe Argumente für die Dimensionsreihenfolge führen zu einem Fehler

In Releases ab R2019b führt die Syntax permute(A,dimorder) zu einem Fehler, wenn dimorder ein nicht ganzzahliger oder komplexer Wert ist. Geben Sie stattdessen reelle, positive ganzzahlige Werte für dimorder an.

Siehe auch

ipermute | reshape | shiftdim | transpose