Merge branch 'series_to_dataframe' of https://github.com/drasch/pandas into drasch-series_to_dataframe

Conflicts:
	doc/source/v0.13.0.txt

Author: jreback

doc/source/api.rst

@@ -438,6 +438,7 @@ Serialization / IO / Conversion
    Series.to_pickle
    Series.to_csv
    Series.to_dict
+   Series.to_frame
    Series.to_sparse
    Series.to_string
    Series.to_clipboard

doc/source/release.rst

@@ -176,6 +176,7 @@ Improvements to existing features
   - ``DataFrame.from_records()`` will now accept generators (:issue:`4910`)
   - ``DataFrame.interpolate()`` and ``Series.interpolate()`` have been expanded to include
     interpolation methods from scipy. (:issue:`4434`, :issue:`1892`)
+  - ``Series`` now supports a ``to_frame`` method to convert it to a single-column DataFrame (:issue:`5164`)
 
 API Changes
 ~~~~~~~~~~~

doc/source/v0.13.0.txt

@@ -492,6 +492,8 @@ Enhancements
 
     :ref:`See the docs<indexing.basics.indexing_isin>` for more.
 
+- ``Series`` now supports a ``to_frame`` method to convert it to a single-column DataFrame (:issue:`5164`)
+
 - All R datasets listed here http://stat.ethz.ch/R-manual/R-devel/library/datasets/html/00Index.html can now be loaded into Pandas objects
 
   .. code-block:: python

pandas/core/series.py

@@ -827,12 +827,7 @@ def reset_index(self, level=None, drop=False, name=None, inplace=False):
             raise TypeError('Cannot reset_index inplace on a Series '
                             'to create a DataFrame')
         else:
-            from pandas.core.frame import DataFrame
-            if name is None:
-                df = DataFrame(self)
-            else:
-                df = DataFrame({name: self})
-
+            df = self.to_frame(name)
             return df.reset_index(level=level, drop=drop)
 
     def __unicode__(self):
@@ -1028,6 +1023,27 @@ def to_dict(self):
         """
         return dict(compat.iteritems(self))
 
+    def to_frame(self, name=None):
+        """
+        Convert Series to DataFrame
+
+        Parameters
+        ----------
+        name : object, default None
+            The passed name should substitute for the series name (if it has one).
+
+        Returns
+        -------
+        data_frame : DataFrame
+        """
+        from pandas.core.frame import DataFrame
+        if name is None:
+            df = DataFrame(self)
+        else:
+            df = DataFrame({name: self})
+
+        return df
+
     def to_sparse(self, kind='block', fill_value=None):
         """
         Convert Series to SparseSeries

pandas/tests/test_series.py

@@ -30,6 +30,7 @@
 from pandas import compat
 from pandas.util.testing import (assert_series_equal,
                                  assert_almost_equal,
+                                 assert_frame_equal,
                                  ensure_clean)
 import pandas.util.testing as tm
 
@@ -3679,6 +3680,21 @@ def test_tolist(self):
         rs = s.tolist()
         self.assertEqual(self.ts.index[0], rs[0])
 
+    def test_to_frame(self):
+        self.ts.name = None
+        rs = self.ts.to_frame()
+        xp = pd.DataFrame(self.ts.values, index=self.ts.index)
+        assert_frame_equal(rs, xp)
+
+        self.ts.name = 'testname'
+        rs = self.ts.to_frame()
+        xp = pd.DataFrame(dict(testname=self.ts.values), index=self.ts.index)
+        assert_frame_equal(rs, xp)
+
+        rs = self.ts.to_frame(name='testdifferent')
+        xp = pd.DataFrame(dict(testdifferent=self.ts.values), index=self.ts.index)
+        assert_frame_equal(rs, xp)
+
     def test_to_dict(self):
         self.assert_(np.array_equal(Series(self.ts.to_dict()), self.ts))