...
Eroare Python pentru analiza datelor · Grafice cu matplotlib

ValueError: num must be an integer with 1 <= num <= 4, not 5

Pe scurt

plt.subplot(rânduri, coloane, num) numără pozițiile de la 1, iar grila ta are doar rânduri × coloane locuri (aici 2 × 2 = 4). Ai cerut poziția 5 (sau 0). Mărește grila sau folosește fig, axs = plt.subplots(2, 3) și alege axs[r, c].

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

Ce înseamnă

plt.subplot(2, 2, 3) înseamnă „grilă de 2 rânduri și 2 coloane, al treilea grafic”. Pozițiile se numără de la 1 (nu de la 0, ca în restul Python), de la stânga la dreapta și de sus în jos, până la rânduri × coloane. Mesajul îți spune exact intervalul permis (1 <= num <= 4) și ce ai dat.

Cazuri tipice: o buclă for i in range(n) care pornește de la 0 (num=0) sau trece peste numărul de locuri; o grilă prea mică pentru numărul de coloane pe care vrei să le desenezi; numărul de grafice care crește odată cu datele.

Același mesaj apare și la fig.add_subplot(...). Calculează grila din numărul de grafice și folosește enumerate(..., start=1).

De ce apare: cauzele frecvente

1Buclă care pornește de la 0

Greșit
PYTHON
for i, col in enumerate(coloane):
    plt.subplot(2, 2, i)
Corect
PYTHON
for i, col in enumerate(coloane, start=1):
    plt.subplot(2, 2, i)

start=1 face numărătoarea să înceapă de la 1, ca pozițiile lui subplot.

2Grila e prea mică pentru numărul de grafice

Greșit
PYTHON
for i, col in enumerate(["ian", "feb", "mar", "apr", "mai"], start=1):
    plt.subplot(2, 2, i)
Corect
PYTHON
luni = ["ian", "feb", "mar", "apr", "mai"]
for i, col in enumerate(luni, start=1):
    plt.subplot(2, 3, i)

5 grafice au nevoie de cel puțin 5 locuri: o grilă 2 × 3 are 6.

3Varianta fără numere de poziție

Greșit
PYTHON
plt.subplot(2, 2, 5)
Corect
PYTHON
fig, axs = plt.subplots(2, 3)
for ax, col in zip(axs.flat, coloane):
    ax.plot(df[col])

axs.flat parcurge toate axele grilei, fără să numeri pozițiile.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos desenează câte un grafic pentru fiecare dintre cele 5 luni într-o grilă de 2 × 2 și dă ValueError: num must be an integer with 1 <= num <= 4, not 5. Repară grila ca să încapă toate lunile și să afișeze câte grafice au fost create.

Codul care dă eroarea
PYTHON
import matplotlib.pyplot as plt

vanzari = {"ian": [3, 5, 4], "feb": [6, 2, 7], "mar": [4, 4, 5], "apr": [8, 6, 9], "mai": [5, 7, 6]}

plt.figure()
for i, (luna, valori) in enumerate(vanzari.items(), start=1):
    plt.subplot(2, 2, i)
    plt.plot(valori)
    plt.title(luna)
print(len(plt.gcf().axes))
După reparație, programul afișează
5
Indiciu

5 grafice au nevoie de o grilă cu cel puțin 5 locuri, de exemplu 2 × 3.

Alte forme ale mesajului

  • ValueError: num must be an integer with 1 <= num <= 4, not 0
  • ValueError: num must be an integer with 1 <= num <= 6, not 7

Cum o eviți pe viitor

  • Calculează grila din numărul de grafice: randuri = math.ceil(n / coloane).
  • La plt.subplot numără de la 1, cu enumerate(..., start=1).
  • Preferă fig, axs = plt.subplots(r, c) și axs.flat: nu mai lucrezi cu numere de poziție.
  • Ascunde axele nefolosite cu ax.set_visible(False).

Întrebări frecvente

De ce de la 1 și nu de la 0?

Convenția vine din MATLAB, pe care s-a inspirat matplotlib. E o excepție față de restul Python, de aceea plt.subplots și axs[r, c] (care numără de la 0) sunt mai ușor de folosit corect.

Ce înseamnă plt.subplot(221)?

E forma scurtă pentru plt.subplot(2, 2, 1): cele trei cifre sunt rânduri, coloane, poziție. Merge doar când toate trei sunt sub 10.

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.