La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

sqrt

Raíz cuadrada

Sintaxis

B = sqrt(X)

Descripción

B = sqrt(X) devuelve la raíz cuadrada de cada elemento del arreglo X. En los elementos de X que son negativos o complejos, sqrt(X) genera resultados complejos.

El dominio de la función sqrt incluye números negativos y complejos, lo que puede dar lugar a resultados inesperados si se utiliza involuntariamente. En los números negativos y complejos z = u + i*w, la raíz cuadrada compleja sqrt(z) devuelve

sqrt(r)*(cos(phi/2) + 1i*sin(phi/2))

donde r = abs(z) es el radio y phi = angle(z) es el ángulo de fase en el intervalo cerrado -pi <= phi <= pi.

Si desea que los números negativos y complejos devuelvan mensajes de error en lugar de resultados complejos, utilice realsqrt en su lugar.

Ejemplos

Raíz cuadrada de los elementos del vector

Cree un vector fila que contenga valores negativos y positivos.

X = -2:2

X = 1×5

    -2    -1     0     1     2

Calcule la raíz cuadrada de cada elemento de X.

Y = sqrt(X)

Y = 1×5 complex

   0.0000 + 1.4142i   0.0000 + 1.0000i   0.0000 + 0.0000i   1.0000 + 0.0000i   1.4142 + 0.0000i

Argumentos de entrada

X — Arreglo de entrada

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Arreglo de entrada, especificado como escalar numérico, vector, matriz, arreglo multidimensional, tabla u horario.

Tipos de datos: single | double | table | timetable
Soporte de números complejos: Sí

Más acerca de

Cumplimiento con IEEE

En las entradas reales, sqrt tiene comportamientos que difieren de los recomendados en el estándar IEEE^®-754. En especial, las entradas negativas generan resultados complejos en lugar de NaN.

	MATLAB®	IEEE
sqrt(-0)	0	-0
sqrt(X) para X < 0	0+sqrt(-X)*i	NaN

Sugerencias

• Consulte sqrtm para ver la raíz cuadrada de la matriz.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función sqrt es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• La simulación produce un error. El código independiente generado devuelve NaN cuando el valor de entrada x es real, pero la salida debería ser compleja. Para obtener el resultado complejo, convierta el valor de entrada en complejo pasándolo a complex(x).

• Si genera código para objetivos independientes y la entrada a sqrt en su código de MATLAB no es una constante, el valor que el código generado devuelve para sqrt(-0) es idéntico al valor que devuelve la función estándar de la biblioteca del compilador C/C++. Si la función estándar de la biblioteca cumple con el estándar IEEE-754, el código generado devuelve -0.

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• La simulación produce un error. El código independiente generado devuelve NaN cuando el valor de entrada x es real, pero la salida debería ser compleja. Para obtener el resultado complejo, convierta el valor de entrada en complejo pasándolo a complex(x).

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función sqrt es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

Si la salida de la función que se ejecuta en la GPU puede ser compleja, debe especificar explícitamente sus argumentos de entrada como complejos. Para obtener más información, consulte Work with Complex Numbers on a GPU (Parallel Computing Toolbox).

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2023a: Realizar cálculos directamente en tablas y horarios

La función sqrt puede realizar cálculos sobre todas las variables de una tabla u horario sin indexar para acceder a dichas variables. Todas las variables deben tener tipos de datos que admitan el cálculo. Para obtener más información, consulte Direct Calculations on Tables and Timetables.

Consulte también

nthroot | sqrtm | realsqrt