分组依据:拆分-应用-合并# 我们所说的“分组依据”是指涉及以下一个或多个步骤的过程: 根据某些标准将数据分成几组。 独立地将函数应用于每个组。 将结果组合成数据结构。 其中,分割步骤是最简单的。在应用步骤中,我们可能希望执行以下操作之一: 聚合:计算每个组的汇总统计量(或多个统计量)。一些例子: 计算组总和或平均值。 计算组大小/计数。 转换:执行一些特定于组的计算并返回类似索引的对象。一些例子: 标准化组内的数据 (zscore)。 使用从每个组派生的值填充组内的 NA。 过滤:根据计算结果为 True 或 False 的分组计算,丢弃一些组。一些例子: 丢弃属于只有少数成员的组的数据。 根据组总和或平均值过滤数据。 其中许多操作是在 GroupBy 对象上定义的。这些操作与聚合 API、 窗口 API和重新采样 API的操作类似。 给定的操作可能不属于这些类别之一,或者是它们的某种组合。在这种情况下,可以使用 GroupBy 的apply方法来计算操作。此方法将检查应用步骤的结果,如果不属于上述三个类别中的任何一个,则尝试将它们合理地组合成单个结果。 笔记 使用内置 GroupBy 操作分为多个步骤的操作将比使用apply带有用户定义的 Python 函数的方法更有效。 对于那些使用过基于 SQL 的工具(或itertools)的人来说,GroupBy 这个名称应该非常熟悉,您可以在其中编写如下代码: SELECT Column1, Column2, mean(Column3), sum(Column4) FROM SomeTable GROUP BY Column1, Column2 我们的目标是让这样的操作自然且易于使用 pandas 来表达。我们将讨论 GroupBy 功能的每个领域,然后提供一些重要的示例/用例。 请参阅食谱了解一些高级策略。 将对象分成组# 分组的抽象定义是提供标签到组名称的映射。要创建 GroupBy 对象(稍后将详细介绍 GroupBy 对象),您可以执行以下操作: In [1]: speeds = pd.DataFrame( ...: [ ...: ("bird", "Falconiformes", 389.0), ...: ("bird", "Psittaciformes", 24.0), ...: ("mammal", "Carnivora", 80.2), ...: ("mammal", "Primates", np.nan), ...: ("mammal", "Carnivora", 58), ...: ], ...: index=["falcon", "parrot", "lion", "monkey", "leopard"], ...: columns=("class", "order", "max_speed"), ...: ) ...: In [2]: speeds Out[2]: class order max_speed falcon bird Falconiformes 389.0 parrot bird Psittaciformes 24.0 lion mammal Carnivora 80.2 monkey mammal Primates NaN leopard mammal Carnivora 58.0 In [3]: grouped = speeds.groupby("class") In [4]: grouped = speeds.groupby(["class", "order"]) 可以通过多种不同的方式指定映射: 一个 Python 函数,将在每个索引标签上调用。 与索引长度相同的列表或 NumPy 数组。 一个 dict 或Series,提供映射。label -> group name 对于DataFrame对象,一个字符串,指示要用于分组的列名称或索引级别名称。 上述任何事物的列表。 我们将分组对象统称为键。例如,考虑以下情况DataFrame: 笔记 传递给的字符串groupby可以引用列或索引级别。如果一个字符串同时匹配列名和索引级别名称, ValueError则会引发 a 。 In [5]: df = pd.DataFrame( ...: { ...: "A": ["foo", "bar", "foo", "bar", "foo", "bar", "foo", "foo"], ...: "B": ["one", "one", "two", "three", "two", "two", "one", "three"], ...: "C": np.random.randn(8), ...: "D": np.random.randn(8), ...: } ...: ) ...: In [6]: df Out[6]: A B C D 0 foo one 0.469112 -0.861849 1 bar one -0.282863 -2.104569 2 foo two -1.509059 -0.494929 3 bar three -1.135632 1.071804 4 foo two 1.212112 0.721555 5 bar two -0.173215 -0.706771 6 foo one 0.119209 -1.039575 7 foo three -1.044236 0.271860 在 DataFrame 上,我们通过调用获取 GroupBy 对象groupby()。该方法返回一个pandas.api.typing.DataFrameGroupBy实例。我们自然可以按A或B列或两者进行分组: In [7]: grouped = df.groupby("A") In [8]: grouped = df.groupby("B") In [9]: grouped = df.groupby(["A", "B"]) 笔记 df.groupby('A')只是 的语法糖df.groupby(df['A'])。 A如果我们在列和上也有一个 MultiIndex B,我们可以按除我们指定的列之外的所有列进行分组: In [10]: df2 = df.set_index(["A", "B"]) In [11]: grouped = df2.groupby(level=df2.index.names.difference(["B"])) In [12]: grouped.sum() Out[12]: C D A bar -1.591710 -1.739537 foo -0.752861 -1.402938 上面的 GroupBy 将在其索引(行)上拆分 DataFrame。要按列分割,首先进行转置: In [13]: def get_letter_type(letter): ....: if letter.lower() in 'aeiou': ....: return 'vowel' ....: else: ....: return 'consonant' ....: In [14]: grouped = df.T.groupby(get_letter_type) pandasIndex对象支持重复值。如果在 groupby 操作中使用非唯一索引作为组键,则同一索引值的所有值将被视为在一组中,因此聚合函数的输出将仅包含唯一索引值: In [15]: index = [1, 2, 3, 1, 2, 3] In [16]: s = pd.Series([1, 2, 3, 10, 20, 30], index=index) In [17]: s Out[17]: 1 1 2 2 3 3 1 10 2 20 3 30 dtype: int64 In [18]: grouped = s.groupby(level=0) In [19]: grouped.first() Out[19]: 1 1 2 2 3 3 dtype: int64 In [20]: grouped.last() Out[20]: 1 10 2 20 3 30 dtype: int64 In [21]: grouped.sum() Out[21]: 1 11 2 22 3 33 dtype: int64 请注意,直到需要时才会发生拆分。创建 GroupBy 对象仅验证您是否传递了有效的映射。 笔记 许多种复杂的数据操作都可以用 GroupBy 操作来表达(尽管不能保证它是最有效的实现)。您可以利用标签映射功能发挥创意。 分组排序# 默认情况下,组键在groupby操作期间进行排序。然而,您可能会忽视sort=False潜在的加速。组键之间的顺序遵循sort=False原始数据帧中键的出现顺序: In [22]: df2 = pd.DataFrame({"X": ["B", "B", "A", "A"], "Y": [1, 2, 3, 4]}) In [23]: df2.groupby(["X"]).sum() Out[23]: Y X A 7 B 3 In [24]: df2.groupby(["X"], sort=False).sum() Out[24]: Y X B 3 A 7 请注意,这将保留每组中观察结果groupby的排序顺序。例如,下面创建的组按照它们在原始文件中出现的顺序排列:groupby()DataFrame In [25]: df3 = pd.DataFrame({"X": ["A", "B", "A", "B"], "Y": [1, 4, 3, 2]}) In [26]: df3.groupby("X").get_group("A") Out[26]: X Y 0 A 1 2 A 3 In [27]: df3.groupby(["X"]).get_group(("B",)) Out[27]: X Y 1 B 4 3 B 2 分组依据 dropna # 默认情况下,NA在操作过程中值会从组键中排除groupby。但是,如果您想NA在组键中包含值,您可以通过传递dropna=False来实现它。 In [28]: df_list = [[1, 2, 3], [1, None, 4], [2, 1, 3], [1, 2, 2]] In [29]: df_dropna = pd.DataFrame(df_list, columns=["a", "b", "c"]) In [30]: df_dropna Out[30]: a b c 0 1 2.0 3 1 1 NaN 4 2 2 1.0 3 3 1 2.0 2 # Default ``dropna`` is set to True, which will exclude NaNs in keys In [31]: df_dropna.groupby(by=["b"], dropna=True).sum() Out[31]: a c b 1.0 2 3 2.0 2 5 # In order to allow NaN in keys, set ``dropna`` to False In [32]: df_dropna.groupby(by=["b"], dropna=False).sum() Out[32]: a c b 1.0 2 3 2.0 2 5 NaN 1 4 参数的默认设置dropna是True这意味着NA不包含在组键中。 GroupBy 对象属性# 该groups属性是一个字典,其键是计算出的唯一组,对应的值是属于每个组的轴标签。在上面的例子中我们有: In [33]: df.groupby("A").groups Out[33]: {'bar': [1, 3, 5], 'foo': [0, 2, 4, 6, 7]} In [34]: df.T.groupby(get_letter_type).groups Out[34]: {'consonant': ['B', 'C', 'D'], 'vowel': ['A']} 对 GroupBy 对象调用标准 Pythonlen函数会返回组数,该数与groups字典的长度相同: In [35]: grouped = df.groupby(["A", "B"]) In [36]: grouped.groups Out[36]: {('bar', 'one'): [1], ('bar', 'three'): [3], ('bar', 'two'): [5], ('foo', 'one'): [0, 6], ('foo', 'three'): [7], ('foo', 'two'): [2, 4]} In [37]: len(grouped) Out[37]: 6 GroupBy将选项卡完整的列名称、GroupBy 操作和其他属性: In [38]: n = 10 In [39]: weight = np.random.normal(166, 20, size=n) In [40]: height = np.random.normal(60, 10, size=n) In [41]: time = pd.date_range("1/1/2000", periods=n) In [42]: gender = np.random.choice(["male", "female"], size=n) In [43]: df = pd.DataFrame( ....: {"height": height, "weight": weight, "gender": gender}, index=time ....: ) ....: In [44]: df Out[44]: height weight gender 2000-01-01 42.849980 157.500553 male 2000-01-02 49.607315 177.340407 male 2000-01-03 56.293531 171.524640 male 2000-01-04 48.421077 144.251986 female 2000-01-05 46.556882 152.526206 male 2000-01-06 68.448851 168.272968 female 2000-01-07 70.757698 136.431469 male 2000-01-08 58.909500 176.499753 female 2000-01-09 76.435631 174.094104 female 2000-01-10 45.306120 177.540920 male In [45]: gb = df.groupby("gender") In [46]: gb.<TAB> # noqa: E225, E999 gb.agg gb.boxplot gb.cummin gb.describe gb.filter gb.get_group gb.height gb.last gb.median gb.ngroups gb.plot gb.rank gb.std gb.transform gb.aggregate gb.count gb.cumprod gb.dtype gb.first gb.groups gb.hist gb.max gb.min gb.nth gb.prod gb.resample gb.sum gb.var gb.apply gb.cummax gb.cumsum gb.fillna gb.gender gb.head gb.indices gb.mean gb.name gb.ohlc gb.quantile gb.size gb.tail gb.weight 具有多重索引的 GroupBy # 对于分层索引的数据,按层次结构的某一级别进行分组是很自然的。 让我们创建一个具有两级的 Series MultiIndex。 In [47]: arrays = [ ....: ["bar", "bar", "baz", "baz", "foo", "foo", "qux", "qux"], ....: ["one", "two", "one", "two", "one", "two", "one", "two"], ....: ] ....: In [48]: index = pd.MultiIndex.from_arrays(arrays, names=["first", "second"]) In [49]: s = pd.Series(np.random.randn(8), index=index) In [50]: s Out[50]: first second bar one -0.919854 two -0.042379 baz one 1.247642 two -0.009920 foo one 0.290213 two 0.495767 qux one 0.362949 two 1.548106 dtype: float64 然后我们可以按 中的一个级别进行分组s。 In [51]: grouped = s.groupby(level=0) In [52]: grouped.sum() Out[52]: first bar -0.962232 baz 1.237723 foo 0.785980 qux 1.911055 dtype: float64 如果 MultiIndex 指定了名称,则可以传递这些名称而不是级别编号: In [53]: s.groupby(level="second").sum() Out[53]: second one 0.980950 two 1.991575 dtype: float64 支持多级别分组。 In [54]: arrays = [ ....: ["bar", "bar", "baz", "baz", "foo", "foo", "qux", "qux"], ....: ["doo", "doo", "bee", "bee", "bop", "bop", "bop", "bop"], ....: ["one", "two", "one", "two", "one", "two", "one", "two"], ....: ] ....: In [55]: index = pd.MultiIndex.from_arrays(arrays, names=["first", "second", "third"]) In [56]: s = pd.Series(np.random.randn(8), index=index) In [57]: s Out[57]: first second third bar doo one -1.131345 two -0.089329 baz bee one 0.337863 two -0.945867 foo bop one -0.932132 two 1.956030 qux bop one 0.017587 two -0.016692 dtype: float64 In [58]: s.groupby(level=["first", "second"]).sum() Out[58]: first second bar doo -1.220674 baz bee -0.608004 foo bop 1.023898 qux bop 0.000895 dtype: float64 索引级别名称可以作为键提供。 In [59]: s.groupby(["first", "second"]).sum() Out[59]: first second bar doo -1.220674 baz bee -0.608004 foo bop 1.023898 qux bop 0.000895 dtype: float64 稍后将详细介绍sum函数和聚合。 使用索引级别和列对 DataFrame 进行分组# DataFrame 可以按列和索引级别的组合进行分组。您可以指定列名称和索引名称,或使用Grouper. 让我们首先创建一个带有 MultiIndex 的 DataFrame: In [60]: arrays = [ ....: ["bar", "bar", "baz", "baz", "foo", "foo", "qux", "qux"], ....: ["one", "two", "one", "two", "one", "two", "one", "two"], ....: ] ....: In [61]: index = pd.MultiIndex.from_arrays(arrays, names=["first", "second"]) In [62]: df = pd.DataFrame({"A": [1, 1, 1, 1, 2, 2, 3, 3], "B": np.arange(8)}, index=index) In [63]: df Out[63]: A B first second bar one 1 0 two 1 1 baz one 1 2 two 1 3 foo one 2 4 two 2 5 qux one 3 6 two 3 7 然后我们df按second索引级别和A列进行分组。 In [64]: df.groupby([pd.Grouper(level=1), "A"]).sum() Out[64]: B second A one 1 2 2 4 3 6 two 1 4 2 5 3 7 索引级别也可以通过名称指定。 In [65]: df.groupby([pd.Grouper(level="second"), "A"]).sum() Out[65]: B second A one 1 2 2 4 3 6 two 1 4 2 5 3 7 索引级别名称可以直接指定为 的键groupby。 In [66]: df.groupby(["second", "A"]).sum() Out[66]: B second A one 1 2 2 4 3 6 two 1 4 2 5 3 7 GroupBy 中的 DataFrame 列选择# 从 DataFrame 创建 GroupBy 对象后,您可能希望对每一列执行不同的操作。因此,通过以[]与从 DataFrame 获取列类似的方式使用 GroupBy 对象,您可以执行以下操作: In [67]: df = pd.DataFrame( ....: { ....: "A": ["foo", "bar", "foo", "bar", "foo", "bar", "foo", "foo"], ....: "B": ["one", "one", "two", "three", "two", "two", "one", "three"], ....: "C": np.random.randn(8), ....: "D": np.random.randn(8), ....: } ....: ) ....: In [68]: df Out[68]: A B C D 0 foo one -0.575247 1.346061 1 bar one 0.254161 1.511763 2 foo two -1.143704 1.627081 3 bar three 0.215897 -0.990582 4 foo two 1.193555 -0.441652 5 bar two -0.077118 1.211526 6 foo one -0.408530 0.268520 7 foo three -0.862495 0.024580 In [69]: grouped = df.groupby(["A"]) In [70]: grouped_C = grouped["C"] In [71]: grouped_D = grouped["D"] 这主要是替代方案的语法糖,它更加冗长: In [72]: df["C"].groupby(df["A"]) Out[72]: <pandas.core.groupby.generic.SeriesGroupBy object at 0x7ff2cef1c730> 此外,此方法避免重新计算从传递的密钥派生的内部分组信息。 如果您想对其进行操作,还可以包含分组列。 In [73]: grouped[["A", "B"]].sum() Out[73]: A B A bar barbarbar onethreetwo foo foofoofoofoofoo onetwotwoonethree 遍历组# 有了 GroupBy 对象,迭代分组数据就变得非常自然,其功能类似于itertools.groupby(): In [74]: grouped = df.groupby('A') In [75]: for name, group in grouped: ....: print(name) ....: print(group) ....: bar A B C D 1 bar one 0.254161 1.511763 3 bar three 0.215897 -0.990582 5 bar two -0.077118 1.211526 foo A B C D 0 foo one -0.575247 1.346061 2 foo two -1.143704 1.627081 4 foo two 1.193555 -0.441652 6 foo one -0.408530 0.268520 7 foo three -0.862495 0.024580 在按多个键分组的情况下,组名称将是一个元组: In [76]: for name, group in df.groupby(['A', 'B']): ....: print(name) ....: print(group) ....: ('bar', 'one') A B C D 1 bar one 0.254161 1.511763 ('bar', 'three') A B C D 3 bar three 0.215897 -0.990582 ('bar', 'two') A B C D 5 bar two -0.077118 1.211526 ('foo', 'one') A B C D 0 foo one -0.575247 1.346061 6 foo one -0.408530 0.268520 ('foo', 'three') A B C D 7 foo three -0.862495 0.02458 ('foo', 'two') A B C D 2 foo two -1.143704 1.627081 4 foo two 1.193555 -0.441652 请参阅迭代组。 选择一个组# 可以使用以下方法选择单个组 DataFrameGroupBy.get_group(): In [77]: grouped.get_group("bar") Out[77]: A B C D 1 bar one 0.254161 1.511763 3 bar three 0.215897 -0.990582 5 bar two -0.077118 1.211526 或者对于按多列分组的对象: In [78]: df.groupby(["A", "B"]).get_group(("bar", "one")) Out[78]: A B C D 1 bar one 0.254161 1.511763 聚合# 聚合是一种 GroupBy 操作,可减少分组对象的维度。聚合的结果是(或至少被视为)组中每列的标量值。例如,生成一组值中每列的总和。 In [79]: animals = pd.DataFrame( ....: { ....: "kind": ["cat", "dog", "cat", "dog"], ....: "height": [9.1, 6.0, 9.5, 34.0], ....: "weight": [7.9, 7.5, 9.9, 198.0], ....: } ....: ) ....: In [80]: animals Out[80]: kind height weight 0 cat 9.1 7.9 1 dog 6.0 7.5 2 cat 9.5 9.9 3 dog 34.0 198.0 In [81]: animals.groupby("kind").sum() Out[81]: height weight kind cat 18.6 17.8 dog 40.0 205.5 结果中,组的键默认出现在索引中。可以通过传递将它们包含在列中as_index=False。 In [82]: animals.groupby("kind", as_index=False).sum() Out[82]: kind height weight 0 cat 18.6 17.8 1 dog 40.0 205.5 内置聚合方法# 许多常见的聚合作为方法内置于 GroupBy 对象中。在下面列出的方法中,那些带有 a 的方法*没有有效的、特定于 GroupBy 的实现。 方法 描述 any() 计算组中的任何值是否为真 all() 计算组中的所有值是否均为真值 count() 计算组中非 NA 值的数量 cov()* 计算组的协方差 first() 计算每组中第一个出现的值 idxmax() 计算每组中最大值的索引 idxmin() 计算每组中最小值的索引 last() 计算每组中最后出现的值 max() 计算每组中的最大值 mean() 计算每组的平均值 median() 计算每组的中位数 min() 计算每组中的最小值 nunique() 计算每组中唯一值的数量 prod() 计算每组中值的乘积 quantile() 计算每组中值的给定分位数 sem() 计算每组中值平均值的标准误差 size() 计算每组中的值的数量 skew()* 计算每组中值的偏差 std() 计算每组值的标准差 sum() 计算每组中的值的总和 var() 计算每组中值的方差 一些例子: In [83]: df.groupby("A")[["C", "D"]].max() Out[83]: C D A bar 0.254161 1.511763 foo 1.193555 1.627081 In [84]: df.groupby(["A", "B"]).mean() Out[84]: C D A B bar one 0.254161 1.511763 three 0.215897 -0.990582 two -0.077118 1.211526 foo one -0.491888 0.807291 three -0.862495 0.024580 two 0.024925 0.592714 另一个聚合示例是计算每个组的大小。这作为方法包含在 GroupBy 中size。它返回一个系列,其索引由组名称组成,值是每个组的大小。 In [85]: grouped = df.groupby(["A", "B"]) In [86]: grouped.size() Out[86]: A B bar one 1 three 1 two 1 foo one 2 three 1 two 2 dtype: int64 虽然该DataFrameGroupBy.describe()方法本身不是一个缩减器,但它可以用来方便地生成有关每个组的汇总统计数据的集合。 In [87]: grouped.describe() Out[87]: C ... D count mean std ... 50% 75% max A B ... bar one 1.0 0.254161 NaN ... 1.511763 1.511763 1.511763 three 1.0 0.215897 NaN ... -0.990582 -0.990582 -0.990582 two 1.0 -0.077118 NaN ... 1.211526 1.211526 1.211526 foo one 2.0 -0.491888 0.117887 ... 0.807291 1.076676 1.346061 three 1.0 -0.862495 NaN ... 0.024580 0.024580 0.024580 two 2.0 0.024925 1.652692 ... 0.592714 1.109898 1.627081 [6 rows x 16 columns] 另一个聚合示例是计算每个组的唯一值的数量。这与该函数类似DataFrameGroupBy.value_counts(),只不过它只计算唯一值的数量。 In [88]: ll = [['foo', 1], ['foo', 2], ['foo', 2], ['bar', 1], ['bar', 1]] In [89]: df4 = pd.DataFrame(ll, columns=["A", "B"]) In [90]: df4 Out[90]: A B 0 foo 1 1 foo 2 2 foo 2 3 bar 1 4 bar 1 In [91]: df4.groupby("A")["B"].nunique() Out[91]: A bar 1 foo 2 Name: B, dtype: int64 笔记 默认情况下,聚合函数不会将聚合的组返回为命名列as_index=True。分组的列将是返回对象的索引。 传递as_index=False 将返回您聚合为命名列的组,无论它们是输入中的命名索引还是列。 方法#aggregate() 笔记 该aggregate()方法可以接受许多不同类型的输入。本节详细介绍了各种 GroupBy 方法的字符串别名的使用;其他输入将在以下各节中详细介绍。 pandas 实现的任何归约方法都可以作为字符串传递给 aggregate().鼓励用户使用简写 agg.它将像调用相应的方法一样运行。 In [92]: grouped = df.groupby("A") In [93]: grouped[["C", "D"]].aggregate("sum") Out[93]: C D A bar 0.392940 1.732707 foo -1.796421 2.824590 In [94]: grouped = df.groupby(["A", "B"]) In [95]: grouped.agg("sum") Out[95]: C D A B bar one 0.254161 1.511763 three 0.215897 -0.990582 two -0.077118 1.211526 foo one -0.983776 1.614581 three -0.862495 0.024580 two 0.049851 1.185429 聚合的结果将以组名称作为新索引。如果有多个键,则结果 默认为MultiIndex 。如上所述,可以使用以下选项更改此as_index设置: In [96]: grouped = df.groupby(["A", "B"], as_index=False) In [97]: grouped.agg("sum") Out[97]: A B C D 0 bar one 0.254161 1.511763 1 bar three 0.215897 -0.990582 2 bar two -0.077118 1.211526 3 foo one -0.983776 1.614581 4 foo three -0.862495 0.024580 5 foo two 0.049851 1.185429 In [98]: df.groupby("A", as_index=False)[["C", "D"]].agg("sum") Out[98]: A C D 0 bar 0.392940 1.732707 1 foo -1.796421 2.824590 请注意,您可以使用DataFrame.reset_index()DataFrame 函数来获得与存储在 result 中的列名称相同的结果MultiIndex,尽管这会生成额外的副本。 In [99]: df.groupby(["A", "B"]).agg("sum").reset_index() Out[99]: A B C D 0 bar one 0.254161 1.511763 1 bar three 0.215897 -0.990582 2 bar two -0.077118 1.211526 3 foo one -0.983776 1.614581 4 foo three -0.862495 0.024580 5 foo two 0.049851 1.185429 与用户定义函数的聚合# 用户还可以提供自己的用户定义函数 (UDF) 来进行自定义聚合。 警告 当与 UDF 聚合时,UDF 不应改变提供的Series.有关更多信息,请参阅使用用户定义函数 (UDF) 方法进行变异。 笔记 使用 UDF 聚合的性能通常低于在 GroupBy 上使用 pandas 内置方法的性能。考虑将复杂的操作分解为利用内置方法的操作链。 In [100]: animals Out[100]: kind height weight 0 cat 9.1 7.9 1 dog 6.0 7.5 2 cat 9.5 9.9 3 dog 34.0 198.0 In [101]: animals.groupby("kind")[["height"]].agg(lambda x: set(x)) Out[101]: height kind cat {9.1, 9.5} dog {34.0, 6.0} 生成的数据类型将反映聚合函数的数据类型。如果不同组的结果具有不同的数据类型,则将以与DataFrame构建相同的方式确定公共数据类型。 In [102]: animals.groupby("kind")[["height"]].agg(lambda x: x.astype(int).sum()) Out[102]: height kind cat 18 dog 40 一次应用多个函数# 在 grouped 上Series,您可以将函数列表或字典传递给 SeriesGroupBy.agg(),输出 DataFrame: In [103]: grouped = df.groupby("A") In [104]: grouped["C"].agg(["sum", "mean", "std"]) Out[104]: sum mean std A bar 0.392940 0.130980 0.181231 foo -1.796421 -0.359284 0.912265 在 grouped 上DataFrame,您可以传递一个函数列表来 DataFrameGroupBy.agg()聚合每列,这会生成具有分层列索引的聚合结果: In [105]: grouped[["C", "D"]].agg(["sum", "mean", "std"]) Out[105]: C D sum mean std sum mean std A bar 0.392940 0.130980 0.181231 1.732707 0.577569 1.366330 foo -1.796421 -0.359284 0.912265 2.824590 0.564918 0.884785 生成的聚合以函数本身命名。如果您需要重命名,那么您可以添加链式操作,如下Series所示: In [106]: ( .....: grouped["C"] .....: .agg(["sum", "mean", "std"]) .....: .rename(columns={"sum": "foo", "mean": "bar", "std": "baz"}) .....: ) .....: Out[106]: foo bar baz A bar 0.392940 0.130980 0.181231 foo -1.796421 -0.359284 0.912265 对于分组的DataFrame,您可以以类似的方式重命名: In [107]: ( .....: grouped[["C", "D"]].agg(["sum", "mean", "std"]).rename( .....: columns={"sum": "foo", "mean": "bar", "std": "baz"} .....: ) .....: ) .....: Out[107]: C D foo bar baz foo bar baz A bar 0.392940 0.130980 0.181231 1.732707 0.577569 1.366330 foo -1.796421 -0.359284 0.912265 2.824590 0.564918 0.884785 笔记 一般来说,输出列名称应该是唯一的,但 pandas 将允许您将相同的函数(或具有相同名称的两个函数)应用于同一列。 In [108]: grouped["C"].agg(["sum", "sum"]) Out[108]: sum sum A bar 0.392940 0.392940 foo -1.796421 -1.796421 pandas 还允许您提供多个 lambda。在这种情况下,pandas 将修改(无名)lambda 函数的名称,并将其附加_<i> 到每个后续的 lambda 中。 In [109]: grouped["C"].agg([lambda x: x.max() - x.min(), lambda x: x.median() - x.mean()]) Out[109]: <lambda_0> <lambda_1> A bar 0.331279 0.084917 foo 2.337259 -0.215962 命名聚合# 为了支持特定于列的聚合并控制输出列名称DataFrameGroupBy.agg(),pandas 接受和中的特殊语法SeriesGroupBy.agg(),称为“命名聚合”,其中 关键字是输出列名称 这些值是元组,其第一个元素是要选择的列,第二个元素是要应用于该列的聚合。 pandasNamedAgg为namedtuple 提供了字段, 以使其更清楚参数是什么。像往常一样,聚合可以是可调用的或字符串别名。['column', 'aggfunc'] In [110]: animals Out[110]: kind height weight 0 cat 9.1 7.9 1 dog 6.0 7.5 2 cat 9.5 9.9 3 dog 34.0 198.0 In [111]: animals.groupby("kind").agg( .....: min_height=pd.NamedAgg(column="height", aggfunc="min"), .....: max_height=pd.NamedAgg(column="height", aggfunc="max"), .....: average_weight=pd.NamedAgg(column="weight", aggfunc="mean"), .....: ) .....: Out[111]: min_height max_height average_weight kind cat 9.1 9.5 8.90 dog 6.0 34.0 102.75 NamedAgg只是一个namedtuple.普通元组也是允许的。 In [112]: animals.groupby("kind").agg( .....: min_height=("height", "min"), .....: max_height=("height", "max"), .....: average_weight=("weight", "mean"), .....: ) .....: Out[112]: min_height max_height average_weight kind cat 9.1 9.5 8.90 dog 6.0 34.0 102.75 如果您想要的列名不是有效的 Python 关键字,请构造一个字典并解压关键字参数 In [113]: animals.groupby("kind").agg( .....: **{ .....: "total weight": pd.NamedAgg(column="weight", aggfunc="sum") .....: } .....: ) .....: Out[113]: total weight kind cat 17.8 dog 205.5 使用命名聚合时,附加关键字参数不会传递给聚合函数;只有对应该作为 传递。如果您的聚合函数需要其他参数,请使用 来部分应用它们。(column, aggfunc)**kwargsfunctools.partial() 命名聚合对于系列 groupby 聚合也有效。在这种情况下,没有列选择,因此值只是函数。 In [114]: animals.groupby("kind").height.agg( .....: min_height="min", .....: max_height="max", .....: ) .....: Out[114]: min_height max_height kind cat 9.1 9.5 dog 6.0 34.0 对 DataFrame 列应用不同的函数# 通过传递一个字典,aggregate您可以将不同的聚合应用于 DataFrame 的列: In [115]: grouped.agg({"C": "sum", "D": lambda x: np.std(x, ddof=1)}) Out[115]: C D A bar 0.392940 1.366330 foo -1.796421 0.884785 函数名称也可以是字符串。为了使字符串有效,必须在 GroupBy 上实现: In [116]: grouped.agg({"C": "sum", "D": "std"}) Out[116]: C D A bar 0.392940 1.366330 foo -1.796421 0.884785 转型# 转换是一种 GroupBy 操作,其结果的索引与分组的结果相同。常见的例子包括cumsum()和 diff()。 In [117]: speeds Out[117]: class order max_speed falcon bird Falconiformes 389.0 parrot bird Psittaciformes 24.0 lion mammal Carnivora 80.2 monkey mammal Primates NaN leopard mammal Carnivora 58.0 In [118]: grouped = speeds.groupby("class")["max_speed"] In [119]: grouped.cumsum() Out[119]: falcon 389.0 parrot 413.0 lion 80.2 monkey NaN leopard 138.2 Name: max_speed, dtype: float64 In [120]: grouped.diff() Out[120]: falcon NaN parrot -365.0 lion NaN monkey NaN leopard NaN Name: max_speed, dtype: float64 与聚合不同,用于分割原始对象的分组不包含在结果中。 笔记 由于转换不包括用于分割结果的分组,因此参数as_index和sortinDataFrame.groupby()和 Series.groupby()没有效果。 转换的常见用途是将结果添加回原始 DataFrame。 In [121]: result = speeds.copy() In [122]: result["cumsum"] = grouped.cumsum() In [123]: result["diff"] = grouped.diff() In [124]: result Out[124]: class order max_speed cumsum diff falcon bird Falconiformes 389.0 389.0 NaN parrot bird Psittaciformes 24.0 413.0 -365.0 lion mammal Carnivora 80.2 80.2 NaN monkey mammal Primates NaN NaN NaN leopard mammal Carnivora 58.0 138.2 NaN 内置转换方法# GroupBy 上的以下方法充当转换。 方法 描述 bfill() 回填每组内的 NA 值 cumcount() 计算每组内的累积计数 cummax() 计算每组内的累积最大值 cummin() 计算每组内的累积最小值 cumprod() 计算每组内的累积乘积 cumsum() 计算每组内的累积和 diff() 计算每组内相邻值之间的差异 ffill() 每组内前向填充 NA 值 pct_change() 计算每组内相邻值之间的百分比变化 rank() 计算每组中每个值的排名 shift() 在每组内向上或向下移动值 此外,将任何内置聚合方法作为字符串传递给 transform()(请参阅下一节)将在整个组中广播结果,从而生成转换后的结果。如果聚合方法有一个有效的实现,那么它也将是高性能的。 方法#transform() 与聚合方法类似,该 transform()方法可以接受上一节中内置转换方法的字符串别名。它还可以接受内置聚合方法的字符串别名。当提供聚合方法时,结果将在组内广播。 In [125]: speeds Out[125]: class order max_speed falcon bird Falconiformes 389.0 parrot bird Psittaciformes 24.0 lion mammal Carnivora 80.2 monkey mammal Primates NaN leopard mammal Carnivora 58.0 In [126]: grouped = speeds.groupby("class")[["max_speed"]] In [127]: grouped.transform("cumsum") Out[127]: max_speed falcon 389.0 parrot 413.0 lion 80.2 monkey NaN leopard 138.2 In [128]: grouped.transform("sum") Out[128]: max_speed falcon 413.0 parrot 413.0 lion 138.2 monkey 138.2 leopard 138.2 除了字符串别名之外,该transform()方法还可以接受用户定义函数 (UDF)。 UDF 必须: 返回一个与组块大小相同或可广播到组块大小的结果(例如标量 )。grouped.transform(lambda x: x.iloc[-1]) 对组块进行逐列操作。使用 chunk.apply 将变换应用于第一组块。 不对组块执行就地操作。组块应该被视为不可变的,对组块的更改可能会产生意外的结果。有关更多信息,请参阅使用用户定义函数 (UDF) 方法进行变异。 (可选)一次对整个组块的所有列进行操作。如果支持,则从第二个块开始使用快速路径。 笔记 通过提供 UDF 进行转换的transform性能通常低于使用 GroupBy 上的内置方法。考虑将复杂的操作分解为利用内置方法的操作链。 本节中的所有示例都可以通过调用内置方法而不是使用 UDF 来提高性能。请参阅下面的示例。 版本 2.0.0 中的更改:当在分组 DataFrame 上使用.transform并且转换函数返回 DataFrame 时,pandas 现在将结果的索引与输入的索引对齐。您可以.to_numpy()在转换函数内调用以避免对齐。 与aggregate()方法类似,生成的数据类型将反映转换函数的数据类型。如果不同组的结果具有不同的数据类型,则将以与DataFrame构建相同的方式确定公共数据类型。 假设我们希望标准化每组内的数据: In [129]: index = pd.date_range("10/1/1999", periods=1100) In [130]: ts = pd.Series(np.random.normal(0.5, 2, 1100), index) In [131]: ts = ts.rolling(window=100, min_periods=100).mean().dropna() In [132]: ts.head() Out[132]: 2000-01-08 0.779333 2000-01-09 0.778852 2000-01-10 0.786476 2000-01-11 0.782797 2000-01-12 0.798110 Freq: D, dtype: float64 In [133]: ts.tail() Out[133]: 2002-09-30 0.660294 2002-10-01 0.631095 2002-10-02 0.673601 2002-10-03 0.709213 2002-10-04 0.719369 Freq: D, dtype: float64 In [134]: transformed = ts.groupby(lambda x: x.year).transform( .....: lambda x: (x - x.mean()) / x.std() .....: ) .....: 我们预计结果现在每组内均值为 0,标准差为 1(最多浮点误差),我们可以轻松检查: # Original Data In [135]: grouped = ts.groupby(lambda x: x.year) In [136]: grouped.mean() Out[136]: 2000 0.442441 2001 0.526246 2002 0.459365 dtype: float64 In [137]: grouped.std() Out[137]: 2000 0.131752 2001 0.210945 2002 0.128753 dtype: float64 # Transformed Data In [138]: grouped_trans = transformed.groupby(lambda x: x.year) In [139]: grouped_trans.mean() Out[139]: 2000 -4.870756e-16 2001 -1.545187e-16 2002 4.136282e-16 dtype: float64 In [140]: grouped_trans.std() Out[140]: 2000 1.0 2001 1.0 2002 1.0 dtype: float64 我们还可以直观地比较原始数据集和转换后的数据集。 In [141]: compare = pd.DataFrame({"Original": ts, "Transformed": transformed}) In [142]: compare.plot() Out[142]: <Axes: > 具有较低维度输出的转换函数被广播以匹配输入数组的形状。 In [143]: ts.groupby(lambda x: x.year).transform(lambda x: x.max() - x.min()) Out[143]: 2000-01-08 0.623893 2000-01-09 0.623893 2000-01-10 0.623893 2000-01-11 0.623893 2000-01-12 0.623893 ... 2002-09-30 0.558275 2002-10-01 0.558275 2002-10-02 0.558275 2002-10-03 0.558275 2002-10-04 0.558275 Freq: D, Length: 1001, dtype: float64 另一种常见的数据转换是用组平均值替换缺失数据。 In [144]: cols = ["A", "B", "C"] In [145]: values = np.random.randn(1000, 3) In [146]: values[np.random.randint(0, 1000, 100), 0] = np.nan In [147]: values[np.random.randint(0, 1000, 50), 1] = np.nan In [148]: values[np.random.randint(0, 1000, 200), 2] = np.nan In [149]: data_df = pd.DataFrame(values, columns=cols) In [150]: data_df Out[150]: A B C 0 1.539708 -1.166480 0.533026 1 1.302092 -0.505754 NaN 2 -0.371983 1.104803 -0.651520 3 -1.309622 1.118697 -1.161657 4 -1.924296 0.396437 0.812436 .. ... ... ... 995 -0.093110 0.683847 -0.774753 996 -0.185043 1.438572 NaN 997 -0.394469 -0.642343 0.011374 998 -1.174126 1.857148 NaN 999 0.234564 0.517098 0.393534 [1000 rows x 3 columns] In [151]: countries = np.array(["US", "UK", "GR", "JP"]) In [152]: key = countries[np.random.randint(0, 4, 1000)] In [153]: grouped = data_df.groupby(key) # Non-NA count in each group In [154]: grouped.count() Out[154]: A B C GR 209 217 189 JP 240 255 217 UK 216 231 193 US 239 250 217 In [155]: transformed = grouped.transform(lambda x: x.fillna(x.mean())) 我们可以验证转换后的数据中的组均值没有改变,并且转换后的数据不包含 NA。 In [156]: grouped_trans = transformed.groupby(key) In [157]: grouped.mean() # original group means Out[157]: A B C GR -0.098371 -0.015420 0.068053 JP 0.069025 0.023100 -0.077324 UK 0.034069 -0.052580 -0.116525 US 0.058664 -0.020399 0.028603 In [158]: grouped_trans.mean() # transformation did not change group means Out[158]: A B C GR -0.098371 -0.015420 0.068053 JP 0.069025 0.023100 -0.077324 UK 0.034069 -0.052580 -0.116525 US 0.058664 -0.020399 0.028603 In [159]: grouped.count() # original has some missing data points Out[159]: A B C GR 209 217 189 JP 240 255 217 UK 216 231 193 US 239 250 217 In [160]: grouped_trans.count() # counts after transformation Out[160]: A B C GR 228 228 228 JP 267 267 267 UK 247 247 247 US 258 258 258 In [161]: grouped_trans.size() # Verify non-NA count equals group size Out[161]: GR 228 JP 267 UK 247 US 258 dtype: int64 正如上面的注释中提到的,本节中的每个示例都可以使用内置方法更有效地计算。在下面的代码中,使用 UDF 的低效方法被注释掉,下面显示了更快的替代方法。 # result = ts.groupby(lambda x: x.year).transform( # lambda x: (x - x.mean()) / x.std() # ) In [162]: grouped = ts.groupby(lambda x: x.year) In [163]: result = (ts - grouped.transform("mean")) / grouped.transform("std") # result = ts.groupby(lambda x: x.year).transform(lambda x: x.max() - x.min()) In [164]: grouped = ts.groupby(lambda x: x.year) In [165]: result = grouped.transform("max") - grouped.transform("min") # grouped = data_df.groupby(key) # result = grouped.transform(lambda x: x.fillna(x.mean())) In [166]: grouped = data_df.groupby(key) In [167]: result = data_df.fillna(grouped.transform("mean")) 窗口和重采样操作# 可以使用resample(),expanding()和 rolling()作为 groupby 上的方法。 下面的示例将rolling()根据 A 列的组对 B 列的样本应用该方法。 In [168]: df_re = pd.DataFrame({"A": [1] * 10 + [5] * 10, "B": np.arange(20)}) In [169]: df_re Out[169]: A B 0 1 0 1 1 1 2 1 2 3 1 3 4 1 4 .. .. .. 15 5 15 16 5 16 17 5 17 18 5 18 19 5 19 [20 rows x 2 columns] In [170]: df_re.groupby("A").rolling(4).B.mean() Out[170]: A 1 0 NaN 1 NaN 2 NaN 3 1.5 4 2.5 ... 5 15 13.5 16 14.5 17 15.5 18 16.5 19 17.5 Name: B, Length: 20, dtype: float64 该expanding()方法将为每个特定组的所有成员累积给定的操作(sum()在示例中)。 In [171]: df_re.groupby("A").expanding().sum() Out[171]: B A 1 0 0.0 1 1.0 2 3.0 3 6.0 4 10.0 ... ... 5 15 75.0 16 91.0 17 108.0 18 126.0 19 145.0 [20 rows x 1 columns] 假设您想使用该resample()方法获取数据帧每组中的每日频率,并希望使用该ffill()方法完成缺失值。 In [172]: df_re = pd.DataFrame( .....: { .....: "date": pd.date_range(start="2016-01-01", periods=4, freq="W"), .....: "group": [1, 1, 2, 2], .....: "val": [5, 6, 7, 8], .....: } .....: ).set_index("date") .....: In [173]: df_re Out[173]: group val date 2016-01-03 1 5 2016-01-10 1 6 2016-01-17 2 7 2016-01-24 2 8 In [174]: df_re.groupby("group").resample("1D", include_groups=False).ffill() Out[174]: val group date 1 2016-01-03 5 2016-01-04 5 2016-01-05 5 2016-01-06 5 2016-01-07 5 ... ... 2 2016-01-20 7 2016-01-21 7 2016-01-22 7 2016-01-23 7 2016-01-24 8 [16 rows x 1 columns] 过滤# 过滤是对原始分组对象进行子集化的 GroupBy 操作。它可以过滤掉整个组、部分组或两者。过滤返回调用对象的过滤版本,包括提供的分组列。在以下示例中,class包含在结果中。 In [175]: speeds Out[175]: class order max_speed falcon bird Falconiformes 389.0 parrot bird Psittaciformes 24.0 lion mammal Carnivora 80.2 monkey mammal Primates NaN leopard mammal Carnivora 58.0 In [176]: speeds.groupby("class").nth(1) Out[176]: class order max_speed parrot bird Psittaciformes 24.0 monkey mammal Primates NaN 笔记 与聚合不同,过滤不会将组键添加到结果的索引中。正因为如此,通过as_index=False或sort=True不会影响这些方法。 过滤将考虑对 GroupBy 对象的列进行子集化。 In [177]: speeds.groupby("class")[["order", "max_speed"]].nth(1) Out[177]: order max_speed parrot Psittaciformes 24.0 monkey Primates NaN 内置过滤# GroupBy 上的以下方法充当过滤。所有这些方法都有一个高效的、特定于 GroupBy 的实现。 方法 描述 head() 选择每组的顶行 nth() 选择每组的第 n 行 tail() 选择每组的底行 用户还可以使用转换和布尔索引在组内构建复杂的过滤。例如,假设我们给定了一组产品及其数量,并且我们希望将数据子集到仅捕获每组内总数量不超过 90% 的最大产品。 In [178]: product_volumes = pd.DataFrame( .....: { .....: "group": list("xxxxyyy"), .....: "product": list("abcdefg"), .....: "volume": [10, 30, 20, 15, 40, 10, 20], .....: } .....: ) .....: In [179]: product_volumes Out[179]: group product volume 0 x a 10 1 x b 30 2 x c 20 3 x d 15 4 y e 40 5 y f 10 6 y g 20 # Sort by volume to select the largest products first In [180]: product_volumes = product_volumes.sort_values("volume", ascending=False) In [181]: grouped = product_volumes.groupby("group")["volume"] In [182]: cumpct = grouped.cumsum() / grouped.transform("sum") In [183]: cumpct Out[183]: 4 0.571429 1 0.400000 2 0.666667 6 0.857143 3 0.866667 0 1.000000 5 1.000000 Name: volume, dtype: float64 In [184]: significant_products = product_volumes[cumpct <= 0.9] In [185]: significant_products.sort_values(["group", "product"]) Out[185]: group product volume 1 x b 30 2 x c 20 3 x d 15 4 y e 40 6 y g 20 方法#filter 笔记 通过提供用户定义函数 (UDF) 进行过滤filter的性能通常低于使用 GroupBy 上的内置方法。考虑将复杂的操作分解为利用内置方法的操作链。 该filter方法采用用户定义函数 (UDF),当应用于整个组时,返回True或False。该方法的结果filter 就是 UDF 返回的组的子集True。 假设我们只想取出属于组和大于 2 的组的元素。 In [186]: sf = pd.Series([1, 1, 2, 3, 3, 3]) In [187]: sf.groupby(sf).filter(lambda x: x.sum() > 2) Out[187]: 3 3 4 3 5 3 dtype: int64 另一个有用的操作是过滤掉属于只有几个成员的组的元素。 In [188]: dff = pd.DataFrame({"A": np.arange(8), "B": list("aabbbbcc")}) In [189]: dff.groupby("B").filter(lambda x: len(x) > 2) Out[189]: A B 2 2 b 3 3 b 4 4 b 5 5 b 或者,我们可以返回类似索引的对象,而不是删除有问题的组,其中未通过过滤器的组将填充 NaN。 In [190]: dff.groupby("B").filter(lambda x: len(x) > 2, dropna=False) Out[190]: A B 0 NaN NaN 1 NaN NaN 2 2.0 b 3 3.0 b 4 4.0 b 5 5.0 b 6 NaN NaN 7 NaN NaN 对于具有多列的 DataFrame,过滤器应明确指定一列作为过滤条件。 In [191]: dff["C"] = np.arange(8) In [192]: dff.groupby("B").filter(lambda x: len(x["C"]) > 2) Out[192]: A B C 2 2 b 2 3 3 b 3 4 4 b 4 5 5 b 5 灵活的apply# 对分组数据的某些操作可能不适合聚合、转换或过滤类别。对于这些,您可以使用该apply 功能。 警告 apply必须尝试从结果中推断它是否应该充当减速器、变压器或过滤器,具体取决于传递给它的内容。因此,分组的列可以包含在输出中,也可以不包含在输出中。虽然它试图智能地猜测如何行为,但有时它可能会猜错。 笔记 使用其他 pandas 功能可以更可靠、更高效地计算本节中的所有示例。 In [193]: df Out[193]: A B C D 0 foo one -0.575247 1.346061 1 bar one 0.254161 1.511763 2 foo two -1.143704 1.627081 3 bar three 0.215897 -0.990582 4 foo two 1.193555 -0.441652 5 bar two -0.077118 1.211526 6 foo one -0.408530 0.268520 7 foo three -0.862495 0.024580 In [194]: grouped = df.groupby("A") # could also just call .describe() In [195]: grouped["C"].apply(lambda x: x.describe()) Out[195]: A bar count 3.000000 mean 0.130980 std 0.181231 min -0.077118 25% 0.069390 ... foo min -1.143704 25% -0.862495 50% -0.575247 75% -0.408530 max 1.193555 Name: C, Length: 16, dtype: float64 返回结果的维度也可以改变: In [196]: grouped = df.groupby('A')['C'] In [197]: def f(group): .....: return pd.DataFrame({'original': group, .....: 'demeaned': group - group.mean()}) .....: In [198]: grouped.apply(f) Out[198]: original demeaned A bar 1 0.254161 0.123181 3 0.215897 0.084917 5 -0.077118 -0.208098 foo 0 -0.575247 -0.215962 2 -1.143704 -0.784420 4 1.193555 1.552839 6 -0.408530 -0.049245 7 -0.862495 -0.503211 applyon a Series 可以对应用函数的返回值进行操作,该函数本身就是一个系列,并且可能将结果向上转换为 DataFrame: In [199]: def f(x): .....: return pd.Series([x, x ** 2], index=["x", "x^2"]) .....: In [200]: s = pd.Series(np.random.rand(5)) In [201]: s Out[201]: 0 0.582898 1 0.098352 2 0.001438 3 0.009420 4 0.815826 dtype: float64 In [202]: s.apply(f) Out[202]: x x^2 0 0.582898 0.339770 1 0.098352 0.009673 2 0.001438 0.000002 3 0.009420 0.000089 4 0.815826 0.665572 与aggregate()方法类似,生成的数据类型将反映apply函数的数据类型。如果不同组的结果具有不同的数据类型,则将以与DataFrame构建相同的方式确定公共数据类型。 使用#控制分组列的位置group_keys 要控制分组列是否包含在索引中,您可以使用group_keys默认为 的参数True。比较 In [203]: df.groupby("A", group_keys=True).apply(lambda x: x, include_groups=False) Out[203]: B C D A bar 1 one 0.254161 1.511763 3 three 0.215897 -0.990582 5 two -0.077118 1.211526 foo 0 one -0.575247 1.346061 2 two -1.143704 1.627081 4 two 1.193555 -0.441652 6 one -0.408530 0.268520 7 three -0.862495 0.024580 和 In [204]: df.groupby("A", group_keys=False).apply(lambda x: x, include_groups=False) Out[204]: B C D 0 one -0.575247 1.346061 1 one 0.254161 1.511763 2 two -1.143704 1.627081 3 three 0.215897 -0.990582 4 two 1.193555 -0.441652 5 two -0.077118 1.211526 6 one -0.408530 0.268520 7 three -0.862495 0.024580 Numba 加速例程# 1.1 版本中的新增内容。 如果Numba作为可选依赖项安装,则transform和 aggregate方法支持engine='numba'和engine_kwargs参数。有关参数的一般用法和性能注意事项,请参阅使用 Numba 增强性能。 函数签名必须以与将传递到 的属于每个组的数据完全相同的开头,并且将传递到 的组索引。values, index valuesindex 警告 使用时engine='numba',内部不会有“回退”行为。组数据和组索引将作为 NumPy 数组传递到 JITed 用户定义的函数,并且不会尝试其他执行尝试。 其他有用的功能# 排除非数字列# 再次考虑我们一直在查看的示例 DataFrame: In [205]: df Out[205]: A B C D 0 foo one -0.575247 1.346061 1 bar one 0.254161 1.511763 2 foo two -1.143704 1.627081 3 bar three 0.215897 -0.990582 4 foo two 1.193555 -0.441652 5 bar two -0.077118 1.211526 6 foo one -0.408530 0.268520 7 foo three -0.862495 0.024580 假设我们希望计算按列分组的标准差A 。有一个小问题,即我们不关心列中的数据,B因为它不是数字。您可以通过指定来避免非数字列numeric_only=True: In [206]: df.groupby("A").std(numeric_only=True) Out[206]: C D A bar 0.181231 1.366330 foo 0.912265 0.884785 请注意,这df.groupby('A').colname.std().比 更有效 df.groupby('A').std().colname。因此,如果仅需要一列(此处colname)的聚合函数的结果,则可以 在应用聚合函数之前对其进行过滤。 In [207]: from decimal import Decimal In [208]: df_dec = pd.DataFrame( .....: { .....: "id": [1, 2, 1, 2], .....: "int_column": [1, 2, 3, 4], .....: "dec_column": [ .....: Decimal("0.50"), .....: Decimal("0.15"), .....: Decimal("0.25"), .....: Decimal("0.40"), .....: ], .....: } .....: ) .....: In [209]: df_dec.groupby(["id"])[["dec_column"]].sum() Out[209]: dec_column id 1 0.75 2 0.55 处理(未)观察到的分类值# 使用Categorical石斑鱼(作为单个石斑鱼或作为多个石斑鱼的一部分)时,关键字控制是返回所有可能的石斑鱼值 ( ) 还是仅返回那些观察到的石斑鱼值 ( )observed的笛卡尔积。observed=Falseobserved=True 显示所有值: In [210]: pd.Series([1, 1, 1]).groupby( .....: pd.Categorical(["a", "a", "a"], categories=["a", "b"]), observed=False .....: ).count() .....: Out[210]: a 3 b 0 dtype: int64 仅显示观测值: In [211]: pd.Series([1, 1, 1]).groupby( .....: pd.Categorical(["a", "a", "a"], categories=["a", "b"]), observed=True .....: ).count() .....: Out[211]: a 3 dtype: int64 分组的返回数据类型将始终包含分组的所有类别。 In [212]: s = ( .....: pd.Series([1, 1, 1]) .....: .groupby(pd.Categorical(["a", "a", "a"], categories=["a", "b"]), observed=True) .....: .count() .....: ) .....: In [213]: s.index.dtype Out[213]: CategoricalDtype(categories=['a', 'b'], ordered=False, categories_dtype=object) NA 组处理# NA我们指的是任何值NA,包括 NA、NaN、NaT和None。如果NA分组键中有任何值,默认情况下这些值将被排除。换句话说,任何“NA组”都将被删除。您可以通过指定 来包含 NA 组dropna=False。 In [214]: df = pd.DataFrame({"key": [1.0, 1.0, np.nan, 2.0, np.nan], "A": [1, 2, 3, 4, 5]}) In [215]: df Out[215]: key A 0 1.0 1 1 1.0 2 2 NaN 3 3 2.0 4 4 NaN 5 In [216]: df.groupby("key", dropna=True).sum() Out[216]: A key 1.0 3 2.0 4 In [217]: df.groupby("key", dropna=False).sum() Out[217]: A key 1.0 3 2.0 4 NaN 8 按有序因素分组# 表示为 pandasCategorical类实例的分类变量可以用作组键。如果是这样,级别的顺序将被保留。当 observed=False和时sort=False,任何未观察到的类别将按顺序位于结果的末尾。 In [218]: days = pd.Categorical( .....: values=["Wed", "Mon", "Thu", "Mon", "Wed", "Sat"], .....: categories=["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"], .....: ) .....: In [219]: data = pd.DataFrame( .....: { .....: "day": days, .....: "workers": [3, 4, 1, 4, 2, 2], .....: } .....: ) .....: In [220]: data Out[220]: day workers 0 Wed 3 1 Mon 4 2 Thu 1 3 Mon 4 4 Wed 2 5 Sat 2 In [221]: data.groupby("day", observed=False, sort=True).sum() Out[221]: workers day Mon 8 Tue 0 Wed 5 Thu 1 Fri 0 Sat 2 Sun 0 In [222]: data.groupby("day", observed=False, sort=False).sum() Out[222]: workers day Wed 5 Mon 8 Thu 1 Sat 2 Tue 0 Fri 0 Sun 0 使用石斑鱼规范进行分组# 您可能需要指定更多数据才能正确分组。您可以使用pd.Grouper来提供此本地控制。 In [223]: import datetime In [224]: df = pd.DataFrame( .....: { .....: "Branch": "A A A A A A A B".split(), .....: "Buyer": "Carl Mark Carl Carl Joe Joe Joe Carl".split(), .....: "Quantity": [1, 3, 5, 1, 8, 1, 9, 3], .....: "Date": [ .....: datetime.datetime(2013, 1, 1, 13, 0), .....: datetime.datetime(2013, 1, 1, 13, 5), .....: datetime.datetime(2013, 10, 1, 20, 0), .....: datetime.datetime(2013, 10, 2, 10, 0), .....: datetime.datetime(2013, 10, 1, 20, 0), .....: datetime.datetime(2013, 10, 2, 10, 0), .....: datetime.datetime(2013, 12, 2, 12, 0), .....: datetime.datetime(2013, 12, 2, 14, 0), .....: ], .....: } .....: ) .....: In [225]: df Out[225]: Branch Buyer Quantity Date 0 A Carl 1 2013-01-01 13:00:00 1 A Mark 3 2013-01-01 13:05:00 2 A Carl 5 2013-10-01 20:00:00 3 A Carl 1 2013-10-02 10:00:00 4 A Joe 8 2013-10-01 20:00:00 5 A Joe 1 2013-10-02 10:00:00 6 A Joe 9 2013-12-02 12:00:00 7 B Carl 3 2013-12-02 14:00:00 按所需频率对特定列进行分组。这就像重新采样。 In [226]: df.groupby([pd.Grouper(freq="1ME", key="Date"), "Buyer"])[["Quantity"]].sum() Out[226]: Quantity Date Buyer 2013-01-31 Carl 1 Mark 3 2013-10-31 Carl 6 Joe 9 2013-12-31 Carl 3 Joe 9 当freq指定时,返回的对象pd.Grouper将是 的实例pandas.api.typing.TimeGrouper。当存在同名的列和索引时,可以使用key按列分组和level 按索引分组。 In [227]: df = df.set_index("Date") In [228]: df["Date"] = df.index + pd.offsets.MonthEnd(2) In [229]: df.groupby([pd.Grouper(freq="6ME", key="Date"), "Buyer"])[["Quantity"]].sum() Out[229]: Quantity Date Buyer 2013-02-28 Carl 1 Mark 3 2014-02-28 Carl 9 Joe 18 In [230]: df.groupby([pd.Grouper(freq="6ME", level="Date"), "Buyer"])[["Quantity"]].sum() Out[230]: Quantity Date Buyer 2013-01-31 Carl 1 Mark 3 2014-01-31 Carl 9 Joe 18 取每组的第一行# 就像 DataFrame 或 Series 一样,您可以在 groupby 上调用 head 和 tail: In [231]: df = pd.DataFrame([[1, 2], [1, 4], [5, 6]], columns=["A", "B"]) In [232]: df Out[232]: A B 0 1 2 1 1 4 2 5 6 In [233]: g = df.groupby("A") In [234]: g.head(1) Out[234]: A B 0 1 2 2 5 6 In [235]: g.tail(1) Out[235]: A B 1 1 4 2 5 6 这显示了每组的前 n 行或后 n 行。 取每组的第n行# 要从每组中选择第 n 个项目,请使用DataFrameGroupBy.nth()或 SeriesGroupBy.nth()。提供的参数可以是任何整数、整数列表、切片或切片列表;请参阅下面的示例。当组的第 n 个元素不存在时,不会引发错误;相反,不会返回相应的行。 一般来说,该操作起到过滤的作用。在某些情况下,它还会为每组返回一行,从而实现减少。然而,因为通常它可以返回每组零或多行,所以 pandas 在所有情况下都将其视为过滤。 In [236]: df = pd.DataFrame([[1, np.nan], [1, 4], [5, 6]], columns=["A", "B"]) In [237]: g = df.groupby("A") In [238]: g.nth(0) Out[238]: A B 0 1 NaN 2 5 6.0 In [239]: g.nth(-1) Out[239]: A B 1 1 4.0 2 5 6.0 In [240]: g.nth(1) Out[240]: A B 1 1 4.0 如果组中的第 n 个元素不存在,则结果中不包含相应的行。特别是,如果指定的数据n大于任何组,则结果将是一个空的 DataFrame。 In [241]: g.nth(5) Out[241]: Empty DataFrame Columns: [A, B] Index: [] 如果要选择第 n 个非空项,请使用 kwarg dropna。对于 DataFrame,这应该是'any'或者'all'就像您传递给 dropna 的那样: # nth(0) is the same as g.first() In [242]: g.nth(0, dropna="any") Out[242]: A B 1 1 4.0 2 5 6.0 In [243]: g.first() Out[243]: B A 1 4.0 5 6.0 # nth(-1) is the same as g.last() In [244]: g.nth(-1, dropna="any") Out[244]: A B 1 1 4.0 2 5 6.0 In [245]: g.last() Out[245]: B A 1 4.0 5 6.0 In [246]: g.B.nth(0, dropna="all") Out[246]: 1 4.0 2 6.0 Name: B, dtype: float64 您还可以通过将多个第 n 个值指定为整数列表来从每个组中选择多行。 In [247]: business_dates = pd.date_range(start="4/1/2014", end="6/30/2014", freq="B") In [248]: df = pd.DataFrame(1, index=business_dates, columns=["a", "b"]) # get the first, 4th, and last date index for each month In [249]: df.groupby([df.index.year, df.index.month]).nth([0, 3, -1]) Out[249]: a b 2014-04-01 1 1 2014-04-04 1 1 2014-04-30 1 1 2014-05-01 1 1 2014-05-06 1 1 2014-05-30 1 1 2014-06-02 1 1 2014-06-05 1 1 2014-06-30 1 1 您还可以使用切片或切片列表。 In [250]: df.groupby([df.index.year, df.index.month]).nth[1:] Out[250]: a b 2014-04-02 1 1 2014-04-03 1 1 2014-04-04 1 1 2014-04-07 1 1 2014-04-08 1 1 ... .. .. 2014-06-24 1 1 2014-06-25 1 1 2014-06-26 1 1 2014-06-27 1 1 2014-06-30 1 1 [62 rows x 2 columns] In [251]: df.groupby([df.index.year, df.index.month]).nth[1:, :-1] Out[251]: a b 2014-04-01 1 1 2014-04-02 1 1 2014-04-03 1 1 2014-04-04 1 1 2014-04-07 1 1 ... .. .. 2014-06-24 1 1 2014-06-25 1 1 2014-06-26 1 1 2014-06-27 1 1 2014-06-30 1 1 [65 rows x 2 columns] 枚举组项# 要查看每行在其组中出现的顺序,请使用以下 cumcount方法: In [252]: dfg = pd.DataFrame(list("aaabba"), columns=["A"]) In [253]: dfg Out[253]: A 0 a 1 a 2 a 3 b 4 b 5 a In [254]: dfg.groupby("A").cumcount() Out[254]: 0 0 1 1 2 2 3 0 4 1 5 3 dtype: int64 In [255]: dfg.groupby("A").cumcount(ascending=False) Out[255]: 0 3 1 2 2 1 3 1 4 0 5 0 dtype: int64 枚举组# 要查看组的顺序(而不是由 给出的组内的行顺序cumcount),您可以使用 DataFrameGroupBy.ngroup()。 请注意,为组提供的数字与迭代 groupby 对象时看到的顺序相匹配,而不是首次观察到的顺序。 In [256]: dfg = pd.DataFrame(list("aaabba"), columns=["A"]) In [257]: dfg Out[257]: A 0 a 1 a 2 a 3 b 4 b 5 a In [258]: dfg.groupby("A").ngroup() Out[258]: 0 0 1 0 2 0 3 1 4 1 5 0 dtype: int64 In [259]: dfg.groupby("A").ngroup(ascending=False) Out[259]: 0 1 1 1 2 1 3 0 4 0 5 1 dtype: int64 绘图# Groupby 还可以使用一些绘图方法。在这种情况下,假设我们怀疑“B”组中第 1 列中的值平均高出 3 倍。 In [260]: np.random.seed(1234) In [261]: df = pd.DataFrame(np.random.randn(50, 2)) In [262]: df["g"] = np.random.choice(["A", "B"], size=50) In [263]: df.loc[df["g"] == "B", 1] += 3 我们可以使用箱线图轻松地将其可视化: In [264]: df.groupby("g").boxplot() Out[264]: A Axes(0.1,0.15;0.363636x0.75) B Axes(0.536364,0.15;0.363636x0.75) dtype: object 调用的结果boxplot是一个字典,其键是分组列的值g(“A”和“B”)。生成的字典的值可以由return_type关键字 of控制boxplot。有关更多信息,请参阅可视化文档。 警告 由于历史原因,df.groupby("g").boxplot()不等于df.boxplot(by="g")。请参阅此处了解解释。 管道函数调用# DataFrame与and提供的功能类似Series,采用GroupBy对象的函数可以使用某种方法链接在一起,pipe以实现更清晰、更易读的语法。要阅读.pipe一般术语,请参阅此处。 当您需要重用 GroupBy 对象时,组合.groupbyand通常很有用。.pipe 举个例子,假设有一个 DataFrame,其中包含商店、产品、收入和销售数量的列。我们希望对每个商店和每个产品的价格 (即收入/数量)进行分组计算。我们可以通过多步操作来完成此操作,但用管道表示可以使代码更具可读性。首先我们设置数据: In [265]: n = 1000 In [266]: df = pd.DataFrame( .....: { .....: "Store": np.random.choice(["Store_1", "Store_2"], n), .....: "Product": np.random.choice(["Product_1", "Product_2"], n), .....: "Revenue": (np.random.random(n) * 50 + 10).round(2), .....: "Quantity": np.random.randint(1, 10, size=n), .....: } .....: ) .....: In [267]: df.head(2) Out[267]: Store Product Revenue Quantity 0 Store_2 Product_1 26.12 1 1 Store_2 Product_1 28.86 1 我们现在找到每个商店/产品的价格。 In [268]: ( .....: df.groupby(["Store", "Product"]) .....: .pipe(lambda grp: grp.Revenue.sum() / grp.Quantity.sum()) .....: .unstack() .....: .round(2) .....: ) .....: Out[268]: Product Product_1 Product_2 Store Store_1 6.82 7.05 Store_2 6.30 6.64 当您想要将分组对象传递给某个任意函数时,管道也可以具有表现力,例如: In [269]: def mean(groupby): .....: return groupby.mean() .....: In [270]: df.groupby(["Store", "Product"]).pipe(mean) Out[270]: Revenue Quantity Store Product Store_1 Product_1 34.622727 5.075758 Product_2 35.482815 5.029630 Store_2 Product_1 32.972837 5.237589 Product_2 34.684360 5.224000 这里mean采用一个 GroupBy 对象,并分别查找每个商店-产品组合的收入和数量列的平均值。该mean函数可以是任何接受 GroupBy 对象的函数;会将.pipeGroupBy 对象作为参数传递到您指定的函数中。 例子# 多列分解# 通过使用,我们可以以类似于(如重塑 APIDataFrameGroupBy.ngroup()中进一步描述)的方式提取有关组的信息,但它自然适用于混合类型和不同源的多个列。当组行之间的关系比其内容更重要时,这可以用作处理中的类似分类的中间步骤,或者作为仅接受整数编码的算法的输入。 (有关 pandas 对完整分类数据的支持的更多信息,请参阅分类简介和 API 文档。)factorize() In [271]: dfg = pd.DataFrame({"A": [1, 1, 2, 3, 2], "B": list("aaaba")}) In [272]: dfg Out[272]: A B 0 1 a 1 1 a 2 2 a 3 3 b 4 2 a In [273]: dfg.groupby(["A", "B"]).ngroup() Out[273]: 0 0 1 0 2 1 3 2 4 1 dtype: int64 In [274]: dfg.groupby(["A", [0, 0, 0, 1, 1]]).ngroup() Out[274]: 0 0 1 0 2 1 3 3 4 2 dtype: int64 按索引器分组以“重新采样”数据# 重采样从现有的观测数据或生成数据的模型中生成新的假设样本(重采样)。这些新样本与先前存在的样本相似。 为了对非日期时间索引进行重采样,可以使用以下过程。 在以下示例中,df.index // 5返回一个整数数组,用于确定为 groupby 操作选择的内容。 笔记 下面的示例展示了如何通过将样本合并为更少的样本来进行下采样。这里通过使用df.index // 5,我们将样本聚合到 bin 中。通过应用std() 函数,我们将许多样本中包含的信息聚合成一个小的值子集,即它们的标准差,从而减少样本数量。 In [275]: df = pd.DataFrame(np.random.randn(10, 2)) In [276]: df Out[276]: 0 1 0 -0.793893 0.321153 1 0.342250 1.618906 2 -0.975807 1.918201 3 -0.810847 -1.405919 4 -1.977759 0.461659 5 0.730057 -1.316938 6 -0.751328 0.528290 7 -0.257759 -1.081009 8 0.505895 -1.701948 9 -1.006349 0.020208 In [277]: df.index // 5 Out[277]: Index([0, 0, 0, 0, 0, 1, 1, 1, 1, 1], dtype='int64') In [278]: df.groupby(df.index // 5).std() Out[278]: 0 1 0 0.823647 1.312912 1 0.760109 0.942941 返回一个系列来传播名称# 对 DataFrame 列进行分组,计算一组指标并返回一个命名的系列。系列名称用作列索引的名称。这在与堆叠等整形操作结合使用时特别有用,其中列索引名称将用作插入列的名称: In [279]: df = pd.DataFrame( .....: { .....: "a": [0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2], .....: "b": [0, 0, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1], .....: "c": [1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0], .....: "d": [0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1], .....: } .....: ) .....: In [280]: def compute_metrics(x): .....: result = {"b_sum": x["b"].sum(), "c_mean": x["c"].mean()} .....: return pd.Series(result, name="metrics") .....: In [281]: result = df.groupby("a").apply(compute_metrics, include_groups=False) In [282]: result Out[282]: metrics b_sum c_mean a 0 2.0 0.5 1 2.0 0.5 2 2.0 0.5 In [283]: result.stack(future_stack=True) Out[283]: a metrics 0 b_sum 2.0 c_mean 0.5 1 b_sum 2.0 c_mean 0.5 2 b_sum 2.0 c_mean 0.5 dtype: float64