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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
iloc lucrează cu poziții: iloc[0] e primul rând, iloc[-1] ultimul, iar pozițiile valide merg de la 0 la len(df) - 1. Mesajul spune că poziția cerută („single positional indexer”, adică un singur număr) e în afara acestui interval („out-of-bounds”).
Cel mai des apare la df[filtru].iloc[0] când filtrul nu găsește nimic: DataFrame-ul rezultat are 0 rânduri, deci nici poziția 0 nu există. Apare și când confunzi numărul rândului cu poziția (rândul 5 dintr-un tabel de 5 e iloc[4]) sau când aplici iloc pe coloane (df.iloc[:, 7] într-un tabel cu 5 coloane).
Citește linia indicată în stivă și afișează len(...) sau shape pentru obiectul pe care aplici iloc.
De ce apare: cauzele frecvente
1Filtrul nu a găsit niciun rând
rez = df[df["oras"] == "Constanța"]
print(rez.iloc[0]["nume"])rez = df[df["oras"] == "Constanța"]
if rez.empty:
print("Niciun client din Constanța")
else:
print(rez.iloc[0]["nume"])Un DataFrame gol nu are poziția 0. rez.empty îți spune dacă a rămas ceva după filtrare.
2Poziția numărată de la 1
# tabel cu 5 rânduri
ultimul = df.iloc[5]ultimul = df.iloc[-1] # sau df.iloc[len(df) - 1]Pozițiile încep de la 0, deci al cincilea rând are poziția 4. -1 înseamnă mereu ultimul rând.
3Coloană cerută după poziție greșită
# 3 coloane: produs, cantitate, pret
pret = df.iloc[:, 3]pret = df.iloc[:, 2] # sau, mai clar: df["pret"]Coloanele au și ele poziții de la 0. Pentru coloane, numele e mai sigur decât poziția.
Repară eroarea, direct în pagină
Funcția primul_client caută primul client dintr-un oraș, dar pentru Constanța, unde nu există clienți, codul dă IndexError: single positional indexer is out-of-bounds. Repară funcția ca să întoarcă textul niciun client când filtrul nu găsește nimic.
import pandas as pd
df = pd.DataFrame({
"nume": ["Ana Pop", "Ion Toma", "Maria Dinu"],
"oras": ["Cluj", "Iași", "Cluj"],
})
def primul_client(oras):
rez = df[df["oras"] == oras]
return rez.iloc[0]["nume"]
for oras in ["Cluj", "Constanța", "Iași"]:
print(f"{oras}: {primul_client(oras)}")Cluj: Ana Pop Constanța: niciun client Iași: Ion Toma
Indiciu
Verifică rez.empty înainte de rez.iloc[0].
Reparația
import pandas as pd
df = pd.DataFrame({
"nume": ["Ana Pop", "Ion Toma", "Maria Dinu"],
"oras": ["Cluj", "Iași", "Cluj"],
})
def primul_client(oras):
rez = df[df["oras"] == oras]
if rez.empty:
return "niciun client"
return rez.iloc[0]["nume"]
for oras in ["Cluj", "Constanța", "Iași"]:
print(f"{oras}: {primul_client(oras)}")De ce merge
Pentru Constanța, filtrul df["oras"] == oras nu e adevărat pe niciun rând, deci rez are 0 rânduri și poziția 0 nu există. rez.empty este True exact în acest caz, așa că funcția întoarce mesajul înainte să ajungă la iloc[0]. Pentru Cluj și Iași, comportamentul rămâne același.
Alte forme ale mesajului
IndexError: positional indexers are out-of-boundsIndexError: index 0 is out of bounds for axis 0 with size 0
Cum o eviți pe viitor
- Înainte de
iloc[0]pe un rezultat filtrat, verificăif not rez.empty. - Pentru primul sau ultimul rând, preferă
iloc[0]șiiloc[-1]în loc de poziții calculate. - Pentru coloane, folosește numele (
df["pret"]), nu poziția: ordinea coloanelor se schimbă ușor. - Când cauți un singur rând după o condiție, poți folosi și
idxmax,nlargest(1)sauhead(1), care nu dau eroare pe tabel gol.
Întrebări frecvente
De ce primesc eroarea doar pentru unele valori?
Pentru că doar pentru unele valori filtrul nu găsește nimic. De exemplu, un oraș fără clienți sau o lună fără vânzări. Codul merge pe datele de test și pică pe datele reale, de aceea tratează explicit cazul gol.
head(1) nu e același lucru cu iloc[0]?
Aproape: head(1) întoarce un DataFrame cu cel mult un rând (gol, dacă nu există), în timp ce iloc[0] întoarce rândul ca Series și dă eroare pe tabel gol.
Erori înrudite
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). IndexError: index 5 is out of bounds for axis 0 with size 5 Ai cerut elementul cu indicele 5 dintr-un tablou NumPy cu 5 elemente, ale cărui indici valizi sunt 0–4. De obicei bucla merge până la len(a) inclusiv sau numără de la 1. Folosește range(len(a)), a[-1] pentru ultimul element sau, mai bine, operații vectorizate fără indici. 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.
