pandas.Index.set_names

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

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

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

Параметры:

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

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

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

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

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

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

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

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

Возвращает:

Индекс или None

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

См. также

Index.rename

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

Примеры

>>> idx = pd.Index([1, 2, 3, 4])
>>> idx
Index([1, 2, 3, 4], dtype='int64')
>>> idx.set_names('quarter')
Index([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 = idx.set_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'])