pandas head(n) 返回前 n 行

看过来

《pandas 教程》持续更新中，提供建议、纠错、催更等加作者微信: gairuo123（备注：pandas教程）和关注公众号「盖若」ID: gairuo。跟作者学习，请进入 Python学习课程。欢迎关注作者出版的书籍：《深入浅出Pandas》和《Python之光》。

pandas 中的 head(n) 方法用于返回 DataFrame 或 Series 前 n 行的数据。这在快速查看数据集的前几行时非常有用。默认情况下，如果没有指定 n 的值，head() 方法将返回前 5 行数据。

用法

适用类型：

pandas.DataFrame.head
pandas.Series.head
pandas.core.groupby.DataFrameGroupBy.head
pandas.core.groupby.SeriesGroupBy.head

Series.head(n=5)
DataFrame.head(n=5)

此函数根据位置返回对象的前n行。它对于快速测试对象中是否包含正确类型的数据非常有用。对于负值n，此函数返回除最后|n|行之外的所有行，相当于 df[：n]。如果n大于行数，则此函数返回所有行。

分组对象使用：

SeriesGroupBy.head(n=5)
DataFrameGroupBy.head(n=5)

返回每组的前n行。类似于.apply(lambda x: x.head(n))，但它返回原始DataFrame中的一个子集，保留了原始索引和顺序（as_index标志被忽略）。如果为正：从每组开始包含的条目数。如果为负数：从每组末尾排除的条目数。

用法示例

import pandas as pd

# 创建一个示例 DataFrame
data = {
    'A': [1, 2, 3, 4, 5, 6, 7],
    'B': ['a', 'b', 'c', 'd', 'e', 'f', 'g'],
    'C': [10.1, 11.2, 12.3, 13.4, 14.5, 15.6, 16.7]
}
df = pd.DataFrame(data)

# 使用 head() 方法查看前 5 行
print(df.head())
'''
   A  B     C
0  1  a  10.1
1  2  b  11.2
2  3  c  12.3
3  4  d  13.4
4  5  e  14.5
'''

可以通过指定 n 的值来返回特定数量的行：

# 返回前 3 行
print(df.head(3))
'''
   A  B     C
0  1  a  10.1
1  2  b  11.2
2  3  c  12.3
'''

head(n) 方法也可以用于 Series：

# 创建一个示例 Series
s = pd.Series([1, 2, 3, 4, 5, 6, 7])

# 使用 head() 方法查看前 5 行
print(s.head())
'''
0    1
1    2
2    3
3    4
4    5
dtype: int64
'''

# 返回前 3 行
print(s.head(3))
'''
0    1
1    2
2    3
dtype: int64
'''

分组的用法：

>>> df = pd.DataFrame([[1, 2], [1, 4], [5, 6]],
...                   columns=['A', 'B'])
>>> df.groupby('A').head(1)
   A  B
0  1  2
2  5  6
>>> df.groupby('A').head(-1)
   A  B
0  1  2

参考

https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.head.html
https://pandas.pydata.org/docs/reference/api/pandas.Series.head.html
https://pandas.pydata.org/docs/reference/api/pandas.core.groupby.DataFrameGroupBy.head.html
https://pandas.pydata.org/docs/reference/api/pandas.core.groupby.SeriesGroupBy.head.html

< first() 函数 pandas 函数详细介绍 xs() 按索引标签选择数据 >

< first() 和 last() 方法（弃用） pandas 查询筛选数据 tail() 查看尾部数据 >

pandas 数据的信息 tail() 查看尾部数据 >

更新时间：2024-07-12 17:04:32 标签：pandas python 头部数据行