Python - Series.cumsum() para encontrar a soma cumulativa de uma série do pandas

O método Series.cumsum() do pandas é usado para encontrar a soma cumulativa de uma série. Na soma cumulativa, o comprimento da série retornada é igual à entrada e cada elemento é igual à soma de todos os elementos anteriores.

Sintaxe: Series.cumsum(axis=None, skipna=True)

Parâmetros:

• axis: 0 ou 'índice' para operação em linha e 1 ou 'colunas' para operação em coluna.
• skipna: Ignora a adição de NaN para elementos após o próximo se True.

Tipo de retorno: Series

Exemplo #1: Neste exemplo, uma série é criada a partir de uma lista python usando o método pandas.Series(). A lista também contém um valor Nulo e o parâmetro skipna é mantido como padrão, ou seja, True.

# importando o módulo pandas
import pandas as pd

# importando o módulo numpy
import numpy as np

# criando uma lista de valores
values = [3, 4, np.nan, 7, 2, 0]

# Criando uma Series a partir de uma lista
series = pd.Series(values)

# chamando o método cumsum
cumsum = series.cumsum()

# imprimindo o resultado da chamada da função cumsum
print(cumsum)

Saída:

0     3.0     
1     7.0     
2     NaN     
3    14.0     
4    16.0     
5    16.0     
dtype: float64

Explicação: A soma cumulativa é a soma dos valores atuais e de todos os valores anteriores. Conforme mostrado na saída acima, a adição foi feita da seguinte forma:

3
3+4 = 7
7+NaN = NaN
7+7 = 14
14+2 = 16
16+0 = 16

Exemplo #2: skipna=False. Neste exemplo, uma série é criada como no exemplo acima. Mas o parâmetro skipna é mantido como False. Portanto, os valores NULL não serão ignorados e serão adicionados todas as vezes após sua ocorrência.

# importando o módulo pandas
import pandas as pd

# importando o módulo numpy
import numpy as np

# criando uma lista de valores
values = [3, 4, np.nan, 7, 2, 0]

# Criando uma Series a partir de uma lista
series = pd.Series(values)

# chamando o método cumsum
cumsum = series.cumsum(skipna=False)

# imprimindo o resultado da chamada da função cumsum
print(cumsum)

Saída:

0    3.0
1    7.0
2    NaN
3    NaN
4    NaN
5    NaN
dtype: float64

Explicação: Como pode ser visto na saída, todos os valores após a primeira ocorrência de NaN também são NaN, pois qualquer número + NaN também é NaN.

Artigo escrito por Kartikaybhutani e traduzido por Acervolima de Python | Pandas Series.cumsum() to find cumulative sum of a Series.

Licença

• CCBY-SA

<< Anterior Próximo >>