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

ValueError: Bin labels must be one fewer than the number of bin edges

Pe scurt

La pd.cut, lista labels trebuie să aibă cu un element mai puțin decât lista bins: 4 margini fac 3 intervale, deci 3 etichete. Numără marginile și etichetele; de obicei lipsește o margine (prima sau ultima) sau ai o etichetă în plus.

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

Ce înseamnă

pd.cut(valori, bins=[0, 50, 200, 1000]) împarte axa în intervale între margini consecutive: (0, 50], (50, 200], (200, 1000]. Patru margini = trei intervale. labels dă câte un nume pentru fiecare interval, deci trebuie să aibă exact trei elemente.

Mesajul „Bin labels must be one fewer than the number of bin edges” = numărul de etichete trebuie să fie numărul de margini minus unu. Apare când ai uitat una dintre margini (de obicei prima, 0, sau ultima, valoarea maximă / float("inf")), sau ai adăugat o categorie nouă în labels fără să adaugi și marginea ei.

Verificare rapidă: len(labels) == len(bins) - 1.

De ce apare: cauzele frecvente

1Lipsește marginea de jos

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

Cu marginea 0 adăugată, sunt 4 margini și 3 intervale, câte unul pentru fiecare etichetă.

2Lipsește marginea de sus

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

float("inf") închide ultimul interval, ca orice valoare peste 65 să intre la „senior”.

3O etichetă în plus

Greșit
PYTHON
pd.cut(note, bins=[0, 5, 10], labels=["picat", "trecut", "excelent"])
Corect
PYTHON
pd.cut(note, bins=[0, 4.99, 8.99, 10], labels=["picat", "trecut", "excelent"])

Pentru trei categorii ai nevoie de trei intervale, adică patru margini.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă ValueError: Bin labels must be one fewer than the number of bin edges. Produsele se împart în ieftine (până la 50 de lei), medii (50–200) și scumpe (peste 200). Adaugă marginea lipsă ca să afișeze categoria fiecărui produs și câte produse sunt în fiecare categorie.

Codul care dă eroarea
PYTHON
import pandas as pd

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

df["categorie"] = pd.cut(df["pret"], bins=[50, 200, float("inf")], labels=["ieftin", "mediu", "scump"])
print(df["categorie"].tolist())
print(df["categorie"].value_counts(sort=False).to_dict())
După reparație, programul afișează
['ieftin', 'mediu', 'scump', 'scump', 'ieftin']
{'ieftin': 2, 'mediu': 1, 'scump': 2}
Indiciu

Pentru 3 etichete îți trebuie 4 margini; prima margine poate fi 0.

Alte forme ale mesajului

  • ValueError: Bin labels must be one fewer than the number of bin edges

Cum o eviți pe viitor

  • Scrie marginile și etichetele una sub alta și numără-le înainte de rulare.
  • Folosește float("inf") (sau -float("inf")) la capete, ca să nu rămână valori în afara intervalelor.
  • Verifică rezultatul cu value_counts(dropna=False): un NaN înseamnă valori care nu intră în niciun interval.
  • La pd.qcut(valori, q=4, labels=[...]), numărul de etichete trebuie să fie egal cu q.

Întrebări frecvente

De ce unele valori devin NaN după pd.cut?

Pentru că sunt în afara marginilor sau chiar pe marginea de jos: intervalele sunt implicit închise la dreapta, deci 0 nu intră în (0, 50]. Folosește o margine de jos mai mică sau include_lowest=True.

Pot folosi pd.cut fără etichete?

Da. Fără labels, categoriile sunt chiar intervalele, de exemplu (50, 200]. Cu labels=False primești numărul intervalului (0, 1, 2...).

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.