pandas.Series.cat.set_categories #

系列.cat。set_categories ( * args , ** kwargs ) [来源] #

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

new_categories可以包含新类别(这将导致未使用的类别)或删除旧类别(这将导致值设置为NaN)。如果rename=True,类别将被简单地重命名(比旧类别中更少或更多的项目将导致值 NaN分别设置为或未使用的类别)。

该方法可用于同时执行多个添加、删除和重新排序操作,因此比通过更专业的方法执行各个步骤更快。

另一方面,此方法不执行检查(例如,重新排序时旧类别是否包含在新类别中),这可能会导致令人惊讶的变化,例如在使用特殊字符串数据类型时,它不考虑 S1 字符串等于单个 char python 字符串。

参数
new_categories类索引

类别按新顺序排列。

有序布尔值,默认 False

是否将分类视为有序分类。如果未给出,请勿更改订购信息。

重命名bool,默认 False

new_categories 是否应被视为旧类别的重命名或重新排序的类别。

返回
类别重新排序的分类。
加薪
值错误

如果 new_categories 未验证为类别

也可以看看

rename_categories

重命名类别。

reorder_categories

重新排序类别。

add_categories

添加新类别。

remove_categories

删除指定的类别。

remove_unused_categories

删除不使用的类别。

例子

为了pandas.Series

>>> raw_cat = pd.Categorical(['a', 'b', 'c', 'A'],
...                           categories=['a', 'b', 'c'], ordered=True)
>>> ser = pd.Series(raw_cat)
>>> ser
0   a
1   b
2   c
3   NaN
dtype: category
Categories (3, object): ['a' < 'b' < 'c']
>>> ser.cat.set_categories(['A', 'B', 'C'], rename=True)
0   A
1   B
2   C
3   NaN
dtype: category
Categories (3, object): ['A' < 'B' < 'C']

为了pandas.CategoricalIndex

>>> ci = pd.CategoricalIndex(['a', 'b', 'c', 'A'],
...                          categories=['a', 'b', 'c'], ordered=True)
>>> ci
CategoricalIndex(['a', 'b', 'c', nan], categories=['a', 'b', 'c'],
                 ordered=True, dtype='category')
>>> ci.set_categories(['A', 'b', 'c'])
CategoricalIndex([nan, 'b', 'c', nan], categories=['A', 'b', 'c'],
                 ordered=True, dtype='category')
>>> ci.set_categories(['A', 'b', 'c'], rename=True)
CategoricalIndex(['A', 'b', 'c', nan], categories=['A', 'b', 'c'],
                 ordered=True, dtype='category')