目录
一、用法精讲
936、pandas.CategoricalIndex.rename_categories方法
936-1、语法
936-2、参数
936-3、功能
936-4、返回值
936-5、说明
936-6、用法
936-6-1、数据准备
936-6-2、代码示例
936-6-3、结果输出
937、pandas.CategoricalIndex.reorder_categories方法
937-1、语法
937-2、参数
937-3、功能
937-4、返回值
937-5、说明
937-6、用法
937-6-1、数据准备
937-6-2、代码示例
937-6-3、结果输出
938、pandas.CategoricalIndex.add_categories方法
938-1、语法
938-2、参数
938-3、功能
938-4、返回值
938-5、说明
938-6、用法
938-6-1、数据准备
938-6-2、代码示例
938-6-3、结果输出
939、pandas.CategoricalIndex.remove_categories方法
939-1、语法
939-2、参数
939-3、功能
939-4、返回值
939-5、说明
939-6、用法
939-6-1、数据准备
939-6-2、代码示例
939-6-3、结果输出
940、pandas.CategoricalIndex.remove_unused_categories方法
940-1、语法
940-2、参数
940-3、功能
940-4、返回值
940-5、说明
940-6、用法
940-6-1、数据准备
940-6-2、代码示例
940-6-3、结果输出
二、推荐阅读
1、Python筑基之旅
2、Python函数之旅
3、Python算法之旅
4、Python魔法之旅
5、博客个人主页
一、用法精讲
936、pandas.CategoricalIndex.rename_categories方法
936-1、语法
# 936、pandas.CategoricalIndex.rename_categories方法
pandas.CategoricalIndex.rename_categories(*args, **kwargs)
Rename categories.Parameters:
new_categories
list-like, dict-like or callable
New categories which will replace old categories.list-like: all items must be unique and the number of items in the new categories must match the existing number of categories.dict-like: specifies a mapping from old categories to new. Categories not contained in the mapping are passed through and extra categories in the mapping are ignored.callable : a callable that is called on all items in the old categories and whose return values comprise the new categories.Returns:
Categorical
Categorical with renamed categories.Raises:
ValueError
If new categories are list-like and do not have the same number of items than the current categories or do not validate as categories936-2、参数
936-2-1、*args(可选)：其他位置参数，为后续扩展功能做预留。
936-2-2、**kwargs(可选)：其他关键字参数，为后续扩展功能做预留。
936-3、功能
用于修改CategoricalIndex中的类别名称，可以在数据清理或重命名类别时非常有用，尤其是在数据分析中需要使类别名称更具可读性或更符合特定标准时。
936-4、返回值
如果inplace=False(默认值)，该方法返回一个新的CategoricalIndex对象，其类别名称已被更新；如果inplace=True，则会在原有的CategoricalIndex对象上进行修改，并返回None。
936-5、说明
无
936-6、用法
936-6-1、数据准备
无936-6-2、代码示例
# 936、pandas.CategoricalIndex.rename_categories方法
import pandas as pd
# 创建一个CategoricalIndex
cat_index = pd.CategoricalIndex(['a', 'b', 'a', 'c'], categories=['a', 'b', 'c'])
# 使用rename_categories
new_cat_index = cat_index.rename_categories(['alpha', 'beta', 'gamma'])
print(new_cat_index)
print(cat_index)936-6-3、结果输出
# 936、pandas.CategoricalIndex.rename_categories方法
# CategoricalIndex(['alpha', 'beta', 'alpha', 'gamma'], categories=['alpha', 'beta', 'gamma'], ordered=False, dtype='category')
# CategoricalIndex(['a', 'b', 'a', 'c'], categories=['a', 'b', 'c'], ordered=False, dtype='category')937、pandas.CategoricalIndex.reorder_categories方法
937-1、语法
# 937、pandas.CategoricalIndex.reorder_categories方法
pandas.CategoricalIndex.reorder_categories(*args, **kwargs)
Reorder categories as specified in new_categories.new_categories need to include all old categories and no new category items.Parameters:
new_categories
Index-like
The categories in new order.ordered
bool, optional
Whether or not the categorical is treated as a ordered categorical. If not given, do not change the ordered information.Returns:
Categorical
Categorical with reordered categories.Raises:
ValueError
If the new categories do not contain all old category items or any new ones937-2、参数
937-2-1、*args(可选)：其他位置参数，为后续扩展功能做预留。
937-2-2、**kwargs(可选)：其他关键字参数，为后续扩展功能做预留。
937-3、功能
用于重新排列CategoricalIndex中的类别，以满足特定的排序要求，在数据分析中可能很有用，例如在创建分组时希望按特定顺序显示分类。
937-4、返回值
如果inplace=False(默认值)，则返回一个新的CategoricalIndex对象，类别按指定的顺序重新排列；如果inplace=True，则在原有的CategoricalIndex对象上进行修改，并返回None。
937-5、说明
无
937-6、用法
937-6-1、数据准备
无937-6-2、代码示例
# 937、pandas.CategoricalIndex.reorder_categories方法
import pandas as pd
# 创建一个CategoricalIndex
cat_index = pd.CategoricalIndex(['apple', 'banana', 'apple', 'cherry'], categories=['apple', 'banana', 'cherry'])
# 重新排列类别顺序
new_cat_index = cat_index.reorder_categories(['cherry', 'banana', 'apple'])
print(new_cat_index)937-6-3、结果输出
# 937、pandas.CategoricalIndex.reorder_categories方法
# CategoricalIndex(['apple', 'banana', 'apple', 'cherry'], categories=['cherry', 'banana', 'apple'], ordered=False, dtype='category')938、pandas.CategoricalIndex.add_categories方法
938-1、语法
# 938、pandas.CategoricalIndex.add_categories方法
pandas.CategoricalIndex.add_categories(*args, **kwargs)
Add new categories.new_categories will be included at the last/highest place in the categories and will be unused directly after this call.Parameters:
new_categories
category or list-like of category
The new categories to be included.Returns:
Categorical
Categorical with new categories added.Raises:
ValueError
If the new categories include old categories or do not validate as categories938-2、参数
938-2-1、*args(可选)：其他位置参数，为后续扩展功能做预留。
938-2-2、**kwargs(可选)：其他关键字参数，为后续扩展功能做预留。
938-3、功能
扩展现有的CategoricalIndex，允许添加额外的类别，以便在数据中包含更多的信息。例如，当您有一个包含类别的索引，并希望包括一些新类别时，可以使用此方法。
938-4、返回值
返回值是一个新的CategoricalIndex，其中包含了原有的类别和新添加的类别(如果inplace=False)，原有的索引在这种情况下保持不变；如果inplace=True，返回值将为None，原始索引将被修改以包含新的类别。
938-5、说明
无
938-6、用法
938-6-1、数据准备
无938-6-2、代码示例
# 938、pandas.CategoricalIndex.add_categories方法
import pandas as pd
# 创建一个CategoricalIndex
cat_index = pd.CategoricalIndex(['apple', 'banana', 'cherry'], categories=['apple', 'banana', 'cherry'])
# 添加新类别
new_index = cat_index.add_categories(['date', 'elderberry'])
print(new_index)
# 原索引保持不变
print(cat_index)938-6-3、结果输出
# 938、pandas.CategoricalIndex.add_categories方法
# CategoricalIndex(['apple', 'banana', 'cherry'], categories=['apple', 'banana', 'cherry', 'date', 'elderberry'], ordered=False, dtype='category')
# CategoricalIndex(['apple', 'banana', 'cherry'], categories=['apple', 'banana', 'cherry'], ordered=False, dtype='category')939、pandas.CategoricalIndex.remove_categories方法
939-1、语法
# 939、pandas.CategoricalIndex.remove_categories方法
pandas.CategoricalIndex.remove_categories(*args, **kwargs)
Remove the specified categories.removals must be included in the old categories. Values which were in the removed categories will be set to NaNParameters:
removals
category or list of categories
The categories which should be removed.Returns:
Categorical
Categorical with removed categories.Raises:
ValueError
If the removals are not contained in the categories939-2、参数
939-2-1、*args(可选)：其他位置参数，为后续扩展功能做预留。
939-2-2、**kwargs(可选)：其他关键字参数，为后续扩展功能做预留。
939-3、功能
从CategoricalIndex中移除指定的类别，被移除的类别不再出现在索引中。
939-4、返回值
返回一个新的CategoricalIndex对象，其中指定的类别已经被移除，原始的CategoricalIndex对象保持不变，新返回的对象会反映移除操作。
939-5、说明
无
939-6、用法
939-6-1、数据准备
无939-6-2、代码示例
# 939、pandas.CategoricalIndex.remove_categories方法
import pandas as pd
# 创建一个CategoricalIndex
cat_index = pd.CategoricalIndex(['apple', 'banana', 'orange', 'apple', 'banana'], categories=['apple', 'banana', 'orange'])# 移除'banana'类别
new_cat_index = cat_index.remove_categories('banana')
# 原始和新创建的CategoricalIndex
print(cat_index)
print(new_cat_index) 939-6-3、结果输出
# 939、pandas.CategoricalIndex.remove_categories方法
# CategoricalIndex(['apple', 'banana', 'orange', 'apple', 'banana'], categories=['apple', 'banana', 'orange'], ordered=False, dtype='category')
# CategoricalIndex(['apple', nan, 'orange', 'apple', nan], categories=['apple', 'orange'], ordered=False, dtype='category')940、pandas.CategoricalIndex.remove_unused_categories方法
940-1、语法
# 940、pandas.CategoricalIndex.remove_unused_categories方法
pandas.CategoricalIndex.remove_unused_categories(*args, **kwargs)
Remove categories which are not used.Returns:
Categorical
Categorical with unused categories dropped.940-2、参数
940-2-1、*args(可选)：其他位置参数，为后续扩展功能做预留。
940-2-2、**kwargs(可选)：其他关键字参数，为后续扩展功能做预留。
940-3、功能
移除分类索引中未使用的类别。
940-4、返回值
新的分类索引对象，不包含未使用的类别。
940-5、说明
无
940-6、用法
940-6-1、数据准备
无940-6-2、代码示例
# 940、pandas.CategoricalIndex.remove_unused_categories方法
import pandas as pd
# 创建一个分类索引
cat_index = pd.CategoricalIndex(['A', 'B', 'C', 'A', 'B'], categories=['A', 'B', 'C', 'D'])
# 移除未使用的类别
new_index = cat_index.remove_unused_categories()
print(new_index) 940-6-3、结果输出
# 940、pandas.CategoricalIndex.remove_unused_categories方法
# CategoricalIndex(['A', 'B', 'C', 'A', 'B'], categories=['A', 'B', 'C'], ordered=False, dtype='category')