search
Search
Login
Unlock 100+ guides
menu
menu
web
search toc
close
Comments
Log in or sign up
Cancel
Post
account_circle
Profile
exit_to_app
Sign out
What does this mean?
Why is this true?
Give me some examples!
search
keyboard_voice
close
Searching Tips
Search for a recipe:
"Creating a table in MySQL"
Search for an API documentation: "@append"
Search for code: "!dataframe"
Apply a tag filter: "#python"
Useful Shortcuts
/ to open search panel
Esc to close search panel
to navigate between search results
d to clear all current filters
Enter to expand content preview
icon_star
Doc Search
icon_star
Code Search Beta
SORRY NOTHING FOUND!
mic
Start speaking...
Voice search is only supported in Safari and Chrome.
Navigate to

Pandas DataFrame | itertuples method

schedule Aug 11, 2023
Last updated
local_offer
PythonPandas
Tags
tocTable of Contents
expand_more
mode_heat
Master the mathematics behind data science with 100+ top-tier guides
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 = pd.DataFrame({"A":["a","b"],"B":["c","d"]})
df
   A  B
0  a  c
1  b  d

To iterate over the rows with the row label:

for row in df.itertuples():      # or index=True to be explicit
   print("row:", row)
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):
   print("row:", row)
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"):
   print("row:", row)
row: RoboCat(Index=0, A='a', B='c')
row: RoboCat(Index=1, A='b', B='d')
robocat
Published by Isshin Inada
Edited by 0 others
Did you find this page useful?
thumb_up
thumb_down
Comment
Citation
Ask a question or leave a feedback...
thumb_up
0
thumb_down
0
chat_bubble_outline
0
settings
Enjoy our search
Hit / to insta-search docs and recipes!