...
Eroare Python pentru analiza datelor · Cod vechi: pandas 2 și 3, NumPy 2

TypeError: DataFrame.groupby() got an unexpected keyword argument 'axis'

Pe scurt

În pandas 3, groupby nu mai are parametrul axis (la fel rolling și agregările de după groupby). Dacă era axis=0, șterge-l, fiindcă e oricum comportamentul implicit. Dacă era axis=1 (grupare de coloane), transpune tabelul: df.T.groupby(...).sum().T.

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

Ce înseamnă

Parametrul axis de la groupby a fost marcat ca învechit în pandas 2.1 (cu un FutureWarning) și scos în pandas 3. Odată cu el au dispărut și axis de la rolling, expanding, resample și de la agregările unui groupby (.sum(axis=...)).

Codul care îl folosea se încadrează de obicei în două cazuri:

  • axis=0, scris explicit: nu schimba nimic, deci poți doar să-l ștergi;
  • axis=1, ca să grupezi coloanele (de exemplu lunile după trimestru): acum transpui tabelul cu .T, grupezi rândurile, apoi transpui înapoi.

Mesajul poate apărea și cu alt nume de clasă (Series.groupby, NDFrame.rolling, GroupBy.sum), după metoda folosită.

De ce apare: cauzele frecvente

1axis=0 scris explicit

Greșit
PYTHON
df.groupby("oras", axis=0)["valoare"].sum()
Corect
PYTHON
df.groupby("oras")["valoare"].sum()

Gruparea pe rânduri e comportamentul implicit; parametrul nu mai există, dar nici nu era necesar.

2Gruparea coloanelor cu axis=1

Greșit
PYTHON
trimestre = {"ian": "T1", "feb": "T1", "apr": "T2"}
df.groupby(trimestre, axis=1).sum()
Corect
PYTHON
trimestre = {"ian": "T1", "feb": "T1", "apr": "T2"}
df.T.groupby(trimestre).sum().T

.T face din coloane rânduri, groupby le grupează, iar .T de la final reface forma inițială.

3axis la rolling sau la agregare

Greșit
PYTHON
df["vanzari"].rolling(3, axis=0).mean()
df.groupby("oras").sum(axis=0)
Corect
PYTHON
df["vanzari"].rolling(3).mean()
df.groupby("oras").sum()

Și aici axis=0 era implicit, deci ștergerea lui păstrează rezultatul.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos, scris pentru o versiune mai veche de pandas, adună vânzările lunare pe trimestre, grupând coloanele cu axis=1. În pandas 3 dă TypeError: DataFrame.groupby() got an unexpected keyword argument 'axis'. Repară-l ca să afișeze totalul pe trimestre pentru fiecare magazin.

Codul care dă eroarea
PYTHON
import pandas as pd

df = pd.DataFrame(
    {"ian": [10, 4], "feb": [12, 6], "apr": [9, 8], "mai": [11, 5]},
    index=["Cluj", "Iasi"],
)
trimestre = {"ian": "T1", "feb": "T1", "apr": "T2", "mai": "T2"}

rez = df.groupby(trimestre, axis=1).sum()
print(rez)
După reparație, programul afișează
      T1  T2
Cluj  22  20
Iasi  10  13
Indiciu

Transpune tabelul, grupează rândurile, apoi transpune înapoi: df.T.groupby(...).sum().T.

Alte forme ale mesajului

  • FutureWarning: DataFrame.groupby with axis=1 is deprecated. Do `frame.T.groupby(...)` without axis instead.
  • TypeError: NDFrame.rolling() got an unexpected keyword argument 'axis'
  • TypeError: GroupBy.sum() got an unexpected keyword argument 'axis'

Cum o eviți pe viitor

  • Când treci un proiect la pandas 3, rulează-l întâi pe pandas 2.2 și repară toate FutureWarning-urile: ele anunță exact ce va dispărea.
  • Nu scrie axis=0 explicit la metodele care lucrează implicit pe rânduri.
  • Pentru operații pe coloane, preferă transpunerea (.T) sau un format lung (melt) în locul lui axis=1.

Întrebări frecvente

Mai pot folosi axis=1 la sum sau mean pe un DataFrame?

Da. df.sum(axis=1) (totalul pe rând) există în continuare. Doar groupby, rolling și metodele unui obiect grupat au pierdut parametrul.

Cum aflu ce versiune de pandas am?

import pandas as pd; print(pd.__version__). Codul din tutorialele mai vechi de 2024 e scris de obicei pentru pandas 1 sau 2.

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.