DataFrame.head() / Series.head()

Метод head() возвращает первые n строк объекта. Используется для быстрого осмотра больших таблиц — структуры, типов данных, корректности загрузки.

Сигнатура

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

Параметры

  • n — количество строк (по умолчанию 5). При отрицательном n возвращаются все строки, кроме последних |n|.

Возвращаемое значение

Новый DataFrame или Series с первыми n элементами. Исходный объект не изменяется.

Примеры

Пример 1. По умолчанию 5 строк

import pandas as pd

df = pd.DataFrame({"v": range(10)})
print(df.head())

   v
0  0
1  1
2  2
3  3
4  4

Пример 2. Явное количество

import pandas as pd

df = pd.DataFrame({"sensor": list("ABCDEFGH")})
print(df.head(3))

  sensor
0      A
1      B
2      C

Пример 3. Отрицательное n

Возвращает все строки, кроме последних 2.

import pandas as pd

df = pd.DataFrame({"x": [10, 20, 30, 40, 50]})
print(df.head(-2))

    x
0  10
1  20
2  30

Пример 4. Series

import pandas as pd

s = pd.Series([22.1, 22.3, 22.0, 22.5, 22.2, 22.4])
print(s.head(2))

0    22.1
1    22.3
dtype: float64

Пример 5. Цепочка после фильтра

Первые 3 строки лога с командой FORWARD:

import pandas as pd

df = pd.DataFrame({
    "cmd": ["FWD", "LEFT", "FWD", "STOP", "FWD", "FWD"],
    "t":   [0.0, 0.5, 1.0, 1.5, 2.0, 2.5],
})
print(df[df["cmd"] == "FWD"].head(3))

   cmd    t
0  FWD  0.0
2  FWD  1.0
4  FWD  2.0

См. также

Примечание

Лицензия и источники

Техническое описание функции адаптировано из официальной документации Pandas (https://pandas.pydata.org/docs/), BSD-3-Clause License. Примеры и пояснения — © AlashEd Wiki.