Added additional validation, whats new entry, documentation entry

Author: jeffcarey

doc/source/io.rst

@@ -2777,6 +2777,7 @@ Added support for Openpyxl >= 2.2
     ``'xlsxwriter'`` will produce an Excel 2007-format workbook (xlsx). If
     omitted, an Excel 2007-formatted workbook is produced.
 
+
 .. _io.excel.writers:
 
 Excel writer engines
@@ -2823,6 +2824,16 @@ argument to ``to_excel`` and to ``ExcelWriter``. The built-in engines are:
 
    df.to_excel('path_to_file.xlsx', sheet_name='Sheet1')
 
+Style and Formatting
+''''''''''''''''''''
+
+The look and feel of Excel worksheets created from pandas can be modified using the following parameters on the ``DataFrame``'s ``to_excel`` method.
+
+- ``float_format`` : Format string for floating point numbers (default None)
+- ``freeze_panes`` : A tuple of two integers representing the bottommost row and rightmost column to freeze. Each of these parameters is one-based, so (1, 1) will
+freeze the first row and first column (default None)
+
+
 .. _io.clipboard:
 
 Clipboard

doc/source/whatsnew/v0.20.0.txt

@@ -146,6 +146,7 @@ Other enhancements
 - ``Series/DataFrame.asfreq()`` have gained a ``fill_value`` parameter, to fill missing values (:issue:`3715`).
 - ``Series/DataFrame.resample.asfreq`` have gained a ``fill_value`` parameter, to fill missing values during resampling (:issue:`3715`).
 - ``pandas.tools.hashing`` has gained a ``hash_tuples`` routine, and ``hash_pandas_object`` has gained the ability to hash a ``MultiIndex`` (:issue:`15224`)
+- ``DataFrame.to_excel()`` has a new ``freeze_panes`` parameter to turn on Freeze Panes when exporting to Excel (:issue:`15160`)
 
 .. _ISO 8601 duration: https://en.wikipedia.org/wiki/ISO_8601#Durations
 

pandas/core/generic.py

@@ -1019,7 +1019,7 @@ def __setstate__(self, state):
     # I/O Methods
 
     _shared_docs['to_excel'] = """
-    Write %(klass)s to a excel sheet
+    Write %(klass)s to an excel sheet
     %(versionadded_to_excel)s
     Parameters
     ----------
@@ -1058,6 +1058,9 @@ def __setstate__(self, state):
     inf_rep : string, default 'inf'
         Representation for infinity (there is no native representation for
         infinity in Excel)
+    freeze_panes : tuple of integer (length 2), default None
+        Specifies the bottommost row and rightmost column that
+        is to be frozen
 
     Notes
     -----

pandas/io/excel.py

@@ -811,6 +811,7 @@ def write_cells(self, cells, sheet_name=None, startrow=0, startcol=0,
                     freeze_panes=None):
         # Write the frame cells using openpyxl.
         from openpyxl.cell import get_column_letter
+
         sheet_name = self._get_sheet_name(sheet_name)
 
         if sheet_name in self.sheets:
@@ -1327,7 +1328,11 @@ def write_cells(self, cells, sheet_name=None, startrow=0, startcol=0,
             wks.title = sheet_name
             self.sheets[sheet_name] = wks
 
-        if freeze_panes is not None:
+        if (
+            freeze_panes is not None and
+            len(freeze_panes) == 2 and
+            all(isinstance(item, int) for item in freeze_panes)
+        ):
             wks.freeze_panes = wks.cell(row=freeze_panes[0] + 1,
                                         column=freeze_panes[1] + 1)
 
@@ -1414,7 +1419,11 @@ def write_cells(self, cells, sheet_name=None, startrow=0, startcol=0,
             wks = self.book.add_sheet(sheet_name)
             self.sheets[sheet_name] = wks
 
-        if freeze_panes is not None:
+        if (
+            freeze_panes is not None and
+            len(freeze_panes) == 2 and
+            all(isinstance(item, int) for item in freeze_panes)
+        ):
             wks.set_panes_frozen(True)
             wks.set_horz_split_pos(freeze_panes[0])
             wks.set_vert_split_pos(freeze_panes[1])
@@ -1545,7 +1554,11 @@ def write_cells(self, cells, sheet_name=None, startrow=0, startcol=0,
 
         style_dict = {}
 
-        if freeze_panes is not None:
+        if (
+            freeze_panes is not None and
+            len(freeze_panes) == 2 and
+            all(isinstance(item, int) for item in freeze_panes)
+        ):
             wks.freeze_panes(*(freeze_panes))
 
         for cell in cells: