pandas.Index.set_names #

指数。set_names (名称, * , level = None , inplace = False ) [来源] #

设置索引或多索引名称。

可以部分、按级别设置新名称。

参数：

名称标签或标签列表或类似字典的 MultiIndex: 要设置的名称。

在 1.3.0 版本中进行了更改。
level int，标签或int或标签列表，可选: 如果索引是 MultiIndex 并且名称不是类似字典的，则需要设置级别（所有级别均无）。否则级别必须为 None。

在 1.3.0 版本中进行了更改。
inplace布尔值，默认 False: 直接修改对象，而不是创建新的 Index 或 MultiIndex。

返回：

索引或无: 与调用者的类型相同或 None if 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'])