sum

Sommare gli elementi dell’array

Sintassi

S = sum(A)

S = sum(A,"all")

S = sum(A,dim)

S = sum(A,vecdim)

S = sum(___,outtype)

S = sum(___,nanflag)

Descrizione

S = sum(A) restituisce la somma degli elementi di A lungo la prima dimensione dell'array la cui dimensione è non è uguale a 1.

• Se A è un vettore, sum(A) restituisce la somma degli elementi.

• Se A è una matrice, sum(A) restituisce un vettore riga contenente la somma di ciascuna colonna.

• Se A è un array multidimensionale, sum(A) opera lungo la prima dimensione dell’array la cui grandezza non è uguale a 1, trattando gli elementi come vettori. La grandezza di S in questa dimensione diventa 1, mentre le grandezze di tutte le altre dimensioni rimangono le stesse come in A.

• Se A è una tabella o un orario, sum(A) restituisce una tabella di una riga contenente la somma di ciascuna variabile. (da R2023a)

S = sum(A,"all") restituisce la somma di tutti gli elementi di A.

S = sum(A,dim) restituisce la somma lungo la dimensione dim. Ad esempio, se A è una matrice, sum(A,2) restituisce un vettore colonna contenente la somma di ciascuna riga.

S = sum(A,vecdim) somma gli elementi di A sulla base delle dimensioni specificate nel vettore vecdim. Ad esempio, se A è una matrice, sum(A,[1 2]) restituisce la somma di tutti gli elementi in A poiché ogni elemento di una matrice è contenuto nella porzione di array definita dalle dimensioni 1 e 2.

S = sum(___,outtype) restituisce la somma con il tipo di dati specificato, utilizzando uno qualsiasi degli argomenti di input nelle sintassi precedenti. outtype può essere "default", "double" o "native".

S = sum(___,nanflag) specifica se includere o ometter i valori NaN in A. Ad esempio, sum(A,"omitnan") ignora i valori NaN nel calcolare la somma. Per impostazione predefinita, sum include i valori NaN.

Esempi

Somma di elementi del vettore

Creare un vettore e calcolare la somma dei suoi elementi.

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

S = 
55

Somma di colonne della matrice

Creare una matrice e calcolare la somma degli elementi in ciascuna colonna.

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

Somma di righe della matrice

Creare una matrice e calcolare la somma degli elementi in ciascuna riga.

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

Somma di porzioni di array

Utilizzare un argomento di dimensione del vettore per operare su porzioni specifiche di un array.

Creare un array tridimensionale i cui elementi siano 1.

A = ones(4,3,2);

Per sommare tutti gli elementi in ciascuna pagina di A, specificare le dimensioni in cui la somma (riga e colonna) deve essere eseguita, utilizzando un argomento di dimensione del vettore. Poiché entrambe le pagine sono una matrice di uno 4x3, la somma di ciascuna pagina è 12.

S1 = sum(A,[1 2])

S1 = 
S1(:,:,1) =

    12


S1(:,:,2) =

    12

Se si taglia una porzione di A lungo la prima dimensione, è possibile sommare gli elementi delle 4 pagine risultanti, che sono ciascuna una matrice 3x2.

S2 = sum(A,[2 3])

S2 = 4×1

     6
     6
     6
     6

Tagliando una porzione lungo la seconda dimensione, la somma di ciascuna pagina viene eseguita su una matrice 4x2.

S3 = sum(A,[1 3])

S3 = 1×3

     8     8     8

Per calcolare la somma su tutte le dimensioni di un array, è possibile specificare ciascuna dimensione nell'argomento di dimensione del vettore, oppure utilizzare l'opzione "all".

S4 = sum(A,[1 2 3])

S4 = 
24

Sall = sum(A,"all")

Sall = 
24

Somma di array tridimensionali

Creare un array di uno 4x2x3 e calcolare la somma lungo la terza dimensione.

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

S = 4×2

     3     3
     3     3
     3     3
     3     3

Somma di numeri interi a 32 bit

Creare un vettore di numeri interi a 32 bit e calcolare la somma int32 dei suoi elementi, specificando il tipo di output come native.

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

S = int32

55

Somma con esclusione dei valori mancanti

Creare una matrice contenente valori NaN.

A = [1.77 -0.005 NaN -2.95; NaN 0.34 NaN 0.19]

A = 2×4

    1.7700   -0.0050       NaN   -2.9500
       NaN    0.3400       NaN    0.1900

Calcolare la somma della matrice, escludendo i valori NaN. Per le colonne della matrice che contengono qualsiasi valore NaN, sum esegue il calcolo con gli elementi che non sono NaN. Per le colonne della matrice che contengono tutti valori NaN, la somma è pari a 0.

S = sum(A,"omitnan")

S = 1×4

    1.7700    0.3350         0   -2.7600

Argomenti di input

A — Array di input

vettore | matrice | array multidimensionale | tabella | orario

Array di input, specificato come vettore, matrice, array multidimensionale, tabella o orario.

• Se A è uno scalare, sum(A) restituisce A.

• Se A è una matrice vuota 0x0, sum(A) restituisce 0.

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | duration | table | timetable
Supporto numeri complessi: Sì

dim — Dimensione lungo la quale operare

scalare intero positivo

Dimensione lungo la quale operare, specificata come scalare intero positivo. Se non si specifica la dimensione, per impostazione predefinita si considera la prima dimensione dell'array la cui grandezza non è uguale a 1.

La dimensione dim indica la dimensione la cui lunghezza si riduce a 1. La size(S,dim) è 1, mentre le grandezze di tutte le altre dimensioni rimangono invariate.

Considerare un array di input a due dimensioni, A:

• sum(A,1) opera sugli elementi successivi nelle colonne di A e restituisce un vettore riga delle somme di ciascuna colonna.

  

• sum(A,2) opera sugli elementi successivi nelle righe di A e restituisce un vettore colonna delle somme di ciascuna riga.

  

sum restituisce A quando dim è maggiore di ndims(A) o quando size(A,dim) è 1.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

vecdim — Vettore di dimensioni

vettore di numeri interi positivi

Vettore di dimensioni, specificato come vettore di numeri interi positivi. Ciascun elemento rappresenta una dimensione dell'array di input. Le lunghezze dell’output nelle dimensioni operative specificate sono 1, mentre le altre rimangono invariate.

Considerare un array di input 2x3x3, A. Quindi, sum(A,[1 2]) restituisce un array 1x1x3 i cui elementi sono le somme di ciascuna pagina di A.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

outtype — Tipo di dati di output

"default" (predefinito) | "double" | "native"

Tipo di dati di output, specificato come "default", "double" o "native". Queste opzioni specificano inoltre il tipo di dati in base al quale viene eseguita l'operazione.

outtype	Tipo di dati di output
"default"	double, a meno che il tipo di dati di input non sia single, duration, ,table o timetable, nel qual caso l’output è "native"
"double"	double, a meno che il tipo di dati non sia duration,, table o timetable, nel qual caso "double" non è supportato
"native"	Stesso tipo di dati di input, a meno che il tipo di dati di input non sia char, nel qual caso "native" non è supportato; o nel caso in cui il tipo di dati di input non sia timetable, nel qual caso il tipo di dati di output è table

nanflag — Condizione di valore mancante

"includemissing" (predefinito) | "includenan" | "omitmissing" | "omitnan"

Condizione di valore mancante, specificata come uno dei seguenti valori:

• "includemissing" o "includenan": include i valori NaN in A nel calcolare la somma. Se qualsiasi elemento della dimensione operativa è NaN, l’elemento corrispondente in S è NaN. "includemissing" e "includenan" si comportano allo stesso modo.

• "omitmissing" o "omitnan": ignora i valori NaN in A e calcola la somma su pochi punti. Se tutti gli elementi della dimensione operativa sono NaN, l’elemento corrispondente in S è 0. "omitmissing" e "omitnan" si comportano allo stesso modo.

Funzionalità estese

Tall array

Esegui calcoli con array che hanno più righe di quelle allocabili in memoria.

La funzione sum supporta completamente i tall array. Per maggiori informazioni, vedere Tall Array.

Generazione di codice C/C++

Genera codice C e C++ con MATLAB® Coder™.

Note su utilizzo e limitazioni:

• Se utilizzati, gli argomenti dim, vecdim, outtype e nanflag devono essere costanti al momento della generazione di codice.

• Per l'argomento di input A:

  • Se non si specifica una dimensione, il generatore di codice opera lungo la prima dimensione dell'array di input che ha grandezza variabile o la cui grandezza non è uguale a 1. Se questa dimensione ha grandezza variabile al momento della generazione di codice ed è pari a 1 in fase di esecuzione, può verificarsi un errore di runtime. Per evitare il verificarsi di tale errore, specificare la dimensione.

  • Se tutte le dimensioni dell'array input hanno grandezza variabile al momento della generazione di codice, questo array non può essere vuoto in fase di esecuzione.

Generazione di codice GPU

Genera codice CUDA® per GPU NVIDIA® con GPU Coder™.

Note su utilizzo e limitazioni:

• Se si specifica dim, deve essere una costante.

• Le opzioni outtype e nanflag devono essere vettori di caratteri costanti.

Ambiente basato su thread

Esegui il codice in background usando MATLAB® backgroundPool oppure accelera il codice con Parallel Computing Toolbox™ ThreadPool.

Questa funzione supporta completamente gli ambienti basati su thread. Per maggiori informazioni, vedere Run MATLAB Functions in Thread-Based Environment.

Array GPU

Accelera il codice mediante esecuzione su un’unità di elaborazione grafica (GPU) con Parallel Computing Toolbox™.

La funzione sum supporta l'input di array GPU con queste note su utilizzo e limitazioni:

• L’ordine delle addizioni nell’operazione sum non è definito. Pertanto, l’operazione sum su un array di GPU potrebbe non restituire esattamente la stessa risposta dell’operazione sum eseguita sul corrispondente array numerico. La differenza potrebbe essere rilevante quando A è di tipo a numero intero con segno e il suo prodotto è accumulato in modo nativo.

Per maggiori informazioni, vedere Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Array distribuiti

Partiziona array di grandi dimensioni nella memoria combinata del cluster con Parallel Computing Toolbox™.

Note su utilizzo e limitazioni:

• L’ordine delle addizioni nell’operazione sum non è definito. Pertanto, l’operazione sum su un array distribuito potrebbe non restituire esattamente la stessa risposta dell’operazione sum eseguita sul corrispondente array numerico. La differenza potrebbe essere rilevante quando A è di tipo a numero intero con segno e il suo prodotto è accumulato in modo nativo.

Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

R2023a: Specifica della condizione di valore mancante

Includere o omettere i valori mancanti nell'array di input quando si calcola la somma utilizzando le opzioni "includemissing" o "omitmissing". Queste opzioni hanno rispettivamente lo stesso comportamento delle opzioni "includenan" e "omitnan".

R2023a: Esecuzione di calcoli direttamente su tabelle e orari

La funzione sum può eseguire calcoli su tutte le variabili all’interno di una tabella o di un orario senza dover eseguire indicizzazioni per accedere a tali variabili. Tutte le variabili devono avere tipi di dati che supportino il calcolo. Per maggiori informazioni, vedere Direct Calculations on Tables and Timetables.

R2018b: Interventi su più dimensioni

Intervenire su più dimensioni dell'array di input alla volta. Specificare un vettore di dimensioni operative o specificare l'opzione "all" per intervenire su tutte le dimensioni dell’array.

Vedi anche

cumsum | diff | mean | prod