pandas.DataFrame.itertuples

DataFrame.itertuples(self, index=True, name='Pandas') [source]

Итерирование по строкам DataFrame в виде именованных кортежей.

Параметры:	index : bool, default True Если True, возвращает индекс в качестве первого элемента кортежа. name : str or None, default “Pandas” Имя возвращаемых именованных кортежей или None для возвращения обычных кортежей.
Возвращает:	итератор Объект для итерирования по именованным кортежам для каждой строки DataFrame, где первый элемент может быть индексом, а последующие элементы — значениями столбцов.

См. также

DataFrame.iterrows

Итерирование по строкам DataFrame в виде пар (индекс, Series).

DataFrame.items

Итерирование по парам (имя столбца, Series).

Примечания

Имена столбцов будут переименованы в позиционные имена, если они являются недопустимыми идентификаторами Python, повторяющимися или начинающимися с подчеркивания. При большом количестве столбцов (>255) возвращаются обычные кортежи.

Примеры

>>> df = pd.DataFrame({'num_legs': [4, 2], 'num_wings': [0, 2]},
...                   index=['dog', 'hawk'])
>>> df
      num_legs  num_wings
dog          4          0
hawk         2          2
>>> for row in df.itertuples():
...     print(row)
...
Pandas(Index='dog', num_legs=4, num_wings=0)
Pandas(Index='hawk', num_legs=2, num_wings=2)

Установив параметр index в значение False, мы можем удалить индекс как первый элемент кортежа:

>>> for row in df.itertuples(index=False):
...     print(row)
...
Pandas(num_legs=4, num_wings=0)
Pandas(num_legs=2, num_wings=2)

С параметром name мы устанавливаем пользовательское имя для возвращаемых именованных кортежей:

>>> for row in df.itertuples(name='Animal'):
...     print(row)
...
Animal(Index='dog', num_legs=4, num_wings=0)
Animal(Index='hawk', num_legs=2, num_wings=2)