max_by

max_by returns the maximum value for each group. Null values are ignored.

Syntax

Parameters

ParameterTypeDescription
by optionalUnion[str, list[str]]

The column(s) by which to group data.

  • [] returns the maximum value for each column in the table (default).
  • ["X"] will output the maximum value of each group in column X.
  • ["X", "Y"] will output the maximum value of each group designated from the X and Y columns.

Returns

A new table containing the maximum value for each group.

Examples

In this example, max_by returns the maximum value for each column.

In this example, max_by returns the maximum value, as grouped by X.

In this example, max_by returns the maximum value, as grouped by X and Y.