Expand Scalar
Libraries:
Simulink /
Matrix Operations
Description
The Expand Scalar block outputs a scalar-expanded matrix where each element in the matrix has the same value.
Ports
Output
Scalar-expanded matrix, returned as a scalar, vector, or matrix.
Data Types: single
| double
| half
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| bus
| Boolean
| fixed point
Parameters
To edit block parameters interactively, use the Property Inspector. From the Simulink® Toolstrip, on the Simulation tab, in the Prepare gallery, select Property Inspector.
Specify the matrix element value as a scalar for the expanded matrix. Element value
can be a struct
.
Tunable: Yes
Programmatic Use
To set the block parameter value programmatically, use
the set_param
function.
To get the block parameter value
programmatically, use the get_param
function.
Parameter: | ElementValue |
Values: | 1 (default) | scalar |
Data Types: | char |
Specify the dimension of output matrix as a scalar or vector.
A positive integer scalar creates an unoriented vector.
A 2-D vector creates an oriented vector.
Programmatic Use
To set the block parameter value programmatically, use
the set_param
function.
To get the block parameter value
programmatically, use the get_param
function.
Parameter: | OutputDimensions |
Values: | '5' (default) | scalar | two-element vector |
Data Types: | char |
Specify the output data type for this block. You can select one of these options:
A rule that inherits a data type, for example,
Inherit: Inherit via back propagation
. When you select this option, the output data type and scaling matches that of the next downstream block.A built-in data type, such as
double
.An expression that evaluates to a valid data type, for example,
fixdt(1,16)
.
For help setting data type parameters, display the Data Type
Assistant by clicking the Show data type assistant
button .
See Control Data Types of Signals for more information.
Programmatic Use
To set the block parameter value programmatically, use
the set_param
function.
To get the block parameter value
programmatically, use the get_param
function.
Parameter: | OutDataTypeStr |
Values: | 'double' (default) | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | int64 | uint64 | boolean | fixdt(1,16,0) | Inherit: Inherit via back propagation | <data type expression> |
Data Types: | char |
Select how you would like to specify the data type properties of the Output data type.
Inherit
— Specify a rule for inheriting a data type, for example,Inherit: Same as input
.Built in
— Specify a built-in data type, for example,double
.Fixed point
— Specify the fixed-point attributes of the data type.Expression
— Specify an expression that evaluates to a valid data type, for example,fixdt(1,16)
.
For more information, see Specify Data Types Using Data Type Assistant.
Specify whether the fixed-point data is signed or unsigned.
Signed
data can represent positive and negative values.
Unsigned
data represents positive values only. For more
information, see Specify Data Types Using Data Type Assistant.
Specify the method for scaling fixed-point data to avoid overflow conditions and minimize quantization errors. For more information, see Specify Data Types Using Data Type Assistant.
Dependencies
To enable this parameter, set Mode to Fixed
point
.
Specify the bit size of the word that holds the quantized integer as a positive integer from 2 to 65,535. For more information, see Specify Data Types Using Data Type Assistant.
Dependencies
To enable this parameter, set Mode to Fixed
point
.
Specify the fraction length of the fixed-point data type as a positive or negative integer scalar.
Dependencies
To enable this parameter, set Mode to Fixed
point
and Scaling to Binary
point
.
Select the data type override mode for this signal. You can select:
Inherit
— Inherits the data type override setting specified for the model.Off
— Ignores the data type override setting specified for the model and uses the fixed-point data type you specify.
Dependencies
To enable this parameter, set Mode to Built
in
or Fixed point
. For more information,
see Specify Data Types Using Data Type Assistant.
Specify the discrete sample period of the output as a real-valued scalar.
Dependencies
To enable this parameter, clear the Inherit output port attributes from input port check box.
Programmatic Use
To set the block parameter value programmatically, use
the set_param
function.
To get the block parameter value
programmatically, use the get_param
function.
Parameter: | SampleTime |
Values: | '1' (default) | scalar |
Data Types: | char |
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™.
Version History
Introduced in R2024aThe Expand Scalar block now supports MATLAB®
struct
expansion with a Simulink bus data type.
See Also
Blocks
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
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)