...
Eroare Python pentru analiza datelor · Tipuri de date și conversii

ValueError: Cannot mask with non-boolean array containing NA / NaN values

Pe scurt

Ai filtrat cu o mască făcută cu .str (de obicei str.contains) pe o coloană care are și valori lipsă sau numere: pe acele rânduri masca are NaN, nu True/False. Pune na=False: df[df["email"].str.contains("gmail", na=False)], sau convertește coloana în text înainte.

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

Ce înseamnă

Un filtru df[masca] are nevoie de o mască booleană: pe fiecare rând True (păstrează) sau False (aruncă). Metodele .str (contains, startswith, endswith, match) întorc însă NaN pe rândurile care nu sunt texte: valori lipsă sau numere amestecate în coloană. O mască cu NaN nu e booleană, iar pandas refuză să ghicească dacă rândul trebuie păstrat.

În pandas 3, pe coloanele de tip str, valorile lipsă dau deja False, dar coloanele de tip object (cu valori amestecate: texte și numere, de exemplu dintr-un export Excel) au încă problema. Verifică df["col"].dtype și masca.isna().sum() ca să vezi câte rânduri dau NaN.

Reparația e să decizi tu ce se întâmplă cu acele rânduri: na=False (le aruncă) sau na=True (le păstrează).

De ce apare: cauzele frecvente

1str.contains pe o coloană cu valori lipsă sau numere

Greșit
PYTHON
df[df["email"].str.contains("gmail")]
Corect
PYTHON
df[df["email"].str.contains("gmail", na=False)]

Cu na=False, rândurile care nu sunt text primesc False în mască și sunt excluse.

2Coloană cu tipuri amestecate

Greșit
PYTHON
df["cod"] = [101, "A-17", None]
df[df["cod"].str.startswith("A")]
Corect
PYTHON
df["cod"] = df["cod"].astype("str")
df[df["cod"].str.startswith("A")]

După conversia în text, fiecare valoare e un șir, iar masca are doar True și False.

3Mască făcută cu map care întoarce None

Greșit
PYTHON
masca = df["oras"].map({"Cluj": True, "Iasi": False})
df[masca]
Corect
PYTHON
masca = df["oras"].map({"Cluj": True, "Iasi": False}).fillna(False).astype(bool)
df[masca]

Orașele care lipsesc din dicționar primesc NaN; fillna(False) le transformă într-o decizie clară.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă ValueError: Cannot mask with non-boolean array containing NA / NaN values. Coloana email are o valoare lipsă și un cod numeric. Repară filtrul ca să afișeze clienții cu adresă de Gmail și numărul lor; rândurile fără text se exclud.

Codul care dă eroarea
PYTHON
import pandas as pd
import numpy as np

df = pd.DataFrame({
    "nume": ["Ana", "Dan", "Ioana", "Mihai"],
    "email": pd.Series(["ana@gmail.com", 1234, np.nan, "mihai@gmail.com"], dtype="object"),
})

gmail = df[df["email"].str.contains("gmail")]
print(gmail["nume"].tolist())
print("Clienți Gmail:", len(gmail))
După reparație, programul afișează
['Ana', 'Mihai']
Clienți Gmail: 2
Indiciu

Adaugă na=False în str.contains.

Alte forme ale mesajului

  • ValueError: Cannot mask with non-boolean array containing NA / NaN values
  • ValueError: Cannot mask with a boolean indexer containing NA values

Cum o eviți pe viitor

  • Pune mereu na=False la str.contains, str.startswith și str.endswith când filtrezi.
  • Verifică tipul coloanei: o coloană object cu valori amestecate se curăță întâi (astype("str") sau pd.to_numeric).
  • Înainte de filtru, masca.value_counts(dropna=False) îți arată dacă apar NaN.
  • Tratează explicit valorile lipsă (fillna, dropna) înainte de prelucrarea textului.

Întrebări frecvente

Ce diferență e între na=False și dropna() înainte?

Rezultatul filtrului e același: rândurile fără valoare nu apar. dropna() modifică însă tabelul pe care lucrezi, iar na=False afectează doar masca, deci rândurile rămân în df pentru alte calcule.

De ce mesajul apare doar pe unele fișiere?

Pentru că depinde de date: dacă exportul are măcar o celulă goală sau un număr în coloana de text, masca va conține NaN. Un fișier complet curat trece fără eroare.

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.