Permute Matrix
Reorder matrix rows or columns
Libraries:
Simulink /
Matrix Operations
Description
The Permute Matrix block reorders the rows or columns of an
M-by-N input matrix A
as
specified by indexing input P
.
Examples
Ports
Input
A — Input matrix
scalar | vector | matrix
Input matrix, specified as a scalar, vector, or matrix.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| Boolean
| fixed point
| enumerated
P — Index matrix
scalar | vector
Index matrix, specified as a scalar or vector.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| Boolean
| enumerated
Output
Port_1 — Output signal
vector | matrix
Output signal, specified as a vector or matrix.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| Boolean
| fixed point
| enumerated
Parameters
Permute — Permute method
Columns
(default) | Rows
Method of constructing the output matrix by permuting rows or columns of the input.
When the Permute parameter is set to:
Rows
–– The block uses the rows ofA
to create a matrix that has the same column dimension. InputP
is a length-L vector whose elements determine where each row fromA
must be placed in the L-by-N output matrix.y = [A(P(1),:) ; A(P(2),:) ; A(P(3),:) ; ... ; A(P(end),:)] % Equivalent MATLAB code
For row permutation, the block treats the length-M unoriented vector input at the port
A
as an M-by-1 matrix.Columns
–– The block uses the columns ofA
to create a matrix that has the same row dimension. InputP
is a length-L vector whose elements determine where each column fromA
must be placed in the M-by-L output matrix.% Equivalent MATLAB code y = [A(:,P(1)) A(:,P(2)) A(:,P(3)) ... A(:,P(end))]
For column permutation, the block treats the length-N unoriented vector input at port
A
as a 1-by-N matrix.
Programmatic Use
Block Parameter:
mode |
Type: character vector, string |
Values:'
Columns' | 'Rows' |
Default: '
Columns' |
Index mode — Index mode
One-based
(default) | Zero-based
When set to One-based
, a value of
1
in the permutation vector P
refers to the first row or column of the input matrix A
.
When set to Zero-based
, a value of
0
in P
refers to the first row or
column of A
.
Programmatic Use
Block Parameter:
ZeroOneIdxMode |
Type: character vector, string |
Values:'
Zero-based' | 'One-based' |
Default:
'One-based' |
Invalid permutation index — Response to an invalid index value
Clip index
(default) | Clip and warn
| Generate error
Response to an invalid index value. When an index value in input
P
references a nonexistent row or column of matrix
A
, the block reacts as specified in this parameter.
These options are available:
Clip index
–– Clip the index to the nearest valid value (1 or M for row permutation and 1 or N for column permutation) and do not issue an alert. Example: For a 3-by-7 input matrix, a column index of 9 is clipped to 7 and a row index of -2 is clipped to 1.Clip and warn
–– Display a warning message in the MATLAB® Command Window and clip the index as described in the preceding bullet.Generate error
–– Display an error dialog box and terminate the simulation.
Tunable: Yes
Programmatic Use
Block Parameter:
errmode |
Type: character vector, string |
Values: 'Clip
index' | 'Clip and warn' |
'Generate error' |
Default: 'Clip
index' |
Error when length of P is not equal to Permute dimension size — Error message for P length
off
(default) | on
Option to display an error dialog box and terminate the simulation when
the length of the permutation vector P
is not equal to
the number of rows or columns of the input matrix
A
.
You can choose to open an error dialog box and terminate the simulation by
setting this parameter to on
.
Programmatic Use
Block Parameter:
checkDims |
Type: character vector, string |
Values:
'off' | 'on' |
Default:
'off' |
Block Characteristics
Data Types |
|
Direct Feedthrough |
|
Multidimensional Signals |
|
Variable-Size Signals |
|
Zero-Crossing Detection |
|
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
Generated code relies on the memcpy
or
memset
function (string.h
) under certain
conditions.
Fixed-Point Conversion
Design and simulate fixed-point systems using Fixed-Point Designer™.
Version History
Introduced before R2006aR2021b: Create Permute Matrix Block Moved to Simulink Matrix Operations Library
The Permute Matrix block has been moved from the DSP System Toolbox > Math Functions > Matrices and Linear Algebra > Matrix Operations library to the Simulink > Matrix Operationslibrary. All existing models continue to work.
See Also
Blocks
- Submatrix | Variable Selector (DSP System Toolbox)
Functions
Topics
- Reorder Channels in Multichannel Signals (DSP System Toolbox)
Comando MATLAB
Hai fatto clic su un collegamento che corrisponde a questo comando MATLAB:
Esegui il comando inserendolo nella finestra di comando MATLAB. I browser web non supportano i comandi MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)