...
Eroare Python pentru analiza datelor · Coloane, selecție și filtrare

IndexError: single positional indexer is out-of-bounds

Pe scurt

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

Greșit
PYTHON
rez = df[df["oras"] == "Constanța"]
print(rez.iloc[0]["nume"])
Corect
PYTHON
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

Greșit
PYTHON
# tabel cu 5 rânduri
ultimul = df.iloc[5]
Corect
PYTHON
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ă

Greșit
PYTHON
# 3 coloane: produs, cantitate, pret
pret = df.iloc[:, 3]
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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)}")
După reparație, programul afișează
Cluj: Ana Pop
Constanța: niciun client
Iași: Ion Toma
Indiciu

Verifică rez.empty înainte de rez.iloc[0].

Alte forme ale mesajului

  • IndexError: positional indexers are out-of-bounds
  • IndexError: 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] și iloc[-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) sau head(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

← 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.