TypeError: unhashable type: 'numpy.ndarray'
Ai folosit un array NumPy ca cheie de dicționar, element de set sau valoare pe care pandas trebuie s-o compare (unique, value_counts, groupby). Array-urile se pot modifica și nu au hash. Transformă-le în tuplu: tuple(a), sau păstrează doar valori simple în celule.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Dicționarele, seturile și operațiile pandas care caută valori identice (unique, value_counts, drop_duplicates, groupby, merge) au nevoie de un „hash”, o amprentă fixă a valorii. Un obiect se poate modifica (cum e un array NumPy sau o listă) nu are hash, pentru că amprenta s-ar schimba odată cu conținutul.
Apare când folosești coordonate, vectori sau rânduri ca chei ({np.array([1, 2]): ...}), când pui array-uri în celulele unui tabel și apoi le numeri sau elimini duplicatele, sau când dai din greșeală un array (df.values) ca nume de coloană.
În Python 3.14 mesajul e mai detaliat: „cannot use 'numpy.ndarray' as a dict key (unhashable type: 'numpy.ndarray')”. Soluția e aceeași: tuplurile au hash, array-urile nu.
De ce apare: cauzele frecvente
1Array ca cheie de dicționar
vizite = {}
for p in puncte:
vizite[p] = vizite.get(p, 0) + 1vizite = {}
for p in puncte:
cheie = tuple(p)
vizite[cheie] = vizite.get(cheie, 0) + 1Un tuplu nu se poate modifica, deci are hash și poate fi cheie.
2Array-uri în celulele unui tabel
df["etichete"].unique() # fiecare celulă e un np.arraydf["etichete"].apply(tuple).unique()Transformate în tupluri, valorile pot fi comparate și numărate.
3Array dat ca nume de coloană
df[df[["oras"]].values]df["oras"].values dă un array, nu un nume. Coloanele se aleg după nume sau listă de nume.
Repară eroarea, direct în pagină
Codul de mai jos numără de câte ori apare fiecare punct de livrare (coordonate x, y) folosind un dicționar, dar cheile sunt array-uri NumPy și primești eroarea unhashable type: 'numpy.ndarray'. Repară-l ca să afișeze dicționarul cu numărul de livrări pe fiecare punct.
import numpy as np
puncte = np.array([[1, 2], [3, 4], [1, 2], [5, 6], [1, 2], [3, 4]])
vizite = {}
for p in puncte:
vizite[p] = vizite.get(p, 0) + 1
print(vizite){(1, 2): 3, (3, 4): 2, (5, 6): 1}Indiciu
Folosește ca cheie tuplul coordonatelor, cu tuple(...).
Reparația
import numpy as np
puncte = np.array([[1, 2], [3, 4], [1, 2], [5, 6], [1, 2], [3, 4]])
vizite = {}
for p in puncte:
cheie = tuple(p.tolist())
vizite[cheie] = vizite.get(cheie, 0) + 1
print(vizite)De ce merge
Fiecare p din buclă e un array NumPy, iar array-urile se pot modifica și nu pot fi chei de dicționar. tuple(p.tolist()) transformă coordonatele într-un tuplu de întregi Python, fix și cu hash. Punctul (1, 2) apare de 3 ori, (3, 4) de 2 ori, iar (5, 6) o dată.
Alte forme ale mesajului
TypeError: cannot use 'numpy.ndarray' as a dict key (unhashable type: 'numpy.ndarray')TypeError: cannot use 'numpy.ndarray' as a set element (unhashable type: 'numpy.ndarray')
Cum o eviți pe viitor
- Ca chei sau elemente de set, folosește tupluri:
tuple(a)sautuple(a.tolist()). - Evită array-urile și listele în celulele tabelelor: împarte datele în coloane separate sau în format lung (
explode). - Pentru rânduri unice dintr-un array 2D folosește
np.unique(a, axis=0). - Când primești eroarea în pandas, verifică ce tip au valorile din coloană:
type(df["col"].iloc[0]).
Întrebări frecvente
De ce o listă dă aceeași eroare?
Din același motiv: o listă se poate modifica. Mesajul e „unhashable type: 'list'”, iar soluția e tot tuple(...).
Cum număr rândurile identice dintr-un array 2D?
np.unique(a, axis=0, return_counts=True) dă rândurile distincte și de câte ori apare fiecare, fără dicționare.
Erori înrudite
TypeError: only 0-dimensional arrays can be converted to Python scalars Ai încercat să transformi un array cu mai multe valori într-un singur număr Python: float(a), int(a) sau o funcție din math (math.sqrt(a)). Asta merge doar pentru un array cu o singură valoare. Reduce întâi array-ul (a.mean(), a.sum(), a[0]) sau folosește funcțiile NumPy, care lucrează pe tot array-ul. ValueError: The truth value of an array with more than one element is ambiguous. Use a.any() or a.all() Ai pus o comparație pe un tablou NumPy (de exemplu note >= 5) într-un if, while, and sau or, iar rezultatul e un tablou de True/False, nu o singură valoare. Spune ce vrei: np.any(...) pentru „măcar unul”, np.all(...) pentru „toate”, sau folosește masca pentru filtrare: note[note >= 5]. KeyError: "None of [Index(['nume', 'oras'], dtype='str')] are in the [columns]" Ai cerut o listă de coloane, df[["nume", "oras"]], și niciuna dintre ele nu există în DataFrame. Verifică numele cu df.columns.tolist(); de obicei diferă litere mari, diacritice sau spații, ori fișierul a fost citit cu separatorul greșit. Î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.
