|LabVIEW 2016 Help|
|LabVIEW 2017 Help|
|LabVIEW 2018 Help|
|LabVIEW 2019 Help|
|LabVIEW 2020 Help|
Owning Palette: Numeric Functions
Requires: Base Development System
Computes the square root of the input value.
If x is negative, the square root is NaN unless x is complex. If x is a matrix, this function takes the matrix square root of x. The connector pane displays the default data types for this polymorphic function.
|Note If you wire a value that has a unit with an odd exponent to the square root function, the wire breaks because LabVIEW does not support units with fractional exponents. For example, 15m2 is an acceptable input value, but 15m3 is not an acceptable input value.|
|x can be a scalar number, array or cluster of numbers, array of clusters of numbers, and so on.|
|sqrt(x) is a double-precision, floating-point number if x is an integer. If x is less than 0, sqrt(x) is not a number (NaN), unless x is complex. When x is of the form x = a + bi, that is, when x is complex, the function defines the magnitude and phase with the following equations: |
where |x| is the magnitude of x and arg(x) is the phase of x:
arg(x) = arctan2(b,a)
When you wire matrix data as an input to this function, a VI that includes subVIs that work with the matrix data type replaces the function. The resulting VI has the same icon but contains a matrix-specific algorithm. The node remains a VI if you disconnect the matrix from the input(s). Wire other data types as inputs to restore the original function. If you wire a data type to a function and that data type causes a basic math operation to fail, the function returns an empty matrix or NaN.
Refer to the Matrix Square Root VI for more information.
If you wire a signed fixed-point value to this function, the function converts the signed number into a floating-point number and performs the square root operation. By default, LabVIEW configures the integer word length of the square root to avoid overflow. However, because the precision of the square root can be infinite, rounding conditions always occur. Use the Numeric Node Properties dialog box to configure how LabVIEW handles overflow and rounding of fixed-point data.
Refer to the Numeric Functions VI in the labview\examples\Numerics directory for an example of using the Square Root function.