Die Übersetzung dieser Seite ist veraltet. Klicken Sie hier, um die neueste Version auf Englisch zu sehen.

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

Dreidimensionales Array

Erstellen Sie ein 3x4x2-Array und permutieren Sie es, 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:

• Dimensionsreihenfolge muss zur Kompilierungszeit für heterogene Zellenarray-Eingaben konstant sein. Weitere Informationen finden Sie unter Code Generation for Cell Arrays (MATLAB Coder).

• Siehe Incompatibility with MATLAB for Default Dimension Selection (MATLAB Coder).

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.

Diese Funktion 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™.

Diese Funktion 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

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