pandas.Index.rename#

Индекс.переименовать(имя, *, inplace=False)[источник]#

Изменить имя Index или MultiIndex.

Возможность установки новых имен без уровня. По умолчанию возвращает новый индекс. Длина имен должна соответствовать количеству уровней в MultiIndex.

Параметры:

имяметка или список меток: Имя(имена) для установки.
inplacebool, по умолчанию False: Изменяет объект напрямую, вместо создания нового Index или MultiIndex.

Возвращает:

Index или None: Тот же тип, что у вызывающего объекта, или None, если inplace=True.

Смотрите также

Index.set_names: Возможность частично устанавливать новые имена и по уровням.

Примеры

>>> idx = pd.Index(['A', 'C', 'A', 'B'], name='score')
>>> idx.rename('grade')
Index(['A', 'C', 'A', 'B'], dtype='object', name='grade')

>>> idx = pd.MultiIndex.from_product([['python', 'cobra'],
...                                   [2018, 2019]],
...                                   names=['kind', 'year'])
>>> idx
MultiIndex([('python', 2018),
            ('python', 2019),
            ( 'cobra', 2018),
            ( 'cobra', 2019)],
           names=['kind', 'year'])
>>> idx.rename(['species', 'year'])
MultiIndex([('python', 2018),
            ('python', 2019),
            ( 'cobra', 2018),
            ( 'cobra', 2019)],
           names=['species', 'year'])
>>> idx.rename('species')
Traceback (most recent call last):
TypeError: Must pass list-like as `names`.