Main Content

power, .^

Potencia elemento por elemento

Descripción

ejemplo

C = A.^B eleva cada elemento de A a las potencias correspondientes en B. Los tamaños de A y B deben ser los mismos o ser compatibles.

Si los tamaños de A y B son compatibles, los dos arreglos se amplían implícitamente para coincidir el uno con el otro. Por ejemplo, si A o B es un escalar, el escalar se combina con cada elemento del otro arreglo. Además, los vectores con distintas orientaciones (un vector fila y un vector columna) se amplían implícitamente para formar una matriz.

C = power(A,B) es una forma alternativa de ejecutar A.^B, pero se utiliza con poca frecuencia. Permite la sobrecarga de operadores para las clases.

Ejemplos

contraer todo

Cree un vector, A, y eleve al cuadrado cada elemento.

A = 1:5;
C = A.^2
C = 1×5

     1     4     9    16    25

Cree una matriz, A, y extraiga la inversa de cada elemento.

A = [1 2 3; 4 5 6; 7 8 9];
C = A.^-1
C = 3×3

    1.0000    0.5000    0.3333
    0.2500    0.2000    0.1667
    0.1429    0.1250    0.1111

Una inversión de los elementos no es igual a la inversa de la matriz, que en su lugar se escribe como A^-1 o inv(A).

Cree un vector fila de 1 por 2 y un vector columna de 3 por 1 y eleve el vector fila a la potencia del vector columna.

a = [2 3];
b = (1:3)';
a.^b
ans = 3×2

     2     3
     4     9
     8    27

El resultado es una matriz de 3 por 2, donde cada elemento (i,j) de la matriz es igual a (j) .^ b(i):

a=[a1a2],b=[b1b2b3],          a.ˆb=[a1b1a2b1a1b2a2b2a1b3a2b3].

Calcule las raíces de -1 a la potencia 1/3.

A = -1;
B = 1/3;
C = A.^B
C = 0.5000 + 0.8660i

Para A de base negativa y de B no entero, la función power devuelve resultados complejos.

Utilice la función nthroot para obtener las raíces reales.

C = nthroot(A,3)
C = -1

Desde la versión R2023a

Cree dos tablas y eleve la primera a la potencia de la segunda. Los nombres de las filas (si están presentes en ambas) y los nombres de las variables deben ser iguales, pero no necesitan estar en el mismo orden. Las filas y las variables de la salida están en el mismo orden que la primera entrada.

A = table([1;2],[3;4],VariableNames=["V1","V2"],RowNames=["R1","R2"])
A=2×2 table
          V1    V2
          __    __

    R1    1     3 
    R2    2     4 

B = table([4;2],[3;1],VariableNames=["V2","V1"],RowNames=["R2","R1"])
B=2×2 table
          V2    V1
          __    __

    R2    4     3 
    R1    2     1 

C = A .^ B
C=2×2 table
          V1    V2 
          __    ___

    R1    1       9
    R2    8     256

Argumentos de entrada

contraer todo

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

  • Los operandos con un tipo de datos enteros no pueden ser complejos.

Las entradas que son tablas u horarios deben satisfacer estas condiciones: (desde R2023a)

  • Si una entrada es una tabla o un horario, todas sus variables deben tener tipos de datos que admitan la operación.

  • Si solo una entrada es una tabla u horario, la otra entrada debe ser un arreglo lógico o numérico.

  • Si ambas entradas son tablas u horarios:

    • Ambas entradas deben tener el mismo tamaño, o bien una de ellas debe ser una tabla de una fila.

    • Ambas entradas deben tener variables con los mismos nombres. Sin embargo, las variables de cada entrada pueden estar en un orden diferente.

    • Si ambas entradas son tablas y ambas tienen nombres de filas, los nombres de sus filas deben ser los mismos. Sin embargo, los nombres de las filas de cada entrada pueden estar en un orden diferente.

    • Si ambas entradas son horarios, las horas de sus filas deben ser iguales. Sin embargo, las horas de las filas de cada entrada pueden estar en un orden diferente.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | table | timetable
Soporte de números complejos:

Más acerca de

contraer todo

Cumplimiento con IEEE

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

  MATLAB® IEEE

power(1,NaN)

NaN

1

power(NaN,0)

NaN

1

Capacidades ampliadas

Historial de versiones

Introducido antes de R2006a

expandir todo