pandas.Categorical.from_codes#
- classmethod Categorical.from_codes(codes, categories=None, ordered=None, dtype=None, validate=True)[源代码][源代码]#
从代码和类别或数据类型创建一个分类类型。
如果你已经有代码和类别/数据类型,并且不需要(计算密集型的)因子化步骤,这个构造函数会很有用,通常这个步骤是在构造函数中完成的。
如果你的数据不遵循这个约定,请使用正常的构造函数。
- 参数:
- 代码类似数组的整数
一个整数数组,其中每个整数指向 categories 或 dtype.categories 中的一个类别,否则为 NaN 则为 -1。
- 类别索引类,可选
分类的类别。项目需要是唯一的。如果在这里没有给出类别,那么它们必须在 dtype 中提供。
- 有序bool, 可选
这个分类是否被视为有序分类。如果在这里或 dtype 中没有给出,结果的分类将是无序的。
- dtypeCategoricalDtype 或 “category”,可选
如果
CategoricalDtype
,不能与 categories 或 ordered 一起使用。- 验证bool, 默认为 True
如果为 True,验证代码对于 dtype 是否有效。如果为 False,则不验证代码是否有效。跳过验证时要小心,因为无效的代码可能会导致严重问题,例如段错误。
Added in version 2.1.0.
- 返回:
- Categorical
参见
代码
类别代码的分类。
CategoricalIndex
一个基于
Categorical
的索引。
例子
>>> dtype = pd.CategoricalDtype(["a", "b"], ordered=True) >>> pd.Categorical.from_codes(codes=[0, 1, 0, 1], dtype=dtype) ['a', 'b', 'a', 'b'] Categories (2, object): ['a' < 'b']