pandas.MultiIndex.set_levels

MultiIndex.set_levels(levels, level=None, inplace=None, verify_integrity=True)[source]

Устанавливает новые уровни в MultiIndex. По умолчанию возвращает новый индекс.

Параметры

levels:последовательность или список последовательностей

Новые уровни для применения.

level:целое число, имя уровня или последовательность целых чисел/имен уровней (по умолчанию None)

Уровень(и) для установки (None для всех уровней).

inplace:bool

Если True, изменяет на месте.

Устарело начиная с версии 1.2.0.

verify_integrity:bool, по умолчанию True

Если True, проверяет, что уровни и коды совместимы.

Возвращает

новый индекс (того же типа и класса…и т.д.) или None

Тип, аналогичный вызывающему элементу, или None, если inplace=True.

Примеры

>>> idx = pd.MultiIndex.from_tuples(
...     [
...         (1, "one"),
...         (1, "two"),
...         (2, "one"),
...         (2, "two"),
...         (3, "one"),
...         (3, "two")
...     ],
...     names=["foo", "bar"]
... )
>>> idx
MultiIndex([(1, 'one'),
    (1, 'two'),
    (2, 'one'),
    (2, 'two'),
    (3, 'one'),
    (3, 'two')],
   names=['foo', 'bar'])

>>> idx.set_levels([['a', 'b', 'c'], [1, 2]])
MultiIndex([('a', 1),
            ('a', 2),
            ('b', 1),
            ('b', 2),
            ('c', 1),
            ('c', 2)],
           names=['foo', 'bar'])
>>> idx.set_levels(['a', 'b', 'c'], level=0)
MultiIndex([('a', 'one'),
            ('a', 'two'),
            ('b', 'one'),
            ('b', 'two'),
            ('c', 'one'),
            ('c', 'two')],
           names=['foo', 'bar'])
>>> idx.set_levels(['a', 'b'], level='bar')
MultiIndex([(1, 'a'),
            (1, 'b'),
            (2, 'a'),
            (2, 'b'),
            (3, 'a'),
            (3, 'b')],
           names=['foo', 'bar'])

Если любой из уровней, переданных в set_levels(), превышает существующую длину, все значения из этого аргумента будут сохранены в уровнях MultiIndex, хотя значения будут усечены в выходных данных MultiIndex.

>>> idx.set_levels([['a', 'b', 'c'], [1, 2, 3, 4]], level=[0, 1])
MultiIndex([('a', 1),
    ('a', 2),
    ('b', 1),
    ('b', 2),
    ('c', 1),
    ('c', 2)],
   names=['foo', 'bar'])
>>> idx.set_levels([['a', 'b', 'c'], [1, 2, 3, 4]], level=[0, 1]).levels
FrozenList([['a', 'b', 'c'], [1, 2, 3, 4]])