ValueError: DataFrame constructor not properly called!
pd.DataFrame() a primit un singur text sau un singur număr, nu un tabel. Cel mai des îi dai textul unui JSON sau numele unui fișier. Transformă textul în date cu json.loads() sau pd.read_json(), iar fișierele le citești cu pd.read_csv().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
pd.DataFrame(...) construiește un tabel din ceva care are deja formă de tabel: un dicționar de liste, o listă de dicționare, o listă de liste, un array NumPy, o serie. Dacă îi dai un scalar (un text, un număr, None în unele contexte), pandas nu are din ce să facă rânduri și coloane și se oprește cu mesajul acesta.
Cel mai des se întâmplă în două situații: ai primit un răspuns JSON de la un API ca text (str) și l-ai dat direct la pd.DataFrame, sau ai scris numele fișierului (pd.DataFrame("vanzari.csv")) crezând că pandas îl citește.
Ca să găsești cauza, uită-te la linia din eroare și afișează tipul argumentului cu print(type(x)). Dacă vezi <class 'str'>, ai un text, nu date.
De ce apare: cauzele frecvente
1Textul unui JSON dat direct la DataFrame
raspuns = '[{"produs": "Cafea", "pret": 24.5}]'
df = pd.DataFrame(raspuns)import json
raspuns = '[{"produs": "Cafea", "pret": 24.5}]'
df = pd.DataFrame(json.loads(raspuns))raspuns e un singur text. json.loads îl transformă într-o listă de dicționare, iar din lista asta pandas face rânduri.
2Numele fișierului în loc de citirea lui
df = pd.DataFrame("vanzari.csv")df = pd.read_csv("vanzari.csv")pd.DataFrame nu deschide fișiere. Pentru fișiere folosești funcțiile read_*: read_csv, read_excel, read_json.
3Un singur număr în loc de o listă
total = df["suma"].sum()
rezumat = pd.DataFrame(total)total = df["suma"].sum()
rezumat = pd.DataFrame({"total": [total]})Un număr singur nu e tabel. Pune-l într-un dicționar cu o listă, ca să ai o coloană cu un rând.
Repară eroarea, direct în pagină
Codul de mai jos primește lista de produse ca text JSON (așa cum vine de la un API) și dă ValueError: DataFrame constructor not properly called!. Repară-l ca să construiască tabelul și să afișeze numărul de rânduri și coloane, apoi suma prețurilor.
import json
import pandas as pd
raspuns = '[{"produs": "Cafea", "pret": 24.5}, {"produs": "Ceai", "pret": 12.0}, {"produs": "Miere", "pret": 31.5}]'
df = pd.DataFrame(raspuns)
print(df.shape)
print(df["pret"].sum())(3, 2) 68.0
Indiciu
Transformă întâi textul în listă de dicționare cu json.loads.
Reparația
import json
import pandas as pd
raspuns = '[{"produs": "Cafea", "pret": 24.5}, {"produs": "Ceai", "pret": 12.0}, {"produs": "Miere", "pret": 31.5}]'
df = pd.DataFrame(json.loads(raspuns))
print(df.shape)
print(df["pret"].sum())De ce merge
raspuns e un singur șir de caractere, iar din el pandas nu poate face rânduri. json.loads(raspuns) îl transformă într-o listă cu trei dicționare, fiecare cu cheile produs și pret. Din lista asta pd.DataFrame face un tabel cu 3 rânduri și 2 coloane, iar suma prețurilor este 24.5 + 12.0 + 31.5 = 68.0.
Cum o eviți pe viitor
- Înainte de
pd.DataFrame(x), verifică cutype(x)că ai o listă, un dicționar sau un array, nu un text. - Răspunsurile de la API-uri vin ca text: folosește
response.json()saujson.loads()înainte să construiești tabelul. - Pentru fișiere folosește mereu
pd.read_csv,pd.read_excel,pd.read_json. - O valoare singură o pui în listă:
{"total": [valoare]}.
Întrebări frecvente
De ce pd.DataFrame(5) nu face un tabel cu un rând?
Pentru că pandas nu știe ce nume să dea coloanei și câte rânduri să facă. Îi spui explicit: pd.DataFrame({"valoare": [5]}).
Pot folosi pd.read_json direct pe text?
Da, dar în pandas recent textul trebuie împachetat în io.StringIO(text): pd.read_json(io.StringIO(text)). Varianta cu json.loads și pd.DataFrame merge la fel de bine pentru o listă de obiecte.
Erori înrudite
ValueError: If using all scalar values, you must pass an index Ai dat la pd.DataFrame un dicționar în care toate valorile sunt simple (un număr, un text), nu liste. pandas nu știe câte rânduri să facă. Pune dicționarul într-o listă: pd.DataFrame([rand]), sau valorile în liste: {"pret": [24.9]}. ValueError: All arrays must be of the same length Ai construit un DataFrame dintr-un dicționar în care listele (coloanele) au lungimi diferite. Fiecare coloană trebuie să aibă exact câte o valoare pentru fiecare rând: completează valoarea lipsă (sau pune None / np.nan acolo unde nu o știi). ValueError: Expected object or value pd.read_json nu a găsit JSON valid la începutul textului. Cauze tipice: textul folosește ghilimele simple (e un dict Python afișat cu str()), fișierul e gol sau conține altceva (HTML, CSV). Generează textul cu json.dumps() și verifică ce e în fișier. Î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.
