From 6a5bd899833ee72678e6c61b9e22ba1b24c19878 Mon Sep 17 00:00:00 2001
From: TomAugspurger <thomas-augspurger@uiowa.edu>
Date: Mon, 12 Jan 2015 21:13:15 -0600
Subject: [PATCH] ENH: Add assign method to DataFrame

Creates a new method for DataFrame, based off dplyr's mutate.
Closes https://github.com/pydata/pandas/issues/9229
---
 doc/source/_static/whatsnew_assign.png | Bin 0 -> 22935 bytes
 doc/source/basics.rst                  |   2 +
 doc/source/dsintro.rst                 |  76 +++++++++++++++++++++++
 doc/source/whatsnew/v0.16.0.txt        |  41 +++++++++++++
 pandas/core/frame.py                   |  82 +++++++++++++++++++++++++
 pandas/tests/test_frame.py             |  54 ++++++++++++++++
 6 files changed, 255 insertions(+)
 create mode 100644 doc/source/_static/whatsnew_assign.png

diff --git a/doc/source/_static/whatsnew_assign.png b/doc/source/_static/whatsnew_assign.png
new file mode 100644
index 0000000000000000000000000000000000000000..0e39e161dc6069400aaf01995133fcd50b925e86
GIT binary patch
literal 22935
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
CbA&4Z

literal 0
HcmV?d00001

diff --git a/doc/source/basics.rst b/doc/source/basics.rst
index dc43c1177f8c3..8e78ac597479b 100644
--- a/doc/source/basics.rst
+++ b/doc/source/basics.rst
@@ -11,6 +11,7 @@
    from pandas.compat import lrange
    options.display.max_rows=15
 
+
 ==============================
  Essential Basic Functionality
 ==============================
@@ -793,6 +794,7 @@ This is equivalent to the following
    result
    result.loc[:,:,'ItemA']
 
+
 .. _basics.reindexing:
 
 
diff --git a/doc/source/dsintro.rst b/doc/source/dsintro.rst
index 44321375d31a2..6eb13ce722fff 100644
--- a/doc/source/dsintro.rst
+++ b/doc/source/dsintro.rst
@@ -450,6 +450,82 @@ available to insert at a particular location in the columns:
    df.insert(1, 'bar', df['one'])
    df
 
+.. _dsintro.chained_assignment:
+
+Assigning New Columns in Method Chains
+--------------------------------------
+
+.. versionadded:: 0.16.0
+
+Inspired by `dplyr's
+<http://cran.rstudio.com/web/packages/dplyr/vignettes/introduction.html#mutate>`__
+``mutate`` verb, DataFrame has an :meth:`~pandas.DataFrame.assign`
+method that allows you to easily create new columns that are potentially
+derived from existing columns. 
+
+.. ipython:: python
+
+   iris = read_csv('data/iris.data')
+   iris.head()
+
+   (iris.assign(sepal_ratio = iris['SepalWidth'] / iris['SepalLength'])
+        .head())
+
+Above was an example of inserting a precomputed value. We can also pass in
+a function of one argument to be evalutated on the DataFrame being assigned to.
+
+.. ipython:: python
+
+   iris.assign(sepal_ratio = lambda x: (x['SepalWidth'] /
+                                        x['SepalLength'])).head()
+
+``assign`` **always** returns a copy of the data, leaving the original
+DataFrame untouched.
+
+Passing a callable, as opposed to an actual value to be inserted, is
+useful when you don't have a reference to the DataFrame at hand. This is
+common when using ``assign`` in chains of operations. For example,
+we can limit the DataFrame to just those observations with a Sepal Length
+greater than 5, calculate the ratio, and plot:
+
+.. ipython:: python
+
+   @savefig basics_assign.png
+   (iris.query('SepalLength > 5')
+        .assign(SepalRatio = lambda x: x.SepalWidth / x.SepalLength,
+                PetalRatio = lambda x: x.PetalWidth / x.PetalLength)
+        .plot(kind='scatter', x='SepalRatio', y='PetalRatio'))
+
+Since a function is passed in, the function is computed on the DataFrame
+being assigned to. Importantly, this is the DataFrame that's been filtered
+to those rows with sepal length greater than 5. The filtering happens first,
+and then the ratio calculations. This is an example where we didn't
+have a reference to the *filtered* DataFrame available.
+
+The function signature for ``assign`` is simply ``**kwargs``. The keys
+are the column names for the new fields, and the values are either a value
+to be inserted (for example, a ``Series`` or NumPy array), or a function
+of one argument to be called on the ``DataFrame``. A *copy* of the original
+DataFrame is returned, with the new values inserted.
+
+.. warning::
+
+  Since the function signature of ``assign`` is ``**kwargs``, a dictionary,
+  the order of the new columns in the resulting DataFrame cannot be guaranteed.
+
+  All expressions are computed first, and then assigned. So you can't refer
+  to another column being assigned in the same call to ``assign``. For example:
+
+   .. ipython::
+       :verbatim:
+
+       In [1]: # Don't do this, bad reference to `C`
+               df.assign(C = lambda x: x['A'] + x['B'],
+                         D = lambda x: x['A'] + x['C'])
+       In [2]: # Instead, break it into two assigns
+               (df.assign(C = lambda x: x['A'] + x['B'])
+                  .assign(D = lambda x: x['A'] + x['C']))
+
 Indexing / Selection
 ~~~~~~~~~~~~~~~~~~~~
 The basics of indexing are as follows:
diff --git a/doc/source/whatsnew/v0.16.0.txt b/doc/source/whatsnew/v0.16.0.txt
index ead3c79430bf9..b9c358f24f460 100644
--- a/doc/source/whatsnew/v0.16.0.txt
+++ b/doc/source/whatsnew/v0.16.0.txt
@@ -29,6 +29,47 @@ New features
 
   This method is also exposed by the lower level ``Index.get_indexer`` and ``Index.get_loc`` methods.
 
+- DataFrame assign method
+
+Inspired by `dplyr's
+<http://cran.rstudio.com/web/packages/dplyr/vignettes/introduction.html#mutate>`__ ``mutate`` verb, DataFrame has a new
+:meth:`~pandas.DataFrame.assign` method.
+The function signature for ``assign`` is simply ``**kwargs``. The keys
+are the column names for the new fields, and the values are either a value
+to be inserted (for example, a ``Series`` or NumPy array), or a function
+of one argument to be called on the ``DataFrame``. The new values are inserted,
+and the entire DataFrame (with all original and new columns) is returned.
+
+.. ipython :: python
+
+   iris = read_csv('data/iris.data')
+   iris.head()
+
+   iris.assign(sepal_ratio=iris['SepalWidth'] / iris['SepalLength']).head()
+
+Above was an example of inserting a precomputed value. We can also pass in
+a function to be evalutated.
+
+.. ipython :: python
+
+    iris.assign(sepal_ratio = lambda x: (x['SepalWidth'] /
+                                         x['SepalLength'])).head()
+
+The power of ``assign`` comes when used in chains of operations. For example,
+we can limit the DataFrame to just those with a Sepal Length greater than 5,
+calculate the ratio, and plot
+
+.. ipython:: python
+
+   (iris.query('SepalLength > 5')
+        .assign(SepalRatio = lambda x: x.SepalWidth / x.SepalLength,
+                PetalRatio = lambda x: x.PetalWidth / x.PetalLength)
+        .plot(kind='scatter', x='SepalRatio', y='PetalRatio'))
+
+.. image:: _static/whatsnew_assign.png
+    
+See the :ref:`documentation <dsintro.chained_assignment>` for more. (:issue:`9229`)
+
 .. _whatsnew_0160.api:
 
 .. _whatsnew_0160.api_breaking:
diff --git a/pandas/core/frame.py b/pandas/core/frame.py
index d64353db8cda6..97e3560e3fcb1 100644
--- a/pandas/core/frame.py
+++ b/pandas/core/frame.py
@@ -2220,6 +2220,88 @@ def insert(self, loc, column, value, allow_duplicates=False):
         self._data.insert(
             loc, column, value, allow_duplicates=allow_duplicates)
 
+    def assign(self, **kwargs):
+        """
+        Assign new columns to a DataFrame, returning a new object
+        (a copy) with all the original columns in addition to the new ones.
+
+        .. versionadded:: 0.16.0
+
+        Parameters
+        ----------
+        kwargs : keyword, value pairs
+            keywords are the column names. If the values are
+            callable, they are computed on the DataFrame and
+            assigned to the new columns. If the values are
+            not callable, (e.g. a Series, scalar, or array),
+            they are simply assigned.
+
+        Returns
+        -------
+        df : DataFrame
+            A new DataFrame with the new columns in addition to
+            all the existing columns.
+
+        Notes
+        -----
+        Since ``kwargs`` is a dictionary, the order of your
+        arguments may not be preserved, and so the order of the
+        new columns is not well defined. Assigning multiple
+        columns within the same ``assign`` is possible, but you cannot
+        reference other columns created within the same ``assign`` call.
+
+        Examples
+        --------
+        >>> df = DataFrame({'A': range(1, 11), 'B': np.random.randn(10)})
+
+        Where the value is a callable, evaluated on `df`:
+
+        >>> df.assign(ln_A = lambda x: np.log(x.A))
+            A         B      ln_A
+        0   1  0.426905  0.000000
+        1   2 -0.780949  0.693147
+        2   3 -0.418711  1.098612
+        3   4 -0.269708  1.386294
+        4   5 -0.274002  1.609438
+        5   6 -0.500792  1.791759
+        6   7  1.649697  1.945910
+        7   8 -1.495604  2.079442
+        8   9  0.549296  2.197225
+        9  10 -0.758542  2.302585
+
+        Where the value already exists and is inserted:
+
+        >>> newcol = np.log(df['A'])
+        >>> df.assign(ln_A=newcol)
+            A         B      ln_A
+        0   1  0.426905  0.000000
+        1   2 -0.780949  0.693147
+        2   3 -0.418711  1.098612
+        3   4 -0.269708  1.386294
+        4   5 -0.274002  1.609438
+        5   6 -0.500792  1.791759
+        6   7  1.649697  1.945910
+        7   8 -1.495604  2.079442
+        8   9  0.549296  2.197225
+        9  10 -0.758542  2.302585
+        """
+        data = self.copy()
+
+        # do all calculations first...
+        results = {}
+        for k, v in kwargs.items():
+
+            if callable(v):
+                results[k] = v(data)
+            else:
+                results[k] = v
+
+        # ... and then assign
+        for k, v in results.items():
+            data[k] = v
+
+        return data
+
     def _sanitize_column(self, key, value):
         # Need to make sure new columns (which go into the BlockManager as new
         # blocks) are always copied
diff --git a/pandas/tests/test_frame.py b/pandas/tests/test_frame.py
index 9ec890a1d1856..f7c91501b683b 100644
--- a/pandas/tests/test_frame.py
+++ b/pandas/tests/test_frame.py
@@ -13965,6 +13965,60 @@ def test_select_dtypes_bad_arg_raises(self):
         with tm.assertRaisesRegexp(TypeError, 'data type.*not understood'):
             df.select_dtypes(['blargy, blarg, blarg'])
 
+    def test_assign(self):
+        df = DataFrame({'A': [1, 2, 3], 'B': [4, 5, 6]})
+        original = df.copy()
+        result = df.assign(C=df.B / df.A)
+        expected = df.copy()
+        expected['C'] = [4, 2.5, 2]
+        assert_frame_equal(result, expected)
+
+        # lambda syntax
+        result = df.assign(C=lambda x: x.B / x.A)
+        assert_frame_equal(result, expected)
+
+        # original is unmodified
+        assert_frame_equal(df, original)
+
+        # Non-Series array-like
+        result = df.assign(C=[4, 2.5, 2])
+        assert_frame_equal(result, expected)
+        # original is unmodified
+        assert_frame_equal(df, original)
+
+        result = df.assign(B=df.B / df.A)
+        expected = expected.drop('B', axis=1).rename(columns={'C': 'B'})
+        assert_frame_equal(result, expected)
+
+        # overwrite
+        result = df.assign(A=df.A + df.B)
+        expected = df.copy()
+        expected['A'] = [5, 7, 9]
+        assert_frame_equal(result, expected)
+
+        # lambda
+        result = df.assign(A=lambda x: x.A + x.B)
+        assert_frame_equal(result, expected)
+
+    def test_assign_multiple(self):
+        df = DataFrame({'A': [1, 2, 3], 'B': [4, 5, 6]})
+        result = df.assign(C=[7, 8, 9], D=df.A, E=lambda x: x.B)
+        expected = DataFrame({'A': [1, 2, 3], 'B': [4, 5, 6], 'C': [7, 8, 9],
+                              'D': [1, 2, 3], 'E': [4, 5, 6]})
+        # column order isn't preserved
+        assert_frame_equal(result.reindex_like(expected), expected)
+
+    def test_assign_bad(self):
+        df = DataFrame({'A': [1, 2, 3], 'B': [4, 5, 6]})
+        # non-keyword argument
+        with tm.assertRaises(TypeError):
+            df.assign(lambda x: x.A)
+        with tm.assertRaises(AttributeError):
+            df.assign(C=df.A, D=df.A + df.C)
+        with tm.assertRaises(KeyError):
+            df.assign(C=lambda df: df.A, D=lambda df: df['A'] + df['C'])
+        with tm.assertRaises(KeyError):
+            df.assign(C=df.A, D=lambda x: x['A'] + x['C'])
 
 def skip_if_no_ne(engine='numexpr'):
     if engine == 'numexpr':