sum

Suma de elementos de array

Sintaxis

S = sum(A)

S = sum(A,dim)

S = sum(___,outtype)

S = sum(___,nanflag)

Descripción

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.

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.

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'.

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

Suma de elementos vectoriales

Cree un vector y calcule la suma de sus elementos.

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

S = 55

Suma de columnas matriciales

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

Suma de filas matriciales

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

Suma de un array tridimensional

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

Suma de enteros de 32 bits

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

Suma excluyendo NaN

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

A — Array de entrada

vector | matriz | array multidimensional

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: Sí

dim — Dimensión en la que operar

escalar entero positivo

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

outtype — Tipo de datos de salida

'default' (predeterminado) | 'double' | 'native'

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.

outtype	Tipo 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

nanflag — Condición NaN

‘includenan’ (predeterminado) | ‘omitnan’

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

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 tall arrays. 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 de uso y limitaciones:

• Si especifica dim, debe ser una constante.

• Las opciones outtype y nanflag deben ser vectores de caracteres constantes.

• Consulte Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder).

Consulte también

cumsum | diff | mean | prod

Introducido antes de R2006a

×

Abrir ejemplo

Tiene una versión modificada de este ejemplo. ¿Desea abrir este ejemplo con sus modificaciones?

No, sobrescribir la versión modificada Sí