Python pandas.DataFrame.update用法及代码示例

用法: DataFrame.update(other, join='left', overwrite=True, filter_func=None, errors='ignore')

使用来自另一个 DataFrame 的非 NA 值进行就地修改。

对齐索引。没有返回值。

参数：

other：DataFrame，或强制转换为 DataFrame 的对象

应该至少有一个与原始 DataFrame 匹配的索引/列标签。如果传递了 Series，则必须设置其 name 属性，并将其用作列名称以与原始 DataFrame 对齐。

join：{‘left’}，默认 ‘left’

只实现了左连接，保留了原始对象的索引和列。

overwrite：布尔值，默认为真

如何处理重叠键的非 NA 值：

True：用 other 中的值覆盖原始 DataFrame 的值。
False：仅更新原始 DataFrame 中为 NA 的值。

filter_func：callable(1d-array) -> bool 1d-array，可选

可以选择替换 NA 以外的值。对于应该更新的值返回 True。

errors：{‘raise’, ‘ignore’}，默认 ‘ignore’

如果 ‘raise’，如果 DataFrame 和 other 在同一位置包含非 NA 数据，则会引发 ValueError。

None：方法直接改变调用对象

抛出：

ValueError

当 errors=’raise’ 并且有重叠的非 NA 数据时。
当errors 既不是‘ignore’ 也不是‘raise’ 时

未实现错误

如果join != ‘left’

例子：

>>> df = pd.DataFrame({'A':[1, 2, 3],
...                    'B':[400, 500, 600]})
>>> new_df = pd.DataFrame({'B':[4, 5, 6],
...                        'C':[7, 8, 9]})
>>> df.update(new_df)
>>> df
   A  B
0  1  4
1  2  5
2  3  6

DataFrame 的长度不会因为更新而增加，只会更新匹配索引/列标签处的值。

>>> df = pd.DataFrame({'A':['a', 'b', 'c'],
...                    'B':['x', 'y', 'z']})
>>> new_df = pd.DataFrame({'B':['d', 'e', 'f', 'g', 'h', 'i']})
>>> df.update(new_df)
>>> df
   A  B
0  a  d
1  b  e
2  c  f

对于 Series，必须设置其 name 属性。

>>> df = pd.DataFrame({'A':['a', 'b', 'c'],
...                    'B':['x', 'y', 'z']})
>>> new_column = pd.Series(['d', 'e'], name='B', index=[0, 2])
>>> df.update(new_column)
>>> df
   A  B
0  a  d
1  b  y
2  c  e
>>> df = pd.DataFrame({'A':['a', 'b', 'c'],
...                    'B':['x', 'y', 'z']})
>>> new_df = pd.DataFrame({'B':['d', 'e']}, index=[1, 2])
>>> df.update(new_df)
>>> df
   A  B
0  a  x
1  b  d
2  c  e

如果 other 包含 NaN，则原始数据帧中的相应值不会更新。

>>> df = pd.DataFrame({'A':[1, 2, 3],
...                    'B':[400, 500, 600]})
>>> new_df = pd.DataFrame({'B':[4, np.nan, 6]})
>>> df.update(new_df)
>>> df
   A      B
0  1    4.0
1  2  500.0
2  3    6.0

相关用法

注：本文由纯净天空筛选整理自pandas.pydata.org大神的英文原创作品 pandas.DataFrame.update。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。

用法:

参数：

返回：

抛出：

例子：