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

TypeError: 'value' must be an instance of str or bytes, not a float

Pe scurt

Axa graficului are etichete de text (categorii), iar printre ele e o valoare care nu e text: de obicei un NaN (float) dintr-o coloană cu goluri sau un număr amestecat cu texte. Completează golurile (fillna("necunoscut")) sau transformă etichetele în text cu astype(str).

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

Ce înseamnă

Când dai la plt.bar, plt.plot sau plt.scatter o listă de texte pe axa x (de exemplu nume de orașe), matplotlib face o axă de categorii. Toate valorile de pe ea trebuie să fie texte. Dacă una e float (un NaN, adică o valoare lipsă) sau int (un cod numeric amestecat cu texte), primești mesajul acesta.

Apare des la grafice făcute direct din coloane citite din fișiere: un rând fără oraș sau fără categorie aduce un NaN în etichete. Sau coloana are coduri, unele citite ca număr, altele ca text.

Mesajul vine din interiorul matplotlib, iar stiva de apeluri e lungă. Linia ta e cea cu plt.bar(...). Verifică etichetele cu df["oras"].isna().sum() și df["oras"].map(type).value_counts().

De ce apare: cauzele frecvente

1Gol în coloana de etichete

Greșit
PYTHON
plt.bar(df["oras"], df["suma"])  # un oras e NaN
Corect
PYTHON
df["oras"] = df["oras"].fillna("necunoscut")
plt.bar(df["oras"], df["suma"])

Golul devine un text, deci toate etichetele axei sunt texte.

2Numere amestecate cu texte

Greșit
PYTHON
plt.bar(["A1", 205, "C3"], [4, 7, 2])
Corect
PYTHON
plt.bar([str(c) for c in ["A1", 205, "C3"]], [4, 7, 2])

Toate codurile devin texte. Pentru o coloană: df["cod"].astype(str).

3Graficul trebuia făcut după grupare

Greșit
PYTHON
plt.bar(df["oras"], df["suma"])
Corect
PYTHON
total = df.groupby("oras")["suma"].sum()
plt.bar(total.index, total.values)

groupby lasă implicit deoparte rândurile cu eticheta lipsă și dă câte o bară pe oraș.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos desenează un grafic cu bare cu totalul vânzărilor pe oraș, dar o vânzare nu are orașul completat, iar plt.bar dă TypeError: 'value' must be an instance of str or bytes, not a float. Repară-l ca orașul lipsă să apară ca necunoscut și afișează etichetele axei și înălțimile barelor.

Codul care dă eroarea
PYTHON
import numpy as np
import pandas as pd
import matplotlib.pyplot as plt

df = pd.DataFrame({
    "oras": ["Cluj", "Iasi", np.nan, "Cluj"],
    "suma": [120, 80, 50, 200],
})

bare = plt.bar(df["oras"], df["suma"])
print(len(bare))
După reparație, programul afișează
['Cluj', 'Iasi', 'necunoscut']
[320, 80, 50]
Indiciu

Completează golurile din coloana oras cu fillna("necunoscut") înainte de grupare.

Alte forme ale mesajului

  • TypeError: 'value' must be an instance of str or bytes, not a int

Cum o eviți pe viitor

  • Înainte de grafice cu categorii, verifică golurile din coloana de etichete și completează-le sau elimină-le.
  • Transformă codurile în text cu astype(str) dacă le folosești ca etichete.
  • Pentru bare pe categorii, grupează întâi datele: graficul devine și mai clar.
  • df.plot.bar(x="oras", y="suma") din pandas tratează mai bine etichetele amestecate.

Întrebări frecvente

De ce mesajul vorbește de float dacă eu am doar texte?

Pentru că o valoare lipsă dintr-o coloană de text este NaN, iar NaN e de tip float. Un singur rând gol e suficient.

Pot desena barele în ordinea mea, nu alfabetic?

Matplotlib păstrează ordinea în care apar etichetele. Sortează datele înainte (sort_values) sau reordonează seria cu reindex([...]).

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.