pandas.Series.cat.set_categories#

Series.cat.set_categories(*args, **kwargs)[源代码]#

将类别设置为指定的NEW_CACTIONS。

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

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

另一方面,该方法不进行检查(例如,旧类别是否被包括在重新排序的新类别中),这可能导致令人惊讶的变化,例如当使用特殊的字符串DTYPE时,其不认为S1字符串等于单个字符PYTHON字符串。

参数
new_categories类索引

按新顺序排列的类别。

ordered布尔值,默认为False

定语是否被视为有序的定语。如果没有提供,请不要更改已排序的信息。

rename布尔值,默认为False

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

inplace布尔值,默认为False

是就地重新排序类别,还是返回具有重新排序的类别的此类别的副本。

1.3.0 版后已移除.

退货
具有重新排序的类别的类别,如果在原地,则不使用类别。
加薪
ValueError

如果NEW_CATEGORIES未验证为类别

参见

rename_categories

重命名类别。

reorder_categories

重新排序类别。

add_categories

添加新类别。

remove_categories

删除指定的类别。

remove_unused_categories

删除不使用的类别。