Group this table by the specified keys

This effectively splits the table into groups which correspond to unique values of the keys grouping object. The output is a new ~astropy.table.TableGroups which contains a copy of this table but sorted by row according to keys.

The keys input to group_by can be specified in different ways:

• String or list of strings corresponding to table column name(s)

• Numpy array (homogeneous or structured) with same length as this table

• ~astropy.table.Table with same length as this table

Parameters¶

keysstr, list of str, numpy array, or ~astropy.table.Table

Key grouping object

Returns¶

out~astropy.table.Table

New table with groups set