GroupBy¶
GroupBy objects are returned by groupby calls: pandas.DataFrame.groupby()
, pandas.Series.groupby()
, etc.
Indexing, iteration¶
GroupBy.__iter__ () |
Groupby iterator. |
GroupBy.groups |
Dict {group name -> group labels}. |
GroupBy.indices |
Dict {group name -> group indices}. |
GroupBy.get_group (name[, obj]) |
Constructs NDFrame from group with provided name. |
Grouper ([key, level, freq, axis, sort]) |
A Grouper allows the user to specify a groupby instruction for a target object |
Function application¶
GroupBy.apply (func, *args, **kwargs) |
Apply function func group-wise and combine the results together. |
GroupBy.agg (func, *args, **kwargs) |
|
GroupBy.aggregate (func, *args, **kwargs) |
|
GroupBy.transform (func, *args, **kwargs) |
|
GroupBy.pipe (func, *args, **kwargs) |
Apply a function func with arguments to this GroupBy object and return the function’s result. |
Computations / Descriptive Stats¶
GroupBy.all ([skipna]) |
Returns True if all values in the group are truthful, else False. |
GroupBy.any ([skipna]) |
Returns True if any value in the group is truthful, else False. |
GroupBy.bfill ([limit]) |
Backward fill the values. |
GroupBy.count () |
Compute count of group, excluding missing values. |
GroupBy.cumcount ([ascending]) |
Number each item in each group from 0 to the length of that group - 1. |
GroupBy.ffill ([limit]) |
Forward fill the values. |
GroupBy.first (**kwargs) |
Compute first of group values See Also ——– pandas.Series.groupby pandas.DataFrame.groupby pandas.Panel.groupby |
GroupBy.head ([n]) |
Returns first n rows of each group. |
GroupBy.last (**kwargs) |
Compute last of group values See Also ——– pandas.Series.groupby pandas.DataFrame.groupby pandas.Panel.groupby |
GroupBy.max (**kwargs) |
Compute max of group values See Also ——– pandas.Series.groupby pandas.DataFrame.groupby pandas.Panel.groupby |
GroupBy.mean (*args, **kwargs) |
Compute mean of groups, excluding missing values. |
GroupBy.median (**kwargs) |
Compute median of groups, excluding missing values. |
GroupBy.min (**kwargs) |
Compute min of group values See Also ——– pandas.Series.groupby pandas.DataFrame.groupby pandas.Panel.groupby |
GroupBy.ngroup ([ascending]) |
Number each group from 0 to the number of groups - 1. |
GroupBy.nth (n[, dropna]) |
Take the nth row from each group if n is an int, or a subset of rows if n is a list of ints. |
GroupBy.ohlc () |
Compute sum of values, excluding missing values. |
GroupBy.prod (**kwargs) |
Compute prod of group values See Also ——– pandas.Series.groupby pandas.DataFrame.groupby pandas.Panel.groupby |
GroupBy.rank ([method, ascending, na_option, …]) |
Provides the rank of values within each group. |
GroupBy.pct_change ([periods, fill_method, …]) |
Calculate pct_change of each value to previous entry in group. |
GroupBy.size () |
Compute group sizes. |
GroupBy.sem ([ddof]) |
Compute standard error of the mean of groups, excluding missing values. |
GroupBy.std ([ddof]) |
Compute standard deviation of groups, excluding missing values. |
GroupBy.sum (**kwargs) |
Compute sum of group values See Also ——– pandas.Series.groupby pandas.DataFrame.groupby pandas.Panel.groupby |
GroupBy.var ([ddof]) |
Compute variance of groups, excluding missing values. |
GroupBy.tail ([n]) |
Returns last n rows of each group. |
The following methods are available in both SeriesGroupBy
and
DataFrameGroupBy
objects, but may differ slightly, usually in that
the DataFrameGroupBy
version usually permits the specification of an
axis argument, and often an argument indicating whether to restrict
application to columns of a specific data type.
DataFrameGroupBy.all ([skipna]) |
Returns True if all values in the group are truthful, else False. |
DataFrameGroupBy.any ([skipna]) |
Returns True if any value in the group is truthful, else False. |
DataFrameGroupBy.bfill ([limit]) |
Backward fill the values. |
DataFrameGroupBy.corr |
Compute pairwise correlation of columns, excluding NA/null values. |
DataFrameGroupBy.count () |
Compute count of group, excluding missing values |
DataFrameGroupBy.cov |
Compute pairwise covariance of columns, excluding NA/null values. |
DataFrameGroupBy.cummax ([axis]) |
Cumulative max for each group. |
DataFrameGroupBy.cummin ([axis]) |
Cumulative min for each group. |
DataFrameGroupBy.cumprod ([axis]) |
Cumulative product for each group. |
DataFrameGroupBy.cumsum ([axis]) |
Cumulative sum for each group. |
DataFrameGroupBy.describe (**kwargs) |
Generate descriptive statistics that summarize the central tendency, dispersion and shape of a dataset’s distribution, excluding NaN values. |
DataFrameGroupBy.diff |
First discrete difference of element. |
DataFrameGroupBy.ffill ([limit]) |
Forward fill the values. |
DataFrameGroupBy.fillna |
Fill NA/NaN values using the specified method. |
DataFrameGroupBy.filter (func[, dropna]) |
Return a copy of a DataFrame excluding elements from groups that do not satisfy the boolean criterion specified by func. |
DataFrameGroupBy.hist |
Make a histogram of the DataFrame’s. |
DataFrameGroupBy.idxmax |
Return index of first occurrence of maximum over requested axis. |
DataFrameGroupBy.idxmin |
Return index of first occurrence of minimum over requested axis. |
DataFrameGroupBy.mad |
Return the mean absolute deviation of the values for the requested axis. |
DataFrameGroupBy.pct_change ([periods, …]) |
Calculate pct_change of each value to previous entry in group. |
DataFrameGroupBy.plot |
Class implementing the .plot attribute for groupby objects. |
DataFrameGroupBy.quantile |
Return values at the given quantile over requested axis. |
DataFrameGroupBy.rank ([method, ascending, …]) |
Provides the rank of values within each group. |
DataFrameGroupBy.resample (rule, *args, **kwargs) |
Provide resampling when using a TimeGrouper. |
DataFrameGroupBy.shift ([periods, freq, …]) |
Shift each group by periods observations. |
DataFrameGroupBy.size () |
Compute group sizes. |
DataFrameGroupBy.skew |
Return unbiased skew over requested axis Normalized by N-1. |
DataFrameGroupBy.take |
Return the elements in the given positional indices along an axis. |
DataFrameGroupBy.tshift |
Shift the time index, using the index’s frequency if available. |
The following methods are available only for SeriesGroupBy
objects.
SeriesGroupBy.nlargest |
Return the largest n elements. |
SeriesGroupBy.nsmallest |
Return the smallest n elements. |
SeriesGroupBy.nunique ([dropna]) |
Returns number of unique elements in the group |
SeriesGroupBy.unique |
Return unique values of Series object. |
SeriesGroupBy.value_counts ([normalize, …]) |
|
SeriesGroupBy.is_monotonic_increasing |
Return boolean if values in the object are monotonic_increasing. |
SeriesGroupBy.is_monotonic_decreasing |
Return boolean if values in the object are monotonic_decreasing. |
The following methods are available only for DataFrameGroupBy
objects.
DataFrameGroupBy.corrwith |
Compute pairwise correlation between rows or columns of DataFrame with rows or columns of Series or DataFrame. |
DataFrameGroupBy.boxplot ([subplots, column, …]) |
Make box plots from DataFrameGroupBy data. |