pandas.MultiIndex.swaplevel

MultiIndex.swaplevel(self, i=-2, j=-1)[source]

Swap level i with level j.

Calling this method does not change the ordering of the values.

Parameters
iint, str, default -2

First level of index to be swapped. Can pass level name as string. Type of parameters can be mixed.

jint, str, default -1

Second level of index to be swapped. Can pass level name as string. Type of parameters can be mixed.

Returns
MultiIndex

A new MultiIndex.

Changed in version 0.18.1: The indexes i and j are now optional, and default to the two innermost levels of the index.

See also

Series.swaplevel

Swap levels i and j in a MultiIndex.

Dataframe.swaplevel

Swap levels i and j in a MultiIndex on a particular axis.

Examples

>>> mi = pd.MultiIndex(levels=[['a', 'b'], ['bb', 'aa']],
...                    codes=[[0, 0, 1, 1], [0, 1, 0, 1]])
>>> mi
MultiIndex(levels=[['a', 'b'], ['bb', 'aa']],
           codes=[[0, 0, 1, 1], [0, 1, 0, 1]])
>>> mi.swaplevel(0, 1)
MultiIndex(levels=[['bb', 'aa'], ['a', 'b']],
           codes=[[0, 1, 0, 1], [0, 0, 1, 1]])
Scroll To Top