`sum`

Soma dos elementos de um array, ao longo de uma dimensão ou de tudo.

Categoria: Language Fundamentals > Data Types

Sintaxe

S = sum(A)

Soma ao longo da primeira dimensão de tamanho diferente de 1: pelas colunas de uma matriz, ou ao longo de um vetor.

S = sum(A, dim)

Soma ao longo da dimensão dim.

S = sum(A, 'all')

Soma todos os elementos e retorna um escalar.

Descrição

Para uma matriz, sum(A) retorna um vetor linha com a soma de cada coluna, e sum(A, 2) retorna um vetor coluna com a soma de cada linha. Valores lógicos contam como 0 e 1, então sum(x > 3) conta quantos elementos passam de 3.

Argumentos de entrada

A: Array numérico ou lógico.
dim: Inteiro positivo: a dimensão ao longo da qual somar.

Argumentos de saída

S: As somas. A dimensão somada tem tamanho 1 no resultado; um array vazio soma 0.

Exemplo

Colunas, linhas e tudo

A = [1 2 3; 4 5 6];
sum(A)
sum(A, 2)
sum(A, 'all')
sum([2 7 1 9] > 3)

Saída

ans = 1×3

     5     7     9
ans = 2×1

     6
    15
ans = 21
ans = 2

Veja também

cumsum prod mean max