From 74111f6a40f8c7a93ba33e2f80ac34f78642aeb5 Mon Sep 17 00:00:00 2001 From: julianschnitzler <32015957+julianschnitzler@users.noreply.github.com> Date: Wed, 12 May 2021 23:06:28 +0200 Subject: [PATCH 1/6] DOC: Add custom index to example in pandas.DataFrame.append #41407 Change index to [0, 2] to stress that ignore_index=True resets the index of both dataframes --- pandas/core/frame.py | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/pandas/core/frame.py b/pandas/core/frame.py index 2941b6ac01904..2dbb61d5d0e24 100644 --- a/pandas/core/frame.py +++ b/pandas/core/frame.py @@ -8811,18 +8811,18 @@ def append( Examples -------- - >>> df = pd.DataFrame([[1, 2], [3, 4]], columns=list('AB')) + >>> df = pd.DataFrame([[1, 2], [3, 4]], columns=list('AB'), index=[0,2]) >>> df A B 0 1 2 - 1 3 4 - >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB')) + 2 3 4 + >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'), index=[0,2]) >>> df.append(df2) A B 0 1 2 - 1 3 4 + 2 3 4 0 5 6 - 1 7 8 + 2 7 8 With `ignore_index` set to True: From f614e9cea66220d788dddc3489714e331cd73f31 Mon Sep 17 00:00:00 2001 From: julianschnitzler <32015957+julianschnitzler@users.noreply.github.com> Date: Wed, 12 May 2021 23:22:12 +0200 Subject: [PATCH 2/6] DOC: align comment with PEP8 #41407 --- pandas/core/frame.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pandas/core/frame.py b/pandas/core/frame.py index 2dbb61d5d0e24..7fda660f9d079 100644 --- a/pandas/core/frame.py +++ b/pandas/core/frame.py @@ -8811,12 +8811,12 @@ def append( Examples -------- - >>> df = pd.DataFrame([[1, 2], [3, 4]], columns=list('AB'), index=[0,2]) + >>> df = pd.DataFrame([[1, 2], [3, 4]], columns=list('AB'), index=[0, 2]) >>> df A B 0 1 2 2 3 4 - >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'), index=[0,2]) + >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'), index=[0, 2]) >>> df.append(df2) A B 0 1 2 From 0d3321916416588ccce5cdeeebfaa35c9e9633c5 Mon Sep 17 00:00:00 2001 From: julianschnitzler <32015957+julianschnitzler@users.noreply.github.com> Date: Thu, 13 May 2021 09:25:31 +0200 Subject: [PATCH 3/6] DOC: change example in pandas.DataFrame.append to non-matching indices #41407 --- pandas/core/frame.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pandas/core/frame.py b/pandas/core/frame.py index 7fda660f9d079..89aeac810b464 100644 --- a/pandas/core/frame.py +++ b/pandas/core/frame.py @@ -8816,13 +8816,13 @@ def append( A B 0 1 2 2 3 4 - >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'), index=[0, 2]) + >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'), index=[3, 5]) >>> df.append(df2) A B 0 1 2 2 3 4 - 0 5 6 - 2 7 8 + 3 5 6 + 5 7 8 With `ignore_index` set to True: From 92c4766f412a39a6627e7ba9470f0152083da2f7 Mon Sep 17 00:00:00 2001 From: julianschnitzler <32015957+julianschnitzler@users.noreply.github.com> Date: Thu, 13 May 2021 10:37:56 +0200 Subject: [PATCH 4/6] DOC: make first indexes the same to stress non-uniqueness of resulting index #41407 --- pandas/core/frame.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pandas/core/frame.py b/pandas/core/frame.py index 89aeac810b464..ab4ce724224e3 100644 --- a/pandas/core/frame.py +++ b/pandas/core/frame.py @@ -8816,13 +8816,13 @@ def append( A B 0 1 2 2 3 4 - >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'), index=[3, 5]) + >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'), index=[0, 4]) >>> df.append(df2) A B 0 1 2 2 3 4 - 3 5 6 - 5 7 8 + 0 5 6 + 4 7 8 With `ignore_index` set to True: From 06a04b91016faa07ad93b7e233b284c3dc4f57af Mon Sep 17 00:00:00 2001 From: julianschnitzler <32015957+julianschnitzler@users.noreply.github.com> Date: Fri, 14 May 2021 12:48:38 +0200 Subject: [PATCH 5/6] DOC: add Return description #41407 --- pandas/core/frame.py | 1 + 1 file changed, 1 insertion(+) diff --git a/pandas/core/frame.py b/pandas/core/frame.py index ab4ce724224e3..e5adf0da741eb 100644 --- a/pandas/core/frame.py +++ b/pandas/core/frame.py @@ -8793,6 +8793,7 @@ def append( Returns ------- DataFrame + A new DataFrame consisting of the rows of caller and the rows of `other`. See Also -------- From 8d8a0b73e3f04057d6a4a65d88bfa6ff4cd8aee4 Mon Sep 17 00:00:00 2001 From: julianschnitzler <32015957+julianschnitzler@users.noreply.github.com> Date: Sun, 16 May 2021 12:02:41 +0200 Subject: [PATCH 6/6] DOC: change index to x, y #41407 --- pandas/core/frame.py | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/pandas/core/frame.py b/pandas/core/frame.py index e5adf0da741eb..d90487647d35b 100644 --- a/pandas/core/frame.py +++ b/pandas/core/frame.py @@ -8812,18 +8812,18 @@ def append( Examples -------- - >>> df = pd.DataFrame([[1, 2], [3, 4]], columns=list('AB'), index=[0, 2]) + >>> df = pd.DataFrame([[1, 2], [3, 4]], columns=list('AB'), index=['x', 'y']) >>> df A B - 0 1 2 - 2 3 4 - >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'), index=[0, 4]) + x 1 2 + y 3 4 + >>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'), index=['x', 'y']) >>> df.append(df2) A B - 0 1 2 - 2 3 4 - 0 5 6 - 4 7 8 + x 1 2 + y 3 4 + x 5 6 + y 7 8 With `ignore_index` set to True: