DOC: Clarify .agg status · Issue #16988 · pandas-dev/pandas (original) (raw)

Skip to content

Navigation Menu

• • GitHub Copilot Write better code with AI
  • GitHub Advanced Security Find and fix vulnerabilities
  • Actions Automate any workflow
  • Codespaces Instant dev environments
  • Issues Plan and track work
  • Code Review Manage code changes
  • Discussions Collaborate outside of code
  • Code Search Find more, search less
• Explore
  • Learning Pathways
  • Events & Webinars
  • Ebooks & Whitepapers
  • Customer Stories
  • Partners
  • Executive Insights
• • GitHub Sponsors Fund open source developers
  • The ReadME Project GitHub community articles
• • Enterprise platform AI-powered developer platform
• Pricing

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Sign up

Appearance settings

Description

The documentation for .agg is almost hilariously ambiguous:

agg is an alias for aggregate. Use it.

What is "it" referring to? Are we being told to use aggregate instead of agg because it's the fundamental name and agg is a mere alias? Or are we being told that we can and should use agg because it's the canonical alias (in the same way that pd is the canonical alias for pandas)?

A quick scan of the codebase suggests that .agg is considerably more popular than .aggregate among pandas devs, FWIW..