KeyError: 0
Ai cerut rândul cu eticheta 0 (cu loc sau cu s[0]), dar indexul nu conține 0, de exemplu după o filtrare sau când indexul e format din texte. Pentru „primul rând” folosește poziția: df.iloc[0] sau s.iloc[0]; altfel, resetează indexul cu reset_index(drop=True).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În pandas, fiecare rând are o etichetă (indexul) și o poziție (0, 1, 2...). La un DataFrame proaspăt creat cele două coincid, de aceea df.loc[0] pare să însemne „primul rând”. După o filtrare însă, rândurile își păstrează etichetele originale: dacă primul rând care trece filtrul are eticheta 3, nu mai există eticheta 0, iar df.loc[0] dă KeyError: 0.
La fel se întâmplă cu o Series care are ca index texte (de exemplu rezultatul unui groupby sau value_counts): în pandas 3, s[0] caută eticheta 0, nu prima poziție, deci dă KeyError: 0. În versiunile vechi funcționa, cu un avertisment că se va schimba. Tot KeyError: 0 primești și cu df[0], pentru că acolo pandas caută o coloană numită 0.
Regula: loc și parantezele simple lucrează cu etichete, iloc lucrează cu poziții.
De ce apare: cauzele frecvente
1loc[0] după o filtrare
scumpe = df[df["pret"] > 100]
print(scumpe.loc[0, "produs"])scumpe = df[df["pret"] > 100]
print(scumpe.iloc[0]["produs"])Filtrarea păstrează etichetele originale ale rândurilor. iloc[0] ia primul rând după poziție, indiferent de etichetă.
2s[0] pe o Series cu index de text
pe_oras = df.groupby("oras")["suma"].sum().sort_values(ascending=False)
print(pe_oras[0])pe_oras = df.groupby("oras")["suma"].sum().sort_values(ascending=False)
print(pe_oras.iloc[0], pe_oras.index[0])Indexul sunt numele orașelor, deci eticheta 0 nu există. iloc[0] dă valoarea de pe primul loc, iar index[0] dă numele orașului.
3Renumerotare după filtrare
activi = df[df["activ"]]
for i in range(len(activi)):
print(activi.loc[i, "nume"])activi = df[df["activ"]].reset_index(drop=True)
for i in range(len(activi)):
print(activi.loc[i, "nume"])reset_index(drop=True) renumerotează rândurile 0, 1, 2..., deci etichetele coincid din nou cu pozițiile.
Repară eroarea, direct în pagină
Codul de mai jos filtrează produsele scumpe și vrea să afișeze cel mai scump produs și prețul lui, dar dă KeyError: 0. Repară-l ca să ia primul rând din rezultatul sortat după poziție, nu după etichetă.
import pandas as pd
df = pd.DataFrame({
"produs": ["Mouse", "Laptop", "Cablu", "Monitor", "Tastatură"],
"pret": [45, 3200, 15, 950, 120],
})
scumpe = df[df["pret"] > 100].sort_values("pret", ascending=False)
primul = scumpe.loc[0]
print(f"Cel mai scump: {primul['produs']} ({primul['pret']} lei)")
print(f"Produse peste 100 lei: {len(scumpe)}")Cel mai scump: Laptop (3200 lei) Produse peste 100 lei: 3
Indiciu
Primul rând după poziție se ia cu iloc[0].
Reparația
import pandas as pd
df = pd.DataFrame({
"produs": ["Mouse", "Laptop", "Cablu", "Monitor", "Tastatură"],
"pret": [45, 3200, 15, 950, 120],
})
scumpe = df[df["pret"] > 100].sort_values("pret", ascending=False)
primul = scumpe.iloc[0]
print(f"Cel mai scump: {primul['produs']} ({primul['pret']} lei)")
print(f"Produse peste 100 lei: {len(scumpe)}")De ce merge
După filtrare au rămas rândurile cu etichetele 1, 3 și 4, iar sortarea le-a pus în ordinea 1, 3, 4. Eticheta 0 (Mouse) nu mai e în tabel, de aceea loc[0] dădea KeyError. iloc[0] ia primul rând după poziție, adică Laptopul, care e pe primul loc după sortare.
Alte forme ale mesajului
KeyError: 5FutureWarning: Series.__getitem__ treating keys as positions is deprecated. In a future version, integer keys will always be treated as labels (consistent with DataFrame behavior). To access a value by position, use `ser.iloc[pos]`
Cum o eviți pe viitor
- Când vrei „al n-lea rând”, folosește mereu
iloc; când vrei „rândul cu eticheta X”, foloseșteloc. - După filtrări, dacă vrei numerotare de la 0, adaugă
reset_index(drop=True). - Pentru primul sau ultimul element al unui rezultat sortat,
s.iloc[0]șis.index[0]sunt mai clare decâts[0]. - Evită buclele
for i in range(len(df)): de cele mai multe ori o operație pe coloane face același lucru fără indici.
Întrebări frecvente
De ce codul mergea într-o versiune mai veche de pandas?
Până la pandas 2.x, s[0] pe o Series cu index de text era interpretat ca poziție, cu un FutureWarning. În pandas 3, parantezele simple folosesc mereu etichetele, deci același cod dă KeyError: 0. Reparația e s.iloc[0].
Care e diferența între KeyError: 0 și IndexError: single positional indexer is out-of-bounds?
KeyError vine de la loc sau [] și înseamnă „nu există eticheta”. IndexError vine de la iloc și înseamnă „nu există poziția”, de exemplu iloc[10] într-un tabel cu 5 rânduri.
Erori înrudite
IndexError: single positional indexer is out-of-bounds Ai cerut cu iloc o poziție care nu există: tabelul are mai puține rânduri (sau coloane) decât crezi, de multe ori pentru că e gol după o filtrare. Verifică len(df) înainte și tratează separat cazul în care nu a rămas niciun rând. KeyError: 'Pret' DataFrame-ul nu are o coloană cu exact numele 'Pret'. Coloanele sunt sensibile la majuscule, spații și diacritice: afișează print(df.columns.tolist()) și folosește numele exact, de exemplu df["pret"]. ValueError: The truth value of a Series is ambiguous. Use a.empty, a.bool(), a.item(), a.any() or a.all(). Ai pus o coloană întreagă (o Series cu multe True/False) acolo unde Python așteaptă un singur True sau False: în if, sau cu and / or între două condiții. În filtre folosește & și | cu fiecare condiție între paranteze; în if folosește .any() sau .all(). Î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.
