To latex position

pandas/core/generic.py

@@ -2840,6 +2840,7 @@ def to_latex(
         multirow=None,
         caption=None,
         label=None,
+        position=None,
     ):
         r"""
         Render object to a LaTeX tabular, longtable, or nested table/tabular.
@@ -2925,6 +2926,9 @@ def to_latex(
             This is used with ``\ref{}`` in the main ``.tex`` file.
 
             .. versionadded:: 1.0.0
+        position : str, optional
+            The LaTeX positional argument for tables, to be placed after
+            ``\begin{}`` in the output.
         %(returns)s
         See Also
         --------
@@ -2986,6 +2990,7 @@ def to_latex(
             multirow=multirow,
             caption=caption,
             label=label,
+            position=position,
         )
 
     def to_csv(

pandas/io/formats/format.py

@@ -931,6 +931,7 @@ def to_latex(
         multirow: bool = False,
         caption: Optional[str] = None,
         label: Optional[str] = None,
+        position: Optional[str] = None,
     ) -> Optional[str]:
         """
         Render a DataFrame to a LaTeX tabular/longtable environment output.
@@ -946,6 +947,7 @@ def to_latex(
             multirow=multirow,
             caption=caption,
             label=label,
+            position=position,
         ).get_result(buf=buf, encoding=encoding)
 
     def _format_col(self, i: int) -> List[str]:

pandas/io/formats/latex.py

@@ -38,6 +38,7 @@ def __init__(
         multirow: bool = False,
         caption: Optional[str] = None,
         label: Optional[str] = None,
+        position: Optional[str] = None,
     ):
         self.fmt = formatter
         self.frame = self.fmt.frame
@@ -50,6 +51,7 @@ def __init__(
         self.caption = caption
         self.label = label
         self.escape = self.fmt.escape
+        self.position = position
 
     def write_result(self, buf: IO[str]) -> None:
         """
@@ -284,8 +286,13 @@ def _write_tabular_begin(self, buf, column_format: str):
             <https://en.wikibooks.org/wiki/LaTeX/Tables>`__ e.g 'rcl'
             for 3 columns
         """
-        if self.caption is not None or self.label is not None:
+        if (
+            self.caption is not None
+            or self.label is not None
+            or self.position is not None
+        ):
             # then write output in a nested table/tabular environment
+            buf.write(f"\\begin{{table}}")
             if self.caption is None:
                 caption_ = ""
             else:
@@ -296,7 +303,12 @@ def _write_tabular_begin(self, buf, column_format: str):
             else:
                 label_ = f"\n\\label{{{self.label}}}"
 
-            buf.write(f"\\begin{{table}}\n\\centering{caption_}{label_}\n")
+            if self.position is None:
+                position_ = ""
+            else:
+                position_ = f"[{self.position}]"
+
+            buf.write(f"{position_}\n\\centering{caption_}{label_}\n")
         else:
             # then write output only in a tabular environment
             pass
@@ -317,7 +329,11 @@ def _write_tabular_end(self, buf):
         """
         buf.write("\\bottomrule\n")
         buf.write("\\end{tabular}\n")
-        if self.caption is not None or self.label is not None:
+        if (
+            self.caption is not None
+            or self.label is not None
+            or self.position is not None
+        ):
             buf.write("\\end{table}\n")
         else:
             pass
@@ -337,7 +353,11 @@ def _write_longtable_begin(self, buf, column_format: str):
             <https://en.wikibooks.org/wiki/LaTeX/Tables>`__ e.g 'rcl'
             for 3 columns
         """
-        buf.write(f"\\begin{{longtable}}{{{column_format}}}\n")
+        if self.position is None:
+            position_ = ""
+        else:
+            position_ = f"[{self.position}]"
+        buf.write(f"\\begin{{longtable}}{position_}{{{column_format}}}\n")
 
         if self.caption is not None or self.label is not None:
             if self.caption is None:

pandas/tests/io/formats/test_to_latex.py

@@ -438,10 +438,11 @@ def test_to_latex_longtable(self):
         with3columns_result = df.to_latex(index=False, longtable=True)
         assert r"\multicolumn{3}" in with3columns_result
 
-    def test_to_latex_caption_label(self):
+    def test_to_latex_caption_label_position(self):
         # GH 25436
         the_caption = "a table in a \\texttt{table/tabular} environment"
         the_label = "tab:table_tabular"
+        the_position = "h"
 
         df = DataFrame({"a": [1, 2], "b": ["b1", "b2"]})
 
@@ -481,6 +482,23 @@ def test_to_latex_caption_label(self):
 """
         assert result_l == expected_l
 
+        # test when only the label is provided
+        result_p = df.to_latex(position=the_position)
+
+        expected_p = r"""\begin{table}[h]
+\centering
+\begin{tabular}{lrl}
+\toprule
+{} &  a &   b \\
+\midrule
+0 &  1 &  b1 \\
+1 &  2 &  b2 \\
+\bottomrule
+\end{tabular}
+\end{table}
+"""
+        assert result_p == expected_p
+
         # test when the caption and the label are provided
         result_cl = df.to_latex(caption=the_caption, label=the_label)
 
@@ -500,10 +518,11 @@ def test_to_latex_caption_label(self):
 """
         assert result_cl == expected_cl
 
-    def test_to_latex_longtable_caption_label(self):
+    def test_to_latex_longtable_caption_label_position(self):
         # GH 25436
         the_caption = "a table in a \\texttt{longtable} environment"
         the_label = "tab:longtable"
+        the_position = "t"
 
         df = DataFrame({"a": [1, 2], "b": ["b1", "b2"]})
 
@@ -551,6 +570,27 @@ def test_to_latex_longtable_caption_label(self):
 """
         assert result_l == expected_l
 
+        # test when only the caption is provided
+        result_p = df.to_latex(longtable=True, position=the_position)
+
+        expected_p = r"""\begin{longtable}[t]{lrl}
+\toprule
+{} &  a &   b \\
+\midrule
+\endhead
+\midrule
+\multicolumn{3}{r}{{Continued on next page}} \\
+\midrule
+\endfoot
+
+\bottomrule
+\endlastfoot
+0 &  1 &  b1 \\
+1 &  2 &  b2 \\
+\end{longtable}
+"""
+        assert result_p == expected_p
+
         # test when the caption and the label are provided
         result_cl = df.to_latex(longtable=True, caption=the_caption, label=the_label)