sábado, 24 de abril de 2021

Python - Utilizando o método Series.cummin() para encontrar o mínimo cumulativo de uma série

O método Series.cummin() é usado para encontrar o mínimo cumulativo de uma série. No mínimo cumulativo, o comprimento da série retornada é o mesmo da série de entrada e cada elemento é igual ao menor entre o elemento atual e o elemento anterior.

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

Parâmetros:

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

Tipo de retorno: Series

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

# importa o módulo pandas
import pandas as pd

# importa o módulo numpy
import numpy as np 

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

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

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

# mostrando o resultado
print(cummin)

Saída:

0    3.0
1    3.0
2    NaN
3    3.0
4    2.0
5    0.0
dtype: float64

Explicação: Series.cummin() é uma comparação do valor atual com o valor anterior. O primeiro elemento é sempre igual ao primeiro da série do chamador.

3
3  (3<4)
NaN (Não pode ser comparado com valores inteiros)
3  (3<7)
2  (2<3)
0  (0<2)

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 comparados sempre que ocorrer.

# importa o módulo pandas
import pandas as pd

# importa o módulo numpy
import numpy as np 

# criando uma lista de valores
values = [12, 4, 33, np.nan, 0, 1, 76, 5]

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

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

# mostrando o resultado
print(cummin)

Saída:

0    12.0
1     4.0
2     4.0
3     NaN
4     NaN
5     NaN
6     NaN
7     NaN
dtype: float64

Explicação: Assim como no exemplo acima, o mínimo dos valores atuais e anteriores foram armazenados em todas as posições até que NaN ocorresse. Uma vez que NaN comparado com qualquer coisa retorna NaN e o parâmetro skipna é mantido como False, o mínimo cumulativo após sua ocorrência é NaN devido à comparação de todos os valores com NaN.

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

Licença

0 comentários:

Postar um comentário