hypot

Raíz cuadrada de una suma de cuadrados (hipotenusa)

Sintaxis

C = hypot(A,B)

Descripción

C = hypot(A,B) devuelve la hipotenusa de un triángulo rectángulo con longitudes de los lados de A y B. Esta función calcula C = sqrt(abs(A).^2 + abs(B).^2) evitando el subdesbordamiento y el desbordamiento.

Ejemplos

Calcular hipotenusas

Calcule la hipotenusa de un triángulo rectángulo con longitudes de los lados de 3 y 4.

C = hypot(3,4)

C = 
5

Comportamiento de desbordamiento y subdesbordamiento

Examine la diferencia entre usar hypot y codificar la ecuación hypot básica en código M.

Cree una función anónima que realice esencialmente la misma función básica que hypot.

myhypot = @(a,b)sqrt(abs(a).^2+abs(b).^2);

myhypot no tiene en cuenta el comportamiento de desbordamiento y subdesbordamiento de la misma forma que ofrece hypot.

Encuentre el límite superior en el que myhypot devuelve un valor útil. Puede ver que esta función de prueba alcanza su máximo en 1e154 aproximadamente, y devuelve un resultado infinito en ese punto.

myhypot(1e153,1e153)

ans = 
1.4142e+153

myhypot(1e154,1e154)

ans = 
Inf

Haga lo mismo usando la función hypot y observe que hypot opera sobre los valores hasta cerca de 1e308, que es aproximadamente igual al valor de realmax de su ordenador (el mayor número de punto flotante de doble precisión representable).

hypot(1e308,1e308)

ans = 
1.4142e+308

hypot(1e309,1e309)

ans = 
Inf

Argumentos de entrada

A,B — Arreglos de entrada

escalares | vectores | matrices | arreglos multidimensionales

Arreglos de entrada, especificados como escalares, vectores, matrices o arreglos multidimensionales. Las entradas A y B deben ser del mismo tamaño o tener tamaños compatibles (por ejemplo, A es una matriz M por N y B es un escalar o un vector fila 1 por N). Para obtener más información, consulte Tamaños de arreglos compatibles para operaciones básicas.

Si una o ambas entradas son NaN, hypot devuelve NaN.

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

Más acerca de

Cumplimiento con IEEE

En las entradas reales, hypot tiene comportamientos que difieren de los recomendados en el estándar IEEE^®-754.

	MATLAB®	IEEE
hypot(NaN,Inf)	NaN	Inf
hypot(NaN,-Inf)	NaN	Inf
hypot(Inf,NaN)	NaN	Inf
hypot(-Inf,NaN)	NaN	Inf

Capacidades ampliadas

Arreglos altos

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

La función hypot 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:

• Si utiliza hypot con operandos de tipo simple y de tipo doble, es posible que el código generado no produzca el mismo resultado que MATLAB. Consulte Binary Element-Wise Operations with Single and Double Operands (MATLAB Coder).

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

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 hypot es totalmente compatible con los arreglos de GPU. Para ejecutar la función en una GPU, especifique los datos de entrada como un gpuArray (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

Consulte también

sqrt | abs | norm