...
Eroare Python pentru analiza datelor · NumPy: forme și tipuri

TypeError: unhashable type: 'numpy.ndarray'

Pe scurt

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

Greșit
PYTHON
vizite = {}
for p in puncte:
    vizite[p] = vizite.get(p, 0) + 1
Corect
PYTHON
vizite = {}
for p in puncte:
    cheie = tuple(p)
    vizite[cheie] = vizite.get(cheie, 0) + 1

Un tuplu nu se poate modifica, deci are hash și poate fi cheie.

2Array-uri în celulele unui tabel

Greșit
PYTHON
df["etichete"].unique()  # fiecare celulă e un np.array
Corect
PYTHON
df["etichete"].apply(tuple).unique()

Transformate în tupluri, valorile pot fi comparate și numărate.

3Array dat ca nume de coloană

Greșit
PYTHON
df[df[["oras"]].values]
Corect
PYTHON
df["oras"]

.values dă un array, nu un nume. Coloanele se aleg după nume sau listă de nume.

Repară tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
{(1, 2): 3, (3, 4): 2, (5, 6): 1}
Indiciu

Folosește ca cheie tuplul coordonatelor, cu tuple(...).

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) sau tuple(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

← 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.