pandas.Index.set_names

Index.set_names(names, level=None, inplace=False)[source]

Установить имя индекса или MultiIndex.

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

Параметры

names:метка или список меток или dict-подобный объект для MultiIndex

Имя(на) для установки.

Изменено в версии 1.3.0.

level:int, метка или список int или меток, необязательно

Если индекс является MultiIndex и names не является dict-подобным объектом, уровень(и) для установки (None для всех уровней). В противном случае уровень должен быть None.

Изменено в версии 1.3.0.

inplace:bool, по умолчанию False

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

Возвращает

Index или None

Тип, совпадающий с вызывающим объектом, или None, если inplace=True.

См. также

Index.rename

Возможно задать новые имена без указания уровня.

Примеры

>>> idx = pd.Index([1, 2, 3, 4])
>>> idx
Int64Index([1, 2, 3, 4], dtype='int64')
>>> idx.set_names('quarter')
Int64Index([1, 2, 3, 4], dtype='int64', name='quarter')

>>> idx = pd.MultiIndex.from_product([['python', 'cobra'],
...                                   [2018, 2019]])
>>> idx
MultiIndex([('python', 2018),
            ('python', 2019),
            ( 'cobra', 2018),
            ( 'cobra', 2019)],
           )
>>> idx.set_names(['kind', 'year'], inplace=True)
>>> idx
MultiIndex([('python', 2018),
            ('python', 2019),
            ( 'cobra', 2018),
            ( 'cobra', 2019)],
           names=['kind', 'year'])
>>> idx.set_names('species', level=0)
MultiIndex([('python', 2018),
            ('python', 2019),
            ( 'cobra', 2018),
            ( 'cobra', 2019)],
           names=['species', 'year'])

При переименовании уровней с помощью словаря, уровни не могут быть переданы.

>>> idx.set_names({'kind': 'snake'})
MultiIndex([('python', 2018),
            ('python', 2019),
            ( 'cobra', 2018),
            ( 'cobra', 2019)],
           names=['snake', 'year'])