HOWTO · MATLAB
MATLAB repelem() Funktion
Man kann Kopien von Array-Elementen mit der Funktion repelem() in MATLAB wiederholen.
Auf dieser Seite
repelem erstellt ein neues Array, indem es direkt hinter jedem Eingabeelement Kopien davon einfügt. Damit können Sie einen Skalar erweitern, jedes Element gleich oft wiederholen oder für einzelne Elemente entlang einer oder mehrerer Dimensionen eigene Wiederholungszahlen festlegen. Da ein neues Array entsteht, sollten Sie dessen Größe abschätzen, bevor Sie große Wiederholungszahlen verwenden.
Syntax und Wiederholungsverhalten von repelem verstehen
Die Grundform lautet B = repelem(A,r). Bei einer skalaren Wiederholungszahl wiederholt MATLAB jedes Element von A entsprechend oft. Bei einem Vektor mit Wiederholungszahlen gilt jede Zahl für das entsprechende Element entlang der erweiterten Dimension. Der Zählvektor muss für jedes Eingabeelement entlang dieser Dimension einen Eintrag enthalten.
Bei Arrays geben Sie für jede Dimension, die Sie steuern möchten, ein Wiederholungsargument an: B = repelem(A,r1,r2,...,rN). Ein skalares Argument wiederholt jedes Element entlang der jeweiligen Dimension gleich oft; ein Zählvektor legt die Wiederholungszahl für jedes Element dieser Dimension einzeln fest. Verwenden Sie 1 für eine Dimension, deren Elemente nicht wiederholt werden sollen. Die Größe des Ergebnisses in einer Dimension entspricht der Summe ihrer Wiederholungszahlen.
Skalar- und Vektorelemente wiederholen
Bei einer skalaren Eingabe entsteht ein Vektor mit der gewünschten Anzahl an Kopien. Bei einem Vektor gilt eine skalare Wiederholungszahl einheitlich für alle Elemente; ein Zählvektor legt für jedes Element die Anzahl seiner Kopien fest. Für A = [1 2 3] wiederholt der Aufruf repelem(A,2) alle drei Werte zweimal. Der Aufruf repelem(A,[1 2 3]) belässt den ersten Wert bei einer Kopie, wiederholt den zweiten zweimal und den dritten dreimal. Die Ausgabelänge entspricht der Summe der Wiederholungszahlen.
Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
x = [1 2 3];
y = repelem(x, 2);
disp(y);
Das Ergebnis enthält von jedem Eingabewert zwei direkt aufeinanderfolgende Kopien in der ursprünglichen Reihenfolge. Dieses eigenständige Octave-Beispiel veranschaulicht denselben Vorgang mit repelem.
Arrayelemente entlang ausgewählter Dimensionen wiederholen
Bei einer Matrix beziehen sich die Wiederholungsargumente zuerst auf die Zeilen und dann auf die Spalten. Beispielsweise verdoppelt repelem(A,2,2) die Anzahl der Zeilen und Spalten, indem jedes Element in beiden Richtungen wiederholt wird. Für A = magic(2) lautet die Eingabe [1 3; 4 2]. Wird jedes Element entlang beider Dimensionen zweimal wiederholt, entstehen die Zeilen [1 1 3 3], [1 1 3 3], [4 4 2 2] und [4 4 2 2].
Mit elementweisen Wiederholungszahlen funktioniert es genauso. In repelem(A,1,[3 2]) lässt die Zeilen-Wiederholungszahl 1 jede Zeile unverändert; [3 2] wiederholt die erste und zweite Spalte drei- beziehungsweise zweimal. Das Ergebnis hat zwei Zeilen und fünf Spalten. Bei einer 2-mal-2-Matrix ergibt repelem(A,[2 1],[3 2]) drei Zeilen und fünf Spalten: Die erste Eingabezeile wird zweimal wiederholt, die zweite einmal, und die Spalten werden entsprechend ihren Wiederholungszahlen erweitert.
Tabellenwerte wiederholen
repelem wird hier für skalare und Array-Eingaben beschrieben. Wenn Ihre Daten in einer MATLAB-Tabelle liegen, wählen Sie die Variable aus, deren Werte Sie wiederholen möchten, und wenden Sie repelem auf diese Variable an. Beispielsweise bedeutet repelem(T.Age,2), jeden Wert der Variable Age zweimal zu wiederholen. Dabei werden die Werte der Variable verarbeitet; daraus folgt nicht, dass repelem Tabellenspalten dupliziert oder eine größere Tabelle erstellt. Prüfen Sie das Verhalten in der von Ihnen verwendeten MATLAB-Version und Ihrem Tabellen-Workflow, bevor Sie sich auf eine Erweiterung auf Tabellenebene verlassen.
Ausgabegröße und Speicherbedarf prüfen
Berechnen Sie die Ausgabedimensionen, bevor Sie eine große Erweiterung ausführen. Bei elementweisen Wiederholungszahlen addieren Sie die Zahlen für jede erweiterte Dimension; bei einer einheitlichen Wiederholungszahl multiplizieren Sie die Größe dieser Dimension mit der Zahl. Die Gesamtzahl der Ausgabeelemente ist das Produkt der resultierenden Dimensionen. Der Datentyp des Arrays bestimmt, wie viel Speicher diese Elemente benötigen. Ein großes Ergebnis kann erheblich mehr Speicher als die Eingabe beanspruchen und den verfügbaren Speicher überschreiten. Verringern Sie die Wiederholungszahlen oder verarbeiten Sie die Daten in kleineren Abschnitten, wenn Sie nicht das gesamte erweiterte Array benötigen.