...
Eroare Python pentru analiza datelor · Coloane noi și valori lipsă

TypeError: NDFrame.fillna() got an unexpected keyword argument 'method'

Pe scurt

În pandas 3, fillna nu mai are parametrul method. În loc de fillna(method="ffill") scrie ffill(), iar în loc de fillna(method="bfill") scrie bfill(). fillna rămâne pentru valori fixe, de exemplu fillna(0).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mult cod din tutoriale și de pe forumuri completează lipsurile cu valoarea anterioară prin fillna(method="ffill") („forward fill”) sau cu cea următoare prin fillna(method="bfill"). În pandas 2.1 forma asta a devenit învechită, cu un FutureWarning, iar în pandas 3 parametrul a fost scos de tot. Python îți spune că funcția fillna (definită în clasa de bază NDFrame, comună pentru DataFrame și Series) a primit un argument pe care nu îl cunoaște.

Înlocuirea e directă: ffill() și bfill() sunt metode separate, care acceptă și limit= (câte lipsuri la rând completezi). Dacă ai groupby, folosește df.groupby("client")["col"].ffill(), ca să nu treci valori de la un client la altul.

De ce apare: cauzele frecvente

1Completare cu valoarea anterioară

Greșit
PYTHON
df["pret"] = df["pret"].fillna(method="ffill")
Corect
PYTHON
df["pret"] = df["pret"].ffill()

ffill() copiază ultima valoare cunoscută peste lipsurile care urmează, exact ce făcea method="ffill".

2Completare cu valoarea următoare

Greșit
PYTHON
df = df.fillna(method="bfill")
Corect
PYTHON
df = df.bfill()

bfill() ia prima valoare cunoscută de după lipsă.

3Completare în cadrul fiecărui grup

Greșit
PYTHON
df["stoc"] = df["stoc"].fillna(method="ffill")   # trece de la un produs la altul
Corect
PYTHON
df["stoc"] = df.groupby("produs")["stoc"].ffill()

Cu groupby, completarea se face separat pentru fiecare produs, deci un produs nu primește stocul altuia.

Repară tu

Repară eroarea, direct în pagină

Cursul valutar nu se publică în weekend, iar zilele fără curs trebuie să ia cursul din ultima zi lucrătoare. Codul de mai jos folosește forma veche fillna(method="ffill") și dă TypeError. Repară-l ca să afișeze cursurile completate și media lor, cu patru zecimale.

Codul care dă eroarea
PYTHON
import pandas as pd
import numpy as np

curs = pd.Series(
    [4.9712, np.nan, np.nan, 4.9741, 4.9735],
    index=["vineri", "sâmbătă", "duminică", "luni", "marți"],
)

complet = curs.fillna(method="ffill")
print(complet)
print(f"Media: {complet.mean():.4f}")
După reparație, programul afișează
vineri      4.9712
sâmbătă     4.9712
duminică    4.9712
luni        4.9741
marți       4.9735
dtype: float64
Media: 4.9722
Indiciu

Înlocuiește fillna(method="ffill") cu metoda ffill().

Alte forme ale mesajului

  • TypeError: DataFrame.fillna() got an unexpected keyword argument 'method'
  • FutureWarning: Series.fillna with 'method' is deprecated and will raise in a future version. Use obj.ffill() or obj.bfill() instead.
  • FutureWarning: DataFrame.fillna with 'method' is deprecated and will raise in a future version. Use obj.ffill() or obj.bfill() instead.

Cum o eviți pe viitor

  • Folosește ffill() / bfill() pentru completare din vecini și fillna(valoare) pentru valori fixe.
  • Când copiezi cod din tutoriale mai vechi, uită-te la versiunea de pandas pentru care a fost scris și citește avertismentele FutureWarning: ele anunță exact erorile din versiunea următoare.
  • Sortează datele înainte de ffill (de exemplu după dată), altfel „valoarea anterioară” nu are sens.

Întrebări frecvente

Ce versiune de pandas am?

Rulează import pandas as pd; print(pd.__version__). De la 3.0, parametrul method din fillna nu mai există. În 2.1 și 2.2 merge, dar cu FutureWarning.

Mai pot folosi fillna(0)?

Da. fillna rămâne metoda pentru completarea cu o valoare fixă, cu o valoare diferită pe fiecare coloană (fillna({"cantitate": 0, "oras": "necunoscut"})) sau cu o Series (de exemplu media fiecărui grup).

Erori înrudite

← Toate erorile Python pentru analiza datelor

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Python pentru analiza datelor de la zero, cu exerciții la fiecare lecție

Curs Data Analysis with Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.