teradataml.dataframe.dataframe.DataFrame.rollup = rollup(self, columns, include_grouping_columns=False)

DESCRIPTION:
    rollup() function creates a multi-dimensional rollup for the DataFrame
    using the specified column(s), and there by running aggregates on
    it to produce the aggregations on different dimensions.
    Note:
        * This method does not support DataFrame containing array columns.
 
PARAMETERS:
    columns:
        Required Argument.
        Specifies the name(s) of input teradataml DataFrame column(s).
        Types: str OR list of str(s)
 
    include_grouping_columns:
        Optional Argument.
        Specifies whether to include aggregations on the grouping column(s) or not.
        When set to True, the resultant DataFrame will have the aggregations on the
        columns mentioned in "columns". Otherwise, resultant DataFrame will not have
        aggregations on the columns mentioned in "columns".
        Default Value: False
        Types: bool
 
RETURNS:
    teradataml DataFrameGroupBy
 
RAISES:
    TeradataMlException
 
EXAMPLES :
    # Load the data to run the example.
    >>> load_example_data("dataframe","admissions_train")
 
    # Create a DataFrame on 'admissions_train' table.
    >>> df = DataFrame("admissions_train")
    >>> df
       masters   gpa     stats programming  admitted
    id
    15     yes  4.00  Advanced    Advanced         1
    34     yes  3.85  Advanced    Beginner         0
    13      no  4.00  Advanced      Novice         1
    38     yes  2.65  Advanced    Beginner         1
    5       no  3.44    Novice      Novice         0
    40     yes  3.95    Novice    Beginner         0
    7      yes  2.33    Novice      Novice         1
    22     yes  3.46    Novice    Beginner         0
    26     yes  3.57  Advanced    Advanced         1
    17      no  3.83  Advanced    Advanced         1
 
    # Example 1: Find the sum of all valid columns by grouping the
    #            DataFrame columns with 'masters' and 'stats'.
    >>> df1 = df.rollup(["masters", "stats"]).sum()
    >>> df1
      masters     stats  sum_id  sum_gpa  sum_admitted
    0      no      None     343    63.96            16
    1     yes      None     477    77.71            10
    2    None      None     820   141.67            26
    3      no    Novice     146    25.41             6
    4      no  Beginner       8     3.60             1
    5     yes    Novice      98    13.74             1
    6     yes  Beginner      13    14.71             2
    7     yes  Advanced     366    49.26             7
    8      no  Advanced     189    34.95             9
 
    # Example 2: Find the avg of all valid columns by grouping the DataFrame
    #            with columns 'masters' and 'admitted'. Include grouping columns
    #            in aggregate function 'avg'.
    >>> df1 = df.rollup(["masters", "admitted"], include_grouping_columns=True).avg()
    >>> df1
      masters  admitted     avg_id   avg_gpa  avg_admitted
    0      no       NaN  19.055556  3.553333      0.888889
    1     yes       NaN  21.681818  3.532273      0.454545
    2    None       NaN  20.500000  3.541750      0.650000
    3     yes       0.0  24.083333  3.613333      0.000000
    4      no       1.0  18.875000  3.595000      1.000000
    5     yes       1.0  18.800000  3.435000      1.000000
    6      no       0.0  20.500000  3.220000      0.000000
 
    # Example 3: Find the avg of all valid columns by grouping the DataFrame with
    #            columns 'masters' and 'admitted'. Do not include grouping columns
    #            in aggregate function 'avg'.
    >>> df1 = df.rollup(["masters", "admitted"], include_grouping_columns=False).avg()
    >>> df1
      masters  admitted     avg_id   avg_gpa
    0      no       NaN  19.055556  3.553333
    1     yes       NaN  21.681818  3.532273
    2      no       0.0  20.500000  3.220000
    3     yes       0.0  24.083333  3.613333
    4      no       1.0  18.875000  3.595000
    5     yes       1.0  18.800000  3.435000
    6    None       NaN  20.500000  3.541750