...
Eroare Python pentru analiza datelor · Intervale și categorii: cut, qcut

ValueError: bins must increase monotonically.

Pe scurt

Marginile date la pd.cut (bins=) nu sunt în ordine crescătoare: o margine e mai mică decât cea dinaintea ei, de obicei din cauza unei greșeli de tastare (2000 în loc de 200) sau a unei liste construite în altă ordine. Scrie marginile crescător, de la cea mai mică la cea mai mare.

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

Ce înseamnă

pd.cut construiește intervalele între margini consecutive: bins=[0, 50, 200, 1000] dă (0, 50], (50, 200], (200, 1000]. Asta are sens doar dacă fiecare margine e mai mare decât cea dinainte. Dacă lista e [0, 500, 200, 1000], intervalul (500, 200] nu există, iar pandas ridică bins must increase monotonically („marginile trebuie să crească”).

Cauzele tipice: o cifră în plus sau în minus la o margine, marginile scrise în ordinea etichetelor (de la „scump” la „ieftin”), o listă construită din valori calculate ([0, medie, maxim], unde media poate fi mai mare decât un prag fix pus după ea) sau două margini egale.

Afișează lista și verifică: bins == sorted(bins) și fără valori repetate.

De ce apare: cauzele frecvente

1Greșeală de tastare la o margine

Greșit
PYTHON
pd.cut(df["pret"], bins=[0, 500, 200, 1000], labels=["ieftin", "mediu", "scump"])
Corect
PYTHON
pd.cut(df["pret"], bins=[0, 50, 200, 1000], labels=["ieftin", "mediu", "scump"])

Marginile trebuie să crească strict: 0 < 50 < 200 < 1000.

2Marginile scrise descrescător

Greșit
PYTHON
pd.cut(df["varsta"], bins=[100, 65, 18, 0], labels=["senior", "adult", "copil"])
Corect
PYTHON
pd.cut(df["varsta"], bins=[0, 18, 65, 100], labels=["copil", "adult", "senior"])

Ordinea marginilor e mereu crescătoare, iar etichetele urmează aceeași ordine.

3Margini calculate care se încrucișează

Greșit
PYTHON
bins = [0, df["pret"].median(), 100, df["pret"].max()]
Corect
PYTHON
bins = sorted({0, df["pret"].median(), 100, df["pret"].max()})

sorted pe un set pune marginile în ordine și elimină dublurile; verifică însă că numărul de etichete se potrivește.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă ValueError: bins must increase monotonically.. Pragurile corecte sunt 0, 50, 200 și 1000 de lei, dar unul a fost tastat greșit. Repară marginile ca să afișeze categoria fiecărui produs.

Codul care dă eroarea
PYTHON
import pandas as pd

df = pd.DataFrame({
    "produs": ["Cană", "Lampă", "Scaun", "Pix"],
    "pret": [35, 120, 260, 5],
})

df["categorie"] = pd.cut(df["pret"], bins=[0, 500, 200, 1000], labels=["ieftin", "mediu", "scump"])
print(df["categorie"].tolist())
După reparație, programul afișează
['ieftin', 'mediu', 'scump', 'ieftin']
Indiciu

Marginea a doua trebuie să fie 50, nu 500.

Alte forme ale mesajului

  • ValueError: bins must increase monotonically.

Cum o eviți pe viitor

  • Scrie marginile mereu de la mic la mare, iar etichetele în aceeași ordine.
  • Când marginile sunt calculate, afișează lista înainte de pd.cut.
  • O verificare simplă în cod: assert bins == sorted(bins).
  • Pentru intervale cu același număr de valori, folosește pd.qcut, care calculează singur marginile.

Întrebări frecvente

Pot da bins ca număr în loc de listă?

Da: pd.cut(df["pret"], bins=3) împarte intervalul dintre minim și maxim în 3 bucăți egale. Marginile sunt calculate de pandas, deci sunt mereu crescătoare.

Ce se întâmplă cu două margini egale?

Tot o eroare: două margini egale ar forma un interval gol. La pd.cut primești acest mesaj, iar la pd.qcut apare Bin edges must be unique.

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.