Esta página aún no se ha traducido para esta versión. Puede ver la versión más reciente de esta página en inglés.

sum

Suma de elementos de array

Descripción

ejemplo

S = sum(A) devuelve la suma de los elementos de A a lo largo de la primera dimensión del array cuyo tamaño no es igual a 1.

  • Si A es un vector, sum(A) devuelve la suma de los elementos.

  • Si A es una matriz, sum(A) devuelve un vector de fila que contiene la suma de cada columna.

  • Si A es un array multidimensional, sum(A) opera a lo largo de la primera dimensión del array cuyo tamaño no sea igual a 1, tratando los elementos como vectores. Esta dimensión se convierte en 1, mientras que los tamaños de todas las demás dimensiones permanecen iguales.

ejemplo

S = sum(A,dim) devuelve la suma a lo largo de la dimensión dim. Por ejemplo, si A es una matriz, sum(A,2) es un vector de columna que contiene la suma de cada fila.

ejemplo

S = sum(___,outtype) devuelve la suma con un tipo de datos especificado, utilizando cualquiera de los argumentos de entrada de las sintaxis anteriores. outtype puede ser 'default', 'double' o 'native'.

ejemplo

S = sum(___,nanflag) especifica si se deben incluir u omitir los valores NaN en el cálculo en cualquiera de las sintaxis anteriores. sum(A,'includenan') incluye todos los valores NaN en el cálculo, mientras que sum(A,'omitnan') los ignora.

Ejemplos

contraer todo

Cree un vector y calcule la suma de sus elementos.

A = 1:10;
S = sum(A)
S = 55

Cree una matriz y calcule la suma de los elementos de cada columna.

A = [1 3 2; 4 2 5; 6 1 4]
A = 3×3

     1     3     2
     4     2     5
     6     1     4

S = sum(A)
S = 1×3

    11     6    11

Cree una matriz y calcule la suma de los elementos de cada fila.

A = [1 3 2; 4 2 5; 6 1 4]
A = 3×3

     1     3     2
     4     2     5
     6     1     4

S = sum(A,2)
S = 3×1

     6
    11
    11

Cree un array de unos de 4 por 2 por 3 y calcule la suma a lo largo de la tercera dimensión.

A = ones(4,2,3);
S = sum(A,3)
S = 4×2

     3     3
     3     3
     3     3
     3     3

Cree un vector de enteros de 32 bits y calcule la suma int32 de sus elementos especificando el tipo de salida como native.

A = int32(1:10);
S = sum(A,'native')
S = int32
    55

Cree un vector y calcule su suma, excluyendo los valores NaN.

A = [1.77 -0.005 3.98 -2.95 NaN 0.34 NaN 0.19];
S = sum(A,'omitnan')
S = 3.3250

Si no especifica 'omitnan', sum(A) devuelve NaN.

Argumentos de entrada

contraer todo

Array de entrada, especificado como vector, matriz o array multidimensional.

  • Si A es un escalar, sum(A) devuelve A.

  • Si A es una matriz vacía de 0 por 0, sum(A) devuelve 0.

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

Dimensión en la que operar, especificada como un escalar entero positivo. Si no se especifica ningún valor, la opción predeterminada es la primera dimensión del array cuyo tamaño no sea igual a 1.

La dimensión dim indica la dimensión cuya longitud se reduce a 1. size(S,dim) es 1, mientras que los tamaños de todas las demás dimensiones permanecen iguales.

Considere un array de entrada de dos dimensiones, A:

  • sum(A,1) opera con los elementos sucesivos en las columnas de A y devuelve un vector de fila de las sumas de cada columna.

  • sum(A,2) opera con los elementos sucesivos en las filas de A y devuelve un vector de columna de las sumas de cada fila.

sum devuelve A cuando dim es mayor que ndims(A) o cuando size(A,dim) es 1.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Tipo de datos de salida, especificado como 'default', 'double' o 'native'. Estas opciones también especifican el tipo de datos en el que se realiza la operación.

outtypeTipo de datos de salida
'default'double, a menos que el tipo de datos de entrada sea single o duration, en cuyo caso la salida es 'native'
'double'double, a menos que el tipo de datos sea duration, en cuyo caso no se admite 'double'
'native'el mismo tipo de datos que la entrada, a menos que el tipo de datos de entrada sea char, en cuyo caso 'native' no se admite

Tipos de datos: char

Condición NaN, especificada como uno de estos valores:

  • 'includenan': incluir los valores NaN al calcular la suma, resultando en NaN.

  • 'omitnan': ignorar todos los valores NaN de la entrada.

Tipos de datos: char

Capacidades ampliadas

Consulte también

| | |

Introducido antes de R2006a