...
Eroare Python pentru analiza datelor · NumPy: forme și tipuri

IndexError: index 5 is out of bounds for axis 0 with size 5

Pe scurt

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.

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

Ce înseamnă

Mesajul are trei informații: indicele cerut (5), axa (axis 0 înseamnă primul nivel de indexare: elementele unui vector sau rândurile unei matrice) și mărimea acelei axe (size 5). Indicii pornesc de la 0, deci un tablou cu 5 elemente are indicii 0, 1, 2, 3, 4, iar 5 e deja în afară.

Cauzele tipice: o buclă for i in range(1, len(a) + 1) scrisă ca în matematică, accesul la „elementul următor” (a[i + 1]) pe ultima poziție, un indice calculat (de exemplu luna 12 folosită direct ca indice într-un tablou de 12 luni), sau un tablou mai scurt decât crezi după o filtrare. Pentru matrice, axis 1 înseamnă că problema e la coloane.

În listele Python, mesajul echivalent este IndexError: list index out of range.

De ce apare: cauzele frecvente

1Buclă care numără de la 1

Greșit
PYTHON
a = np.array([4, 8, 15, 16, 23])
for i in range(1, len(a) + 1):
    print(a[i])
Corect
PYTHON
a = np.array([4, 8, 15, 16, 23])
for i in range(len(a)):
    print(a[i])

range(len(a)) dă exact 0..4. Și mai simplu: for x in a: print(x).

2Diferența cu elementul următor

Greșit
PYTHON
for i in range(len(a)):
    print(a[i + 1] - a[i])
Corect
PYTHON
print(np.diff(a))   # sau a[1:] - a[:-1]

Ultima poziție nu are „următor”. np.diff calculează toate diferențele consecutive, fără indici.

3Luna (1–12) folosită ca indice (0–11)

Greșit
PYTHON
vanzari_lunare = np.zeros(12)
vanzari_lunare[12] += 500   # decembrie
Corect
PYTHON
vanzari_lunare = np.zeros(12)
vanzari_lunare[12 - 1] += 500

Lunile se numără de la 1, indicii de la 0, deci decembrie are indicele 11.

Repară tu

Repară eroarea, direct în pagină

Codul calculează creșterea zilnică a vânzărilor (ziua următoare minus ziua curentă), dar pe ultima zi dă IndexError: index 5 is out of bounds for axis 0 with size 5. Repară-l folosind np.diff, ca să afișeze cele 4 creșteri și creșterea maximă.

Codul care dă eroarea
PYTHON
import numpy as np

vanzari = np.array([120, 135, 128, 160, 172])

cresteri = []
for i in range(len(vanzari)):
    cresteri.append(vanzari[i + 1] - vanzari[i])
cresteri = np.array(cresteri)

print("Creșteri:", cresteri)
print("Maxim:", cresteri.max())
După reparație, programul afișează
Creșteri: [15 -7 32 12]
Maxim: 32
Indiciu

np.diff(vanzari) calculează direct diferențele dintre elementele consecutive.

Alte forme ale mesajului

  • IndexError: index 3 is out of bounds for axis 1 with size 3
  • IndexError: index 0 is out of bounds for axis 0 with size 0
  • IndexError: index -6 is out of bounds for axis 0 with size 5

Cum o eviți pe viitor

  • Preferă operațiile pe tot tabloul (a * 2, np.diff(a), a[a > 10]) în locul buclelor cu indici.
  • Când ai nevoie de indici, folosește range(len(a)) sau enumerate(a).
  • Pentru primul și ultimul element, scrie a[0] și a[-1].
  • Verifică a.shape după filtrări: un tablou gol (size 0) nu are nici indicele 0.

Întrebări frecvente

Ce înseamnă „axis 0” și „axis 1”?

La o matrice, axa 0 sunt rândurile și axa 1 coloanele. m[5, 0] pe o matrice cu 5 rânduri dă eroarea pe axa 0; m[0, 3] pe o matrice cu 3 coloane, pe axa 1.

De ce indicii negativi merg?

a[-1] înseamnă ultimul element, a[-2] penultimul. Merg până la -len(a); dincolo de asta primești aceeași eroare, de exemplu index -6 pentru un tablou cu 5 elemente.

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.