Pandas DataFrame | itertuples method
Start your free 7-days trial now!
Pandas DataFrame.itertuples(~) method is used to iterate over the rows of the DataFrame as named tuples.
Parameters
1. index | boolean | optional
If
True, then the index (row label) is returned as the first element of the tuple.If
False, then the index will be omitted from the tuple.
By default, index=True.
2. name | string or None | optional
The name assigned to the returned tuple. By default, name="Pandas".
Return Value
An iterator over the rows of the DataFrame. The rows are represented using named tuples.
Examples
Consider the following DataFrame:
df
A B0 a c1 b d
To iterate over the rows with the row label:
for row in df.itertuples(): # or index=True to be explicit
row: Pandas(Index=0, A='a', B='c')row: Pandas(Index=1, A='b', B='d')
Here, we see Pandas because this is the default name assigned to the returned tuple (i.e. name="Pandas").
To iterate over the rows without the row label, set index=False:
for row in df.itertuples(index=False):
row: Pandas(A='a', B='c')row: Pandas(A='b', B='d')
To set a custom name for the tuple, set the name parameter:
for row in df.itertuples(name="RoboCat"):
row: RoboCat(Index=0, A='a', B='c')row: RoboCat(Index=1, A='b', B='d')
