...
Eroare Python pentru analiza datelor · Coloane, selecție și filtrare

pandas.errors.UndefinedVariableError: name 'pret' is not defined

Pe scurt

În textul din df.query() sau df.eval() ai un nume care nu e nici coloană, nici variabilă marcată cu @. Verifică numele coloanei (litere mari, diacritice) și pune @ în fața variabilelor Python: df.query("pret > @prag").

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

Ce înseamnă

df.query("...") citește textul condiției și caută fiecare nume printre coloanele tabelului. Variabilele Python din codul tău nu sunt căutate automat: trebuie marcate cu @ (@prag). Dacă un nume nu e nici coloană, nici variabilă cu @, primești UndefinedVariableError cu numele respectiv.

Cele mai dese cauze: coloana se numește altfel (Pret, preț, pret cu spațiu), ai uitat @ în fața unei variabile, sau ai scris textul fără ghilimele interioare (oras == Cluj în loc de oras == "Cluj"), iar Cluj e luat drept nume de coloană.

Afișează df.columns.tolist() ca să vezi numele exacte ale coloanelor.

De ce apare: cauzele frecvente

1Variabilă Python fără @

Greșit
PYTHON
prag = 20
scumpe = df.query("pret > prag")
Corect
PYTHON
prag = 20
scumpe = df.query("pret > @prag")

@prag îi spune lui query să ia valoarea variabilei Python prag. Fără @, caută o coloană numită prag.

2Text fără ghilimele în condiție

Greșit
PYTHON
df.query("oras == Cluj")
Corect
PYTHON
df.query("oras == 'Cluj'")

Fără ghilimele, Cluj e un nume căutat printre coloane. Între ghilimele simple e o valoare text.

3Numele coloanei scris diferit

Greșit
PYTHON
df = pd.DataFrame({"Pret": [24, 12]})
df.query("pret > 20")
Corect
PYTHON
df = pd.DataFrame({"Pret": [24, 12]})
df.query("Pret > 20")

Numele sunt sensibile la litere mari și mici. Pentru coloane cu spații sau caractere speciale folosește backticks: ` pret unitar > 5 `.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos vrea produsele mai scumpe decât pragul din variabila prag, dar query dă UndefinedVariableError: name 'prag' is not defined. Repară condiția ca să afișeze lista produselor peste prag.

Codul care dă eroarea
PYTHON
import pandas as pd

df = pd.DataFrame({
    "produs": ["Cafea", "Ceai", "Miere", "Zahar", "Ulei"],
    "pret": [24, 12, 31, 5, 18],
})

prag = 15
scumpe = df.query("pret > prag")
print(scumpe["produs"].tolist())
După reparație, programul afișează
['Cafea', 'Miere', 'Ulei']
Indiciu

Variabilele Python din query se scriu cu @ în față.

Alte forme ale mesajului

  • pandas.errors.UndefinedVariableError: name 'prag' is not defined
  • pandas.errors.UndefinedVariableError: local variable 'prag' is not defined

Cum o eviți pe viitor

  • În query și eval, pune @ în fața oricărei variabile Python.
  • Valorile text din condiție se scriu între ghilimele: "oras == 'Cluj'".
  • Curăță numele coloanelor la citire (df.columns = df.columns.str.strip().str.lower()), ca să știi exact cum le scrii.
  • Coloanele cu spații se scriu între backticks în query.

Întrebări frecvente

De ce eroarea zice local variable?

Dacă ai scris @prag, dar variabila prag nu există în codul tău, mesajul spune „local variable 'prag' is not defined”. Verifică numele variabilei.

query e mai rapid decât filtrarea cu paranteze?

Pe tabele mici diferența nu contează. query e mai ușor de citit pentru condiții lungi, dar filtrarea cu df[(...) & (...)] e mai ușor de verificat de editor, pentru că nu e text.

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.