nthroot

N-ésima raíz real de números reales

Sintaxis

Y = nthroot(X,N)

Descripción

Y = nthroot(X,N) devuelve la n-ésima raíz real de X. Si un elemento en X es negativo, el elemento correspondiente en N debe ser un entero impar.

Ejemplos

Raíz real de un número negativo

Encuentre la raíz cúbica real de -27.

nthroot(-27,3)

ans = -3

Por comparar, calcule (-27)^(1/3). El resultado es la raíz cúbica compleja de -27.

(-27)^(1/3)

ans = 1.5000 + 2.5981i

Raíces reales de un escalar

Calcule varias n-ésimas raíces reales de -8.

N = [5 3 -1];
Y = nthroot(-8,N)

Y = 1×3

   -1.5157   -2.0000   -0.1250

Raíces reales de un vector

Cree un vector fila de bases, X, y un vector columna de raíces que se desea calcular, N.

X = [4 -3 -5];
N = [1; -1; 3];

Calcule las n-ésimas raíces reales de los elementos en X. El resultado es una matriz que contiene todas las combinaciones de bases y raíces. Por ejemplo, Y(3,1) es la tercera raíz de 4.

Y = nthroot(X,N)

Y = 3×3

    4.0000   -3.0000   -5.0000
    0.2500   -0.3333   -0.2000
    1.5874   -1.4422   -1.7100

Raíces elemento por elemento de una matriz

Cree una matriz de bases, X, y una matriz de raíces que se desea calcular, N. Cada elemento en X corresponde a un elemento en N.

X = [-2 -2 -2; 4 -3 -5];
N = [1 -1 3; 1/2 5 3];

Calcule las n-ésimas raíces reales de los elementos en X.

Y = nthroot(X,N)

Y = 2×3

   -2.0000   -0.5000   -1.2599
   16.0000   -1.2457   -1.7100

A excepción de los signos (que se tratan por separado), el resultado es comparable a abs(X).^(1./N). Por contraste, puede calcular las raíces complejas utilizando X.^(1./N).

Argumentos de entrada

X — Arreglo de entrada

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

Arreglo de entrada, especificado como escalar, vector, matriz, arreglo multidimensional, tabla u horario. Los elementos de X deben ser reales. Las entradas X y N deben ser del mismo tamaño o tener tamaños compatibles.

Tipos de datos: single | double | table | timetable

N — Raíces que se desea calcular

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

Raíces que se desea calcular, especificadas como escalar, vector, matriz, arreglo multidimensional, tabla u horario. Los elementos de N deben ser reales. Si un elemento en X es negativo, el elemento correspondiente en N debe ser un entero impar. Las entradas X y N deben ser del mismo tamaño o tener tamaños compatibles.

• Si X es un arreglo multidimensional, N no puede ser una tabla u horario.

• Si X es una tabla o un horario, N puede ser del mismo tipo de datos que X o un escalar, vector, matriz, o arreglo multidimensional de un tamaño compatible. Si ambas entradas son tablas u horarios, consulte Rules for Table and Timetable Mathematics para los requisitos de entrada.

Tipos de datos: single | double | table | timetable

Sugerencias

• Mientras que power es una función más eficiente para calcular las raíces de los números, en los casos donde existen tanto raíces reales como complejas, power solo devuelve las raíces complejas. En esos casos, utilice nthroot para obtener las raíces reales.

Capacidades ampliadas

Arreglos altos

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

Esta función 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™.

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 un entorno basado en subprocesos.

Arreglos GPU

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

Esta función es totalmente compatible con los arreglos de GPU. 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

R2023b: Compatibilidad para la ampliación implícita de los argumentos

nthroot es compatible con la ampliación implícita de los argumentos de entrada X y N. Para obtener más información sobre los tamaños de entrada necesarios, consulte Tamaños de arreglos compatibles para operaciones básicas.

Si el código se basa en los errores que MATLAB^® devolvía anteriormente para tamaños que no coincidían, especialmente dentro de un bloque try/catch, es posible que su código deje de detectar esos errores.

R2023a: Realizar cálculos directamente en tablas y horarios

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

sqrt | power