Reshape

Change dimensionality of signal

Libraries:
Simulink / Math Operations
HDL Coder / Math Operations

Description

The Reshape block changes the dimensionality of the input signal to a dimensionality that you specify, using the Output dimensionality parameter. For example, you can use the block to change an N-element vector to a 1-by-N or N-by-1 matrix signal.

Ports

Input

expand all

Port_1 — Input signal
scalar | vector | matrix

Input signal whose dimensions are changed based on the Output dimensionality parameter.

Output

expand all

Port_1 — Output signal
scalar | vector | matrix

Output signal created with the dimensions specified in the Output dimensionality parameter.

Parameters

expand all

Output dimensionality — Dimensions of output signal
`1-D array` (default) | `Column vector (2-D)` | `Row vector (2-D)` | `Customize` | `Derive from reference input port`

Specify the dimensionality of the output signal.

Output Dimensionality	Description
1-D array	Converts a multidimensional array to a vector (1-D array) array signal. The output vector consists of the first column of the input matrix followed by the second column, and so on. (This option leaves a vector input unchanged.)
Column vector	Converts a vector, matrix, or multidimensional input signal to a column matrix, a M-by-1 matrix, where M is the number of elements in the input signal. For matrices, the conversion is done in column-major order. For multidimensional arrays, the conversion is done along the first dimension.
Row vector	Converts a vector, matrix, or multidimensional input signal to a row matrix, a 1-by-N matrix where N is the number of elements in the input signal. For matrices, the conversion is done in column-major order. For multidimensional arrays, the conversion is done along the first dimension.
Customize	Converts the input signal to an output signal whose dimensions you specify, using the Output dimensions parameter. This option does not support variable-size input signals.
Derive from reference input port	Creates a second input port, Ref, on the block. Derives the dimensions of the output signal from the dimensions of the signal input to the Ref input port. Selecting this option disables the Output dimensions parameter. When you select this parameter, the input signals for both inport ports, U and Ref, must have the same sampling mode (sample-based or frame-based). This option does not support variable-size input signals.

Programmatic Use

Block Parameter: OutputDimensionality

Type: character vector

Value: '1-D array' | 'Column vector (2-D)' |

'Row vector
									(2-D)'

| 'Customize' | 'Derive from reference input port'

Default:

'1-D
									array'

Output dimensions — Custom dimensions of output signal
`[1,1]` (default) | `[integer]` | `[integer,integer]`

Specify the dimensions for the output signal. The value can be a one- or multi-element vector. A value of [N] outputs a vector of size N. A value of [M N] outputs an M-by-N matrix. The number of elements of the input signal must match the number of elements specified by the Output dimensions parameter. For multidimensional arrays, the conversion is done along the first dimension.

Dependency

To enable this parameter, set Output dimensionality to Customize.

Programmatic Use

Block Parameter: OutputDimensions

Type: character vector

Value: '[1,1]' | 'integer' | '[integer,integer]'

Default: '[1,1]'

Block Characteristics

Data Types	`Boolean` \| `bus` \| `double` \| `enumerated` \| `fixed point` \| `half` \| `integer` \| `single`
Direct Feedthrough	`yes`
Multidimensional Signals	`yes`
Variable-Size Signals	`yes`
Zero-Crossing Detection	`no`

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

HDL Code Generation
Generate VHDL, Verilog and SystemVerilog code for FPGA and ASIC designs using HDL Coder™.

HDL Coder™ provides additional configuration options that affect HDL implementation and synthesized logic.

HDL Architecture

This block has one default HDL architecture.

HDL Block Properties

ConstrainedOutputPipeline	Number of registers to place at the outputs by moving existing delays within your design. Distributed pipelining does not redistribute these registers. The default is `0`. For more details, see ConstrainedOutputPipeline (HDL Coder).
InputPipeline	Number of input pipeline stages to insert in the generated code. Distributed pipelining and constrained output pipelining can move these registers. The default is `0`. For more details, see InputPipeline (HDL Coder).
OutputPipeline	Number of output pipeline stages to insert in the generated code. Distributed pipelining and constrained output pipelining can move these registers. The default is `0`. For more details, see OutputPipeline (HDL Coder).

Complex Data Support

This block supports code generation for complex signals.

FOR-GENERATE Loop Support

For this block, HDL Coder generates code using FOR-GENERATE loop.

The loop unrolled code is generated when target language is Verilog^®. For more information, see Unroll For-Generate Loops (HDL Coder)

PLC Code Generation
Generate Structured Text code using Simulink® PLC Coder™.

Fixed-Point Conversion
Design and simulate fixed-point systems using Fixed-Point Designer™.

Version History

Introduced before R2006a

Reshape

Description

Ports

Input

Port_1 — Input signal
scalar | vector | matrix

Output

Port_1 — Output signal
scalar | vector | matrix

Parameters

Output dimensionality — Dimensions of output signal
`1-D array` (default) | `Column vector (2-D)` | `Row vector (2-D)` | `Customize` | `Derive from reference input port`

Programmatic Use

Output dimensions — Custom dimensions of output signal
`[1,1]` (default) | `[integer]` | `[integer,integer]`

Dependency

Programmatic Use

Block Characteristics

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

HDL Code Generation
Generate VHDL, Verilog and SystemVerilog code for FPGA and ASIC designs using HDL Coder™.

PLC Code Generation
Generate Structured Text code using Simulink® PLC Coder™.

Fixed-Point Conversion
Design and simulate fixed-point systems using Fixed-Point Designer™.

Version History

See Also

Topics

Reshape

Description

Ports

Input

Port_1 — Input signal scalar | vector | matrix

Output

Port_1 — Output signal scalar | vector | matrix

Parameters

Output dimensionality — Dimensions of output signal 1-D array (default) | Column vector (2-D) | Row vector (2-D) | Customize | Derive from reference input port

Programmatic Use

Output dimensions — Custom dimensions of output signal [1,1] (default) | [integer] | [integer,integer]

Dependency

Programmatic Use

Block Characteristics

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using Simulink® Coder™.

HDL Code Generation Generate VHDL, Verilog and SystemVerilog code for FPGA and ASIC designs using HDL Coder™.

PLC Code Generation Generate Structured Text code using Simulink® PLC Coder™.

Fixed-Point Conversion Design and simulate fixed-point systems using Fixed-Point Designer™.

Version History

See Also

Topics

Port_1 — Input signal
scalar | vector | matrix

Port_1 — Output signal
scalar | vector | matrix

Output dimensionality — Dimensions of output signal
`1-D array` (default) | `Column vector (2-D)` | `Row vector (2-D)` | `Customize` | `Derive from reference input port`

Output dimensions — Custom dimensions of output signal
`[1,1]` (default) | `[integer]` | `[integer,integer]`

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

HDL Code Generation
Generate VHDL, Verilog and SystemVerilog code for FPGA and ASIC designs using HDL Coder™.

PLC Code Generation
Generate Structured Text code using Simulink® PLC Coder™.

Fixed-Point Conversion
Design and simulate fixed-point systems using Fixed-Point Designer™.