times

Element-by-element multiplication of `fi` objects

Syntax

• `C =A.*B` example
• `C = times(A, B)`

Description

example

````C =A.*B` performs element-by-element multiplication of `A` and `B`, and returns the result in `C`.```
````C = times(A, B)` is an alternate way to execute `A.*B`. ```

Examples

collapse all

Multiply a `fi` Object by a Scalar

Use the `times` function to perform element-by-element multiplication of a `fi` object and a scalar.

```a=4; b=fi([2 4 7; 9 0 2])```
```b = 2 4 7 9 0 2 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 11```

`a` is a scalar double, and `b` is a matrix of `fi` objects. When doing arithmetic between a `fi` and a double, the double is cast to a `fi` with the same word length and signedness of the `fi`, and best-precision fraction length. The result of the operation is a `fi`.

`c=a.*b`
```c = 8 16 28 36 0 8 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 32 FractionLength: 23```

During the operation, `a` was cast to a `fi` object with wordlength 16. The output, `c`, is a `fi` object with word length 32, the sum of the word lengths of the two multiplicands, `a` and `b`. This is because the default setting of `ProductMode` in `fimath` is `FullPrecision`.

Multiply Two `fi` Objects

Use the `times` function to perform element-by-element multiplication of two `fi` objects.

`a=fi([5 9 9; 1 2 -3], 1, 16, 3)`
```a = 5 9 9 1 2 -3 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 3```
`b=fi([2 4 7; 9 0 2], 1, 16, 3)`
```b = 2 4 7 9 0 2 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 3```
`c=a.*b`
```c = 10 36 63 9 0 -6 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 32 FractionLength: 6```

The word length and fraction length of `c` are equal to the sums of the word lengths and fraction lengths of `a` and `b`. This is because the default setting of `ProductMode` in `fimath` is `FullPrecision`.

Input Arguments

collapse all

`A` — Input arrayscalar | vector | matrix | multidimensional array

Input array, specified as a scalar, vector, matrix, or multidimensional array of `fi` objects or built-in types. `A` and `B` must have the same dimensions unless one is a scalar value.

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

Complex Number Support: Yes

`B` — Input arrayscalar | vector | matrix | multidimensional array

Input array, specified as a scalar, vector, matrix, or multidimensional array of `fi` objects or built-in types. `A` and `B` must have the same dimensions unless one is a scalar value.

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

Complex Number Support: Yes

Output Arguments

collapse all

`C` — Output arrayscalar | vector | matrix | multidimensional array

Output array, specified as a scalar, vector, matrix or multidimensional array.