...
Eroare Python pentru analiza datelor · Crearea unui DataFrame

TypeError: Index(...) must be called with a collection of some kind, 'oras' was passed

Pe scurt

Ai dat la columns= sau index= un singur text sau număr, iar pandas așteaptă o listă. Scrie columns=["oras"] în loc de columns="oras", chiar dacă ai o singură coloană.

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

Ce înseamnă

Numele coloanelor și etichetele rândurilor sunt ținute de pandas într-un obiect Index, care se construiește dintr-o colecție: listă, tuplu, array, alt Index. Când scrii columns="oras", pandas încearcă să facă un Index dintr-un singur text și se oprește: „'oras' was passed” îți arată exact valoarea primită.

Apare des când tabelul are o singură coloană și pare firesc să scrii doar numele ei, sau când dai la index= un număr (de exemplu numărul de rânduri) în loc de o listă de etichete.

Mesajul e același pentru pd.DataFrame(..., columns=...), pd.DataFrame(..., index=...), pd.Series(..., index=...) și pd.Index(...). Uită-te la linia din eroare și la parametrul care primește o singură valoare.

De ce apare: cauzele frecvente

1O singură coloană scrisă ca text

Greșit
PYTHON
orase = ["Cluj", "Iasi", "Arad"]
df = pd.DataFrame(orase, columns="oras")
Corect
PYTHON
orase = ["Cluj", "Iasi", "Arad"]
df = pd.DataFrame(orase, columns=["oras"])

columns primește lista numelor de coloane. O listă cu un singur element e perfect validă.

2Numărul de rânduri dat la index

Greșit
PYTHON
df = pd.DataFrame({"suma": [10, 20, 30]}, index=3)
Corect
PYTHON
df = pd.DataFrame({"suma": [10, 20, 30]}, index=range(3))

index vrea câte o etichetă pentru fiecare rând, nu numărul lor. range(3) dă etichetele 0, 1, 2.

3Eticheta unei serii dată ca text

Greșit
PYTHON
s = pd.Series([120], index="Cluj")
Corect
PYTHON
s = pd.Series([120], index=["Cluj"])

Și la serii, index e o colecție de etichete, chiar dacă ai o singură valoare.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos vrea un tabel cu o singură coloană, oras, dar dă TypeError: Index(...) must be called with a collection of some kind, 'oras' was passed. Repară-l ca să afișeze numele coloanelor și numărul de orașe.

Codul care dă eroarea
PYTHON
import pandas as pd

orase = ["Cluj", "Iasi", "Arad", "Brasov"]
df = pd.DataFrame(orase, columns="oras")
print(list(df.columns))
print(len(df))
După reparație, programul afișează
['oras']
4
Indiciu

Numele coloanelor se dau într-o listă, chiar dacă e unul singur.

Alte forme ale mesajului

  • TypeError: Index(...) must be called with a collection of some kind, 5 was passed

Cum o eviți pe viitor

  • La columns= și index= pune mereu paranteze pătrate, chiar pentru un singur nume: columns=["oras"].
  • Dacă ai un singur șir de valori și vrei să-i dai nume, poți scrie direct pd.DataFrame({"oras": orase}), varianta cea mai clară.
  • Pentru etichete numerotate folosește range(n) sau lasă pandas să le pună singur (nu da deloc index).

Întrebări frecvente

De ce un text nu e tratat ca o listă de litere?

Pandas refuză intenționat textul la Index, tocmai ca să nu obții din greșeală coloanele o, r, a, s. Vrea o colecție explicită.

Dar df.columns = "oras" ce face?

Tot o eroare de tip: noile nume de coloane trebuie să fie o listă de aceeași lungime cu numărul de coloane, de exemplu df.columns = ["oras"].

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.