Python pyspark CategoricalIndex.add_categories用法及代码示例

本文简要介绍 pyspark.pandas.CategoricalIndex.add_categories 的用法。

用法: CategoricalIndex.add_categories(new_categories: Union[pandas.core.indexes.base.Index, Any, List], inplace: bool = False) → Optional[pyspark.pandas.indexes.category.CategoricalIndex]

添加新类别。

new_categories 将包含在类别中的最后/最高位置，并且在此调用后将直接不使用。

参数：

new_categories：类别或类似列表的类别: 要包含的新类别。
inplace：布尔值，默认为 False: 是否就地添加类别或返回此类别的副本以及添加的类别。

自版本 3.2.0 起已弃用。

CategoricalIndex 或无: 添加了新类别的分类，如果 inplace=True 则为无。

抛出：

ValueError: 如果新类别包括旧类别或不作为类别验证

例子：

>>> idx = ps.CategoricalIndex(list("abbccc"))
>>> idx  
CategoricalIndex(['a', 'b', 'b', 'c', 'c', 'c'],
                 categories=['a', 'b', 'c'], ordered=False, dtype='category')

>>> idx.add_categories('x')  
CategoricalIndex(['a', 'b', 'b', 'c', 'c', 'c'],
                 categories=['a', 'b', 'c', 'x'], ordered=False, dtype='category')

相关用法

注：本文由纯净天空筛选整理自spark.apache.org大神的英文原创作品 pyspark.pandas.CategoricalIndex.add_categories。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。

用法:

参数：

返回：

抛出：

例子：