Named agg tuples Issue #18220

doc/source/user_guide/groupby.rst

@@ -770,6 +770,7 @@ no column selection, so the values are just the functions.
        max_height="max",
    )
 
+
 Applying different functions to DataFrame columns
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

pandas/core/groupby/generic.py

@@ -1424,6 +1424,28 @@ class DataFrameGroupBy(GroupBy[DataFrame]):
     A
     1   1.0
     2   3.0
+
+    Passing a List of Tuples
+
+    Demonstrates using the `agg` method with a list of tuples for grouping and aggregation.
+    Consider a DataFrame `df`:
+    key | data
+    ----|------
+    'a' | 0.5
+    'a' | -1.0
+    'b' | 2.0
+    'b' | -0.5
+    'a' | 1.2
+
+    Example: Applying multiple aggregations - mean and standard deviation
+    df_result = df.groupby('key')['data'].agg([('mean_value', 'mean'), ('std_deviation', 'std')])
+
+    Using a list of tuples provides a concise way to apply multiple aggregations to the same column while controlling
+    the output column names. This approach is especially handy when you need to calculate various statistics on
+    the same data within each group.
+
+    :return: Example of using the `agg` method with a list of tuples for grouping and aggregation.
+    :rtype: None
     """
     )