pandas MultiIndex.get_level_values() 获取指定层次

pandas.MultiIndex.get_level_values() 方法用于获取 MultiIndex 中指定层次的所有值。该方法可以通过层次的索引号或名称来获取该层次的值，并返回一个包含该层次值的 Index 对象。

语法

签名

MultiIndex.get_level_values(level)

参数说明

• level：
  必选参数。指定要获取的层次，可以是层次的名称或层次的索引号。

  • 类型：int 或 str
  • 含义：指定要获取的层次。可以通过整数表示层次的位置（从 0 开始计数），也可以使用层次的名称（如果有的话）来指定该层次。

返回值

• 返回值：
  返回一个 Index 对象，其中包含 MultiIndex 指定层次的所有值。

使用场景

• 当你需要对 MultiIndex 中的某一层次进行分析、操作或提取时，get_level_values() 方法非常有用。它可以帮助你获取某一层次的值，方便进行数据筛选、分组或其他分析。
• 特别是在数据集中有多层次索引时，通过此方法可以灵活地获取各个层次的内容进行进一步处理。

示例

示例 1：通过层次名称获取值

import pandas as pd

# 创建一个三层的 MultiIndex
multi_index = pd.MultiIndex.from_tuples(
    [('a', 1, 'x'), ('a', 2, 'y'), ('b', 1, 'z'), ('b', 2, 'w')], 
    names=['letter', 'number', 'code']
)

# 从 MultiIndex 中获取 'letter' 层次的值
letter_values = multi_index.get_level_values('letter')

# 输出结果
f"Values in 'letter' level:\n{letter_values}\n"

输出：

Values in 'letter' level:
Index(['a', 'a', 'b', 'b'], dtype='object', name='letter')

在此示例中，通过指定 level='letter'，我们获取了 MultiIndex 中第一层（letter）的所有值。

示例 2：通过层次索引号获取值

# 获取第二层 (number) 的值，索引号为 1
number_values = multi_index.get_level_values(1)

# 输出结果
f"Values in 'number' level:\n{number_values}\n"

输出：

Values in 'number' level:
Int64Index([1, 2, 1, 2], dtype='int64', name='number')

在这个例子中，使用层次的索引号 1 获取了第二层（number）的所有值。

示例 3：对提取出的层次值进行分析

获取某一层次的值后，可以对其进行进一步操作或分析，例如统计、筛选等。

# 获取 'code' 层次的唯一值
unique_codes = multi_index.get_level_values('code').unique()

# 输出结果
f"Unique values in 'code' level:\n{unique_codes}\n"

输出：

Unique values in 'code' level:
Index(['x', 'y', 'z', 'w'], dtype='object', name='code')

通过 get_level_values() 获取 code 层次的值，并通过 unique() 方法得到该层次的唯一值。

总结

MultiIndex.get_level_values() 方法非常适合从多层索引中提取特定层次的值，以便进一步操作或分析。它可以通过层次的名称或索引号灵活地获取层次内容，适用于多层次数据的处理。

参考

• https://pandas.pydata.org/docs/reference/api/pandas.MultiIndex.get_level_values.html

更新时间：2024-10-24 08:36:45 标签：pandas python 多层索引