From b33627949c300d0316437c6dee2661834b5195de Mon Sep 17 00:00:00 2001 From: smij720 Date: Sun, 15 Jan 2023 17:13:42 -0800 Subject: [PATCH 1/2] Add docstring for DataFrame.T property --- pandas/core/frame.py | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/pandas/core/frame.py b/pandas/core/frame.py index 46f8c73027f48..083e5b696fbc5 100644 --- a/pandas/core/frame.py +++ b/pandas/core/frame.py @@ -3569,6 +3569,32 @@ def transpose(self, *args, copy: bool = False) -> DataFrame: @property def T(self) -> DataFrame: + """ + The transpose of the DataFrame. + + Returns + ------- + DataFrame + The transposed DataFrame. + + Examples + -------- + >>> df = pd.DataFrame({'col1': [1, 2], 'col2': [3, 4]}) + >>> df + col1 col2 + 0 1 3 + 1 2 4 + + >>> df.T + 0 1 + col1 1 2 + col2 3 4 + + + See Also + -------- + DataFrame.transpose : Transpose index and columns. + """ return self.transpose() # ---------------------------------------------------------------------- From 78b62584b245e19daf14999615e64d67dd9e36cb Mon Sep 17 00:00:00 2001 From: smij720 Date: Sun, 15 Jan 2023 22:52:21 -0800 Subject: [PATCH 2/2] Reorder docstring --- pandas/core/frame.py | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/pandas/core/frame.py b/pandas/core/frame.py index 083e5b696fbc5..f6994b6912e29 100644 --- a/pandas/core/frame.py +++ b/pandas/core/frame.py @@ -3577,6 +3577,10 @@ def T(self) -> DataFrame: DataFrame The transposed DataFrame. + See Also + -------- + DataFrame.transpose : Transpose index and columns. + Examples -------- >>> df = pd.DataFrame({'col1': [1, 2], 'col2': [3, 4]}) @@ -3589,11 +3593,6 @@ def T(self) -> DataFrame: 0 1 col1 1 2 col2 3 4 - - - See Also - -------- - DataFrame.transpose : Transpose index and columns. """ return self.transpose()