API · Pandas

Fonction Pandas DataFrame.resample()

La méthode DataFrame.resample() regroupe les observations indexées par date en intervalles de fréquence afin de les agréger.

Sur cette page

En Python, DataFrame.resample() regroupe les observations indexées par date en intervalles de fréquence, que vous pouvez ensuite agréger, par exemple en calculant une somme par semaine ou par mois.

Syntaxe de pandas.DataFrame.resample()

La méthode appliquée à un DataFrame rééchantillonne ses lignes à partir d’un index de type date/heure. Elle peut aussi utiliser une colonne ou un niveau d’index de ce type, sélectionné avec on ou level. La signature exacte varie selon la version de pandas ; l’appel de base est df.resample(rule, ...), où rule définit la fréquence cible. Aucune version de pandas n’étant indiquée ici, les paramètres et valeurs par défaut propres à une version sont volontairement omis.

Paramètres

Paramètre Rôle
rule Règle de fréquence qui définit les intervalles cibles.
closed Détermine quel côté de chaque intervalle est inclus.
label Détermine quelle borne de l’intervalle sert d’étiquette au résultat.
on Sélectionne une colonne de type date/heure du DataFrame à la place de l’index.
level Sélectionne un niveau de type date/heure d’un MultiIndex.
origin et offset Ajustent le début des intervalles ; les valeurs acceptées et leur comportement dépendent de la version de pandas.

Valeur renvoyée

resample() renvoie un objet de rééchantillonnage. Vous pouvez lui enchaîner une agrégation, telle que .sum(), pour obtenir un résultat par intervalle. DataFrame.resample() s’applique à un DataFrame ; les exemples ci-dessous portent sur une Series et appellent donc Series.resample(). Ces exemples n’ont pas été exécutés dans le cadre fourni : aucune version de pandas ni preuve d’exécution n’est disponible, et aucun résultat observé n’est donc affirmé.

Exemple de rééchantillonnage hebdomadaire d’une Series

Cette Series contient une valeur pour chaque date du 1er au 30 janvier 2021. La règle hebdomadaire répartit ces valeurs quotidiennes en intervalles d’une semaine, puis .sum() additionne les valeurs de chaque intervalle. Avec la règle qui termine les semaines le dimanche, les étiquettes correspondent aux dimanches de fin d’intervalle. Le premier et le dernier intervalle sont partiels : les dates fournies commencent un vendredi et s’arrêtent un samedi.

import pandas as pd

dates = pd.date_range("2021-01-01", periods=30, freq="D")
daily = pd.Series(range(30), index=dates)
weekly_totals = daily.resample("W").sum()
print(weekly_totals)

Cet extrait n’a pas été exécuté ; il montre l’opération sur une Series et les données nécessaires pour adapter l’agrégation.

Exemple de rééchantillonnage mensuel d’une Series

La même Series quotidienne peut être regroupée par mois civil, puis additionnée. Le code calcule la somme des observations fournies du 1er au 30 janvier : les valeurs vont de 0 à 29 et leur somme est 435. Il ne s’agit pas d’un agrégat couvrant tout le mois, car les données ne comprennent pas le 31 janvier. MonthEnd() exprime une règle de fin de mois sans dépendre d’un alias de fréquence dont la prise en charge peut varier selon la version de pandas.

import pandas as pd

dates = pd.date_range("2021-01-01", periods=30, freq="D")
daily = pd.Series(range(30), index=dates)
monthly_totals = daily.resample(pd.offsets.MonthEnd()).sum()
print(monthly_totals)

Cet extrait n’a pas été exécuté ; le résultat est décrit à partir des valeurs fournies, sans affirmer de formatage propre à une version de pandas.