Documentation

### This is machine translation

Mouseover text to see original. Click the button below to return to the English version of the page.

# Sqrt

Calculate square root, signed square root, or reciprocal of square root

• Library:

HDL Coder / HDL Floating Point Operations

HDL Coder / Math Operations ## Description

The Sqrt block calculates the square root, signed square root, or reciprocal of square root on the input signal. Select one of the following functions from the Function parameter list.

FunctionDescriptionMathematical Expression MATLAB® Equivalent
`sqrt`

Square root of the input

`u0.5`

`sqrt`
`signedSqrt`

Square root of the absolute value of the input, multiplied by the sign of the input

`sign(u)*|u|0.5`

`rSqrt`

Reciprocal of the square root of the input

`u-0.5`

The block icon changes to match the function.

## Ports

### Input

expand all

Input signal to the block to calculate the square root, signed square root, or reciprocal of square root. The `sqrt` function accepts real or complex inputs, except for complex fixed-point signals. `signedSqrt` and `rSqrt` do not accept complex inputs.

If the input is negative, set the Output signal to complex.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `uint8` | `uint16` | `uint32` | `fixed point`

### Output

expand all

Output signal that is the square root, signed square root, or reciprocal of square root of the input signal. When the input is an integer or fixed-point type, the output must be floating point.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `uint8` | `uint16` | `uint32` | `fixed point`

## Parameters

expand all

### Main

Specify the mathematical function that the block calculates. The block icon changes to match the function you select.

FunctionBlock Icon
`sqrt` `signedSqrt` `rSqrt` #### Programmatic Use

 Block Parameter: `Operator` Type: character vector Values: `'sqrt'` | `'signedSqrt'` | `'rSqrt'` Default: `'sqrt'`

Specify the output signal type of the block.

FunctionInput Signal TypeOutput Signal Type
AutoRealComplex

`sqrt`

`real`

`real` for nonnegative inputs

`NaN` for negative inputs

`real` for nonnegative inputs

`NaN` for negative inputs

`complex`

`complex`

`complex`

`error`

`complex`

`signedSqrt`

`real`

`real`

`real`

`complex`

`complex`

`error`

`error`

`error`

`rSqrt`

`real`

`real`

`real`

`error`

`complex`

`error`

`error`

`error`

#### Programmatic Use

 Block Parameter: `OutputSignalType` Type: character vector Values: `'auto'` | `'real'` | `'complex'` Default: `'auto'`

Specify the sample time as a value other than -1. For more information, see Specify Sample Time.

#### Dependencies

This parameter is not visible unless it is explicitly set to a value other than `-1`. To learn more, see Blocks for Which Sample Time Is Not Recommended.

#### Programmatic Use

 Block Parameter: `SampleTime` Type: character vector Values: scalar Default: `'-1'`

### Algorithm

Specify the method for computing the reciprocal of a square root. This parameter is only valid for the `rSqrt` function.

MethodData Types SupportedWhen to Use This Method
`Exact`

Floating point

If you use a fixed-point or built-in integer type, an upcast to a floating-point type occurs.

You do not want an approximation.

### Note

The input or output must be floating point.

`Newton-Raphson`

Floating-point, fixed-point, and built-in integer types

You want a fast, approximate calculation.

The `Exact` method provides results that are consistent with MATLAB computations.

### Note

The algorithms for `sqrt` and `signedSqrt` are always of `Exact` type, no matter what selection appears on the block dialog box.

#### Programmatic Use

 Block Parameter: `AlgorithmType` Type: character vector Values: `'Exact'` | `'Newton-Raphson'` Default: `'Exact'`

Specify the number of iterations to perform the Newton-Raphson algorithm. This parameter is valid with the `rSqrt` function and the `Newton-Raphson` value for Method.

### Note

If you enter 0, the block output is the initial guess of the Newton-Raphson algorithm.

#### Programmatic Use

 Block Parameter: `Iterations` Type: character vector Values: integer Default: `'3'`

### Data Types

Click the button to display the Data Type Assistant, which helps you set the data type attributes. For more information, see Specify Data Types Using Data Type Assistant.

Specify the data type for intermediate results when you set Function to `sqrt` or `rSqrt` on the Main pane.

The type can be inherited, specified directly, or expressed as a data type object such as `Simulink.NumericType`.

Follow these guidelines on setting an intermediate data type explicitly for the square root function, `sqrt`:

Input and Output Data TypesIntermediate Data Type
Input or output is double.Use double.
Input or output is single, and any non-single data type is not double. Use single or double.
Input and output are fixed point.Use fixed point.

Follow these guidelines on setting an intermediate data type explicitly for the reciprocal square root function, `rSqrt`:

Input and Output Data TypesIntermediate Data Type
Input is double and output is not single.Use double.
Input is not single and output is double.Use double.
Input and output are fixed point.Use fixed point.

### Caution

Do not set Intermediate results data type to `Inherit:Inherit from output` when:

• You select `Newton-Raphson` to compute the reciprocal of a square root.

• The input data type is floating point.

• The output data type is fixed point.

Under these conditions, selecting ```Inherit:Inherit from output``` yields suboptimal performance and produces an error.

To avoid this error, convert the input signal from a floating-point to fixed-point data type. For example, insert a Data Type Conversion block in front of the Sqrt block to perform the conversion.

#### Programmatic Use

 Block Parameter: `IntermediateResultsDataTypeStr` Type: character vector Values: ```'Inherit: Inherit via internal rule'``` | ```'Inherit: Inherit from input'``` | ```'Inherit: Inherit from output'``` | `'double'` | `'single'`, `'int8'`, `'uint8'`, `int16`, `'uint16'`, `'int32'`, `'uint32'`, `'int64'`, `'uint64'`, `fixdt(1,16,0)`, `fixdt(1,16,2^0,0)`, `fixdt(1,16,2^0,0)`. ```''``` Default: ```'Inherit: Inherit via internal rule'```

Specify the output data type. The type can be inherited, specified directly, or expressed as a data type object such as `Simulink.NumericType`.

#### Programmatic Use

 Block Parameter: `OutDataTypeStr` Type: character vector Values: ```'Inherit: Inherit via internal rule'``` | ```'Inherit: Inherit via back propagation'``` | ```'Inherit: Same as first input'``` | `'double'` | `'single'`, `'int8'`, `'uint8'`, `int16`, `'uint16'`, `'int32'`, `'uint32'`, `'int64'`, `'uint64'`, `fixdt(1,16,0)`, `fixdt(1,16,2^0,0)`, `fixdt(1,16,2^0,0)`. ```''``` Default: ```'Inherit: Same as first input'```

Select to lock the output data type setting of this block against changes by the Fixed-Point Tool and the Fixed-Point Advisor. For more information, see Use Lock Output Data Type Setting (Fixed-Point Designer).

#### Programmatic Use

 Block Parameter: `LockScale` Type: character vector Values: `'off'` | `'on'` Default: `'off'`

ActionReasons for Taking This ActionWhat Happens for OverflowsExample

Select this check box.

Your model has possible overflow, and you want explicit saturation protection in the generated code.

Overflows saturate to either the minimum or maximum value that the data type can represent.

The maximum value that the `int8` (signed, 8-bit integer) data type can represent is 127. Any block operation result greater than this maximum value causes overflow of the 8-bit integer. With the check box selected, the block output saturates at 127. Similarly, the block output saturates at a minimum output value of -128.

Do not select this check box.

You want to optimize efficiency of your generated code.

You want to avoid overspecifying how a block handles out-of-range signals. For more information, see Check for Signal Range Errors.

Overflows wrap to the appropriate value that is representable by the data type.

The maximum value that the `int8` (signed, 8-bit integer) data type can represent is 127. Any block operation result greater than this maximum value causes overflow of the 8-bit integer. With the check box cleared, the software interprets the overflow-causing value as `int8`, which can produce an unintended result. For example, a block result of 130 (binary 1000 0010) expressed as `int8`, is -126.

When you select this check box, saturation applies to every internal operation on the block, not just the output or result. Usually, the code generation process can detect when overflow is not possible. In this case, the code generator does not produce saturation code.

#### Programmatic Use

 Block Parameter: `SaturateOnIntegerOverflow` Type: character vector Value: `'off'` | `'on'` Default: `'on'`

## Block Characteristics

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