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

TypeError: must be real number, not Series

Pe scurt

Ai dat o coloană întreagă unei funcții din modulul math (math.sqrt, math.log, math.exp), care lucrează doar cu un singur număr. Folosește echivalentul din NumPy, care lucrează pe toată coloana: np.sqrt(df["x"]), np.log(df["x"]).

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

Ce înseamnă

Funcțiile din modulul math primesc un singur număr și întorc un număr. df["suprafata"] e o Series, adică o coloană cu multe valori, iar math.sqrt nu știe ce să facă cu ea: „must be real number, not Series” = aștepta un număr real și a primit o serie.

NumPy are aceleași funcții, dar vectorizate: np.sqrt, np.log, np.exp, np.floor, np.round se aplică pe fiecare valoare din coloană și întorc tot o coloană, cu același index. Multe operații au și metodă directă în pandas: df["x"].round(2), df["x"].abs(), df["x"].pow(2).

Aceeași idee la float(df["x"]) sau int(df["x"]): conversia unei coloane întregi într-un singur număr nu are sens (TypeError: float() argument must be a string or a real number, not 'Series'). Dacă vrei o singură valoare, alege-o întâi (.iloc[0], .sum()).

De ce apare: cauzele frecvente

1Funcție din math pe o coloană

Greșit
PYTHON
import math
df["latura"] = math.sqrt(df["suprafata"])
Corect
PYTHON
import numpy as np
df["latura"] = np.sqrt(df["suprafata"])

np.sqrt calculează rădăcina pentru fiecare valoare din coloană.

2Logaritm pentru o coloană de venituri

Greșit
PYTHON
df["log_venit"] = math.log(df["venit"])
Corect
PYTHON
df["log_venit"] = np.log(df["venit"])

np.log e varianta pe coloană a lui math.log.

3Conversie a coloanei într-un număr

Greșit
PYTHON
total = float(df["suma"])
Corect
PYTHON
total = float(df["suma"].sum())

Întâi reduci coloana la o singură valoare (suma), apoi o poți converti.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă TypeError: must be real number, not Series. Repară calculul coloanei latura (latura unui teren pătrat, din suprafața lui) ca să lucreze pe toată coloana, apoi afișează laturile.

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

df = pd.DataFrame({"teren": ["A", "B", "C"], "suprafata": [400, 900, 2500]})

df["latura"] = math.sqrt(df["suprafata"])
print(df["latura"].tolist())
După reparație, programul afișează
[20.0, 30.0, 50.0]
Indiciu

Înlocuiește math.sqrt cu np.sqrt.

Alte forme ale mesajului

  • TypeError: cannot convert the series to <class 'float'>
  • TypeError: float() argument must be a string or a real number, not 'Series'
  • TypeError: must be real number, not DataFrame

Cum o eviți pe viitor

  • Pe coloane, folosește funcțiile din NumPy (np.), nu din math.
  • Caută întâi o metodă pandas: round, abs, pow, clip, cumsum.
  • Folosește math doar pe valori singulare, de exemplu un total deja calculat.
  • Evită apply(math.sqrt): merge, dar e mult mai lent decât np.sqrt pe coloană.

Întrebări frecvente

Pot folosi df["x"].apply(math.sqrt)?

Da, apply cheamă funcția pe fiecare valoare, deci merge. Dar e mai lent și mai lung decât np.sqrt(df["x"]), care face același lucru dintr-o dată.

De ce în versiunile vechi mesajul era cannot convert the series to <class 'float'>?

Versiunile mai vechi de pandas încercau să transforme seria într-un float și dădeau mesajul acela. Cauza și reparația sunt aceleași.

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.