pandas.CategoricalIndex.rename_categories #

分类索引。rename_categories ( * args , ** kwargs ) [来源] #

重命名类别。

参数
new_categories类似列表、类似字典或可调用

新类别将取代旧类别。

  • 类似列表:所有项目必须是唯一的,并且新类别中的项目数量必须与现有类别数量相匹配。

  • dict-like:指定从旧类别到新类别的映射。映射中未包含的类别将被传递,并且映射中的额外类别将被忽略。

  • callable :对旧类别中的所有项目调用的可调用对象,其返回值包含新类别。

返回
分类的

具有重命名类别的分类。

加薪
值错误

如果新类别类似于列表,并且项目数量与当前类别不同,或者未验证为类别

也可以看看

reorder_categories

重新排序类别。

add_categories

添加新类别。

remove_categories

删除指定的类别。

remove_unused_categories

删除不使用的类别。

set_categories

将类别设置为指定的类别。

例子

>>> c = pd.Categorical(['a', 'a', 'b'])
>>> c.rename_categories([0, 1])
[0, 0, 1]
Categories (2, int64): [0, 1]

对于 dict-like new_categories,忽略额外的键,并传递不在字典中的类别

>>> c.rename_categories({'a': 'A', 'c': 'C'})
['A', 'A', 'b']
Categories (2, object): ['A', 'b']

您还可以提供可调用来创建新类别

>>> c.rename_categories(lambda x: x.upper())
['A', 'A', 'B']
Categories (2, object): ['A', 'B']