dask.dataframe.Series.cat.add_categories
dask.dataframe.Series.cat.add_categories¶
- dataframe.Series.cat.add_categories(*args, **kwargs)¶
添加新类别。
此文档字符串是从 pandas.core.arrays.categorical.CategoricalAccessor.add_categories 复制的。
Dask 版本可能存在一些不一致性。
new_categories 将被包含在类别中的最后/最高位置，并且在此次调用后将不会被直接使用。
- 参数
- 新分类类别或类别的列表
要包含的新类别。
- 返回
- 分类
添加了新类别的分类数据。
- Raises
- ValueError
如果新类别包含旧类别或未验证为类别
参见
rename_categories重命名类别。
reorder_categories重新排序类别。
remove_categories移除指定的类别。
remove_unused_categories移除未使用的类别。
set_categories将类别设置为指定的类别。
示例
>>> c = pd.Categorical(['c', 'b', 'c']) >>> c ['c', 'b', 'c'] Categories (2, object): ['b', 'c']
>>> c.add_categories(['d', 'a']) ['c', 'b', 'c'] Categories (4, object): ['b', 'c', 'd', 'a']