Array-Vector Multiply

Multiply array by vector along specified dimension

Libraries:
DSP System Toolbox / Math Functions / Matrices and Linear Algebra / Matrix Operations

Description

The Array-Vector Multiply block multiplies the values in the specified dimension of the N-dimensional input array A by the values in the input vector V.

The length of the input V must be the same as the length of the specified dimension of A. The Array-Vector Multiply block multiplies each element of V by the corresponding element along that dimension of A.

Consider a 3-dimensional M-by-N-by-P input array A(i,j,k) and an N-by-1 input vector V. When the Multiply along dimension parameter is set to `2`, the output of the block Y(i,j,k) is

`$Y\left(i,j,k\right)=A\left(i,j,k\right)*V\left(j\right)$`

where

`$\begin{array}{l}1\le i\le M\\ 1\le j\le N\\ 1\le k\le P\end{array}$`

The output of the Array-Vector Multiply block is the same size as the input array A. This block accepts real and complex floating-point and fixed-point inputs.

Ports

Input

expand all

Specify the array input as a vector or a matrix.

If the input is fixed point, it must be a signed integer or a signed fixed point value with a power-of-two slope and zero bias.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `uint8` | `uint16` | `uint32` | `fixed point`
Complex Number Support: Yes

Specify the vector input as a vector.

Dependencies

This port appears only when you set the Vector (V) source parameter to `Input port`.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `uint8` | `uint16` | `uint32` | `fixed point`
Complex Number Support: Yes

Output

expand all

Output of the Array-Vector Multiply block, returned as a vector or a matrix.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `uint8` | `uint16` | `uint32` | `fixed point`
Complex Number Support: Yes

Parameters

expand all

Main Tab

Specify the dimension along which to multiply the input array A by the elements of vector V as a positive integer.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64`

Set the source of the vector V to one of these options.

• `Input port` — Vector comes from the input port.

• `Dialog parameter` — Vector comes from the dialog parameter Vector (V).

Specify the vector V.

Dependencies

This parameter appears only when you set the Vector (V) source parameter to `Dialog parameter`.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `uint8` | `uint16` | `uint32` | `fixed point`
Complex Number Support: Yes

Data Types Tab

Note

Floating-point inheritance takes precedence over the data type settings defined on the Data Types tab. When inputs are floating point, the block ignores these settings and all internal data types are floating point.

Set the rounding mode for fixed-point operations to one of these options.

• `Ceiling`

• `Convergent`

• `Floor`

• `Nearest`

• `Round`

• `Simplest`

• `Zero`

For details, see rounding mode.

When you select this parameter, the block saturates the result of its fixed-point operations. When you clear this parameter, the block wraps the result of its fixed-point operations. For details on `saturate` and `wrap`, see overflow mode for fixed-point operations.

Use this parameter to specify the word and fraction lengths for the elements of the vector, V. Select this parameter as one of these options.

• `Inherit: Same word length as input` — Inherits the data type so it is the same as that of the input array A.

• `fixdt(1,16,0)` — Specifies a signed, binary-point, scaled, fixed-point data type with a word length of 16 bits and a fraction length of 0.

• `<data type expression>` — Lets you specify an expression that evaluates to a valid data type.

Alternatively, you can set the Vector (V) data type by using the Data Type Assistant. To use the assistant, click the button .

For more information on the data type assistant, see Specify Data Types Using Data Type Assistant (Simulink).

Note

When the vector comes in through the input port of the block, the data type and scaling of its elements are inherited from the driving block.

Dependencies

This parameter appears only when you set the Vector (V) source parameter on the Main tab to `Dialog parameter`.

Specify the minimum value for the elements of vector V. The default value is `[]` (unspecified). Simulink® uses this value to perform:

Dependencies

This parameter appears only when you set the Vector (V) source parameter on the Main tab to `Dialog parameter`.

Specify the maximum value for the element of vector V. The default value is `[]` (unspecified). Simulink uses this value to perform:

Dependencies

This parameter appears only when you set the Vector (V) source parameter on the Main tab to `Dialog parameter`.

Specify the data type of the output of a product operation in the Array-Vector Multiply block. For illustrations depicting the use of the product output data type in this block, see Fixed-Point Data Types and Multiplication Data Types. Set this parameter to one of these options.

• `Inherit: Inherit via internal rule` — Inherits the data type based on an internal rule. For more information on this rule, see Inherit via Internal Rule.

• `Inherit: Same as first input` — Inherits the data type so it is the same as that of the input array A.

• `fixdt([],16,0)` — Lets you specify the fixed-point attributes of the data type.

• `<data type expression>` — Lets you specify an expression that evaluates to a valid data type.

Alternatively, you can set the Product output data type by using the Data Type Assistant. To use the assistant, click the button .

For more information on the data type assistant, see Specify Data Types Using Data Type Assistant (Simulink).

Specify the data type of the output of an accumulation operation in the Array-Vector Multiply block. For illustrations depicting the use of the accumulator data type in this block, see Fixed-Point Data Types. Set this parameter to one of these options.

• `Inherit: Inherit via internal rule` — Inherits the data type based on an internal rule. For more information on this rule, see Inherit via Internal Rule.

• `Inherit: Same as first input` — Inherits the data type so it is the same as that of the input array A.

• `Inherit: Same as product output` — Inherits the data type so it is the same as the product output data type.

• `fixdt([],16,0)` — Lets you specify the fixed-point attributes of the data type.

• `<data type expression>` — Lets you specify an expression that evaluates to a valid data type.

Alternatively, you can set the Accumulator data type by using the Data Type Assistant. To use the assistant, click the button .

For more information on the data type assistant, see Specify Data Types Using Data Type Assistant (Simulink).

Specify the output data type. For illustrations depicting the use of the output data type in this block, see Fixed-Point Data Types. Set this parameter to one of these options.

• `Inherit: Same as first input` — Inherits the data type so it is the same as that of the input array A.

• `Inherit: Same as product output` — Inherits the data type so it is the same as the product output data type.

• `fixdt([],16,0)` — Lets you specify the fixed-point attributes of the data type.

• `<data type expression>` — Lets you specify an expression that evaluates to a valid data type.

Alternatively, you can set the Output data type by using the Data Type Assistant. To use the assistant, click the button .

For more information on the data type assistant, see Specify Data Types Using Data Type Assistant (Simulink).

Specify the minimum value that the block outputs. The default value is `[]` (unspecified). Simulink uses this value to perform:

• Automatic scaling of fixed-point data types.

Specify the maximum value that the block should output. The default value is `[]` (unspecified). Simulink uses this value to perform:

• Automatic scaling of fixed-point data types.

Select this parameter to prevent the fixed-point tools from overriding the data types you specify in the block dialog box.

Block Characteristics

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

expand all

Version History

Introduced in R2007b