dask.dataframe.DataFrame.add
dask.dataframe.DataFrame.add¶
- DataFrame.add(other, axis='columns', level=None, fill_value=None)¶
获取数据框和其他对象的逐元素相加结果（二元运算符 add）。
此文档字符串是从 pandas.core.frame.DataFrame.add 复制而来的。
Dask 版本可能存在一些不一致性。
等同于
dataframe + other，但支持在其中一个输入中用 fill_value 替换缺失数据。反向版本为 radd。在灵活的包装器中（add, sub, mul, div, floordiv, mod, pow），对应于算术运算符：+, -, *, /, //, %, **。
- 参数
- 其他标量, 序列, 系列, 字典或数据框
任何单个或多个元素的数据结构，或类似列表的对象。
- 轴{0 或 ‘index’, 1 或 ‘columns’}
是否按索引 (0 或 ‘index’) 或列 (1 或 ‘columns’) 进行比较。对于 Series 输入，轴与 Series 索引匹配。
- 级别int 或 label
在某一级别上进行广播，匹配传递的 MultiIndex 级别的索引值。
- fill_value浮点数或无，默认无
在计算之前，用此值填充现有的缺失（NaN）值，以及成功对齐DataFrame所需的新元素。如果两个相应DataFrame位置的数据都缺失，结果将为缺失。
- 返回
- DataFrame
算术运算的结果。
参见
DataFrame.add添加数据框。
DataFrame.sub减去 DataFrame。
DataFrame.mul乘以数据框。
DataFrame.div分割数据框（浮点除法）。
DataFrame.truediv分割数据框（浮点除法）。
DataFrame.floordiv分割 DataFrame（整数除法）。
DataFrame.mod计算模数（除法后的余数）。
DataFrame.pow计算指数幂。
注释
不匹配的索引将被联合在一起。
示例
>>> df = pd.DataFrame({'angles': [0, 3, 4], ... 'degrees': [360, 180, 360]}, ... index=['circle', 'triangle', 'rectangle']) >>> df angles degrees circle 0 360 triangle 3 180 rectangle 4 360
添加一个标量运算符版本，返回相同的结果。
>>> df + 1 angles degrees circle 1 361 triangle 4 181 rectangle 5 361
>>> df.add(1) angles degrees circle 1 361 triangle 4 181 rectangle 5 361
除以常数并带有反向版本。
>>> df.div(10) angles degrees circle 0.0 36.0 triangle 0.3 18.0 rectangle 0.4 36.0
>>> df.rdiv(10) angles degrees circle inf 0.027778 triangle 3.333333 0.055556 rectangle 2.500000 0.027778
通过操作符版本按轴减去列表和序列。
>>> df - [1, 2] angles degrees circle -1 358 triangle 2 178 rectangle 3 358
>>> df.sub([1, 2], axis='columns') angles degrees circle -1 358 triangle 2 178 rectangle 3 358
>>> df.sub(pd.Series([1, 1, 1], index=['circle', 'triangle', 'rectangle']), ... axis='index') angles degrees circle -1 359 triangle 2 179 rectangle 3 359
按轴乘以字典。
>>> df.mul({'angles': 0, 'degrees': 2}) angles degrees circle 0 720 triangle 0 360 rectangle 0 720
>>> df.mul({'circle': 0, 'triangle': 2, 'rectangle': 3}, axis='index') angles degrees circle 0 0 triangle 6 360 rectangle 12 1080
使用操作符版本乘以不同形状的DataFrame。
>>> other = pd.DataFrame({'angles': [0, 3, 4]}, ... index=['circle', 'triangle', 'rectangle']) >>> other angles circle 0 triangle 3 rectangle 4
>>> df * other angles degrees circle 0 NaN triangle 9 NaN rectangle 16 NaN
>>> df.mul(other, fill_value=0) angles degrees circle 0 0.0 triangle 9 0.0 rectangle 16 0.0
按级别划分多重索引。
>>> df_multindex = pd.DataFrame({'angles': [0, 3, 4, 4, 5, 6], ... 'degrees': [360, 180, 360, 360, 540, 720]}, ... index=[['A', 'A', 'A', 'B', 'B', 'B'], ... ['circle', 'triangle', 'rectangle', ... 'square', 'pentagon', 'hexagon']]) >>> df_multindex angles degrees A circle 0 360 triangle 3 180 rectangle 4 360 B square 4 360 pentagon 5 540 hexagon 6 720
>>> df.div(df_multindex, level=1, fill_value=0) angles degrees A circle NaN 1.0 triangle 1.0 1.0 rectangle 1.0 1.0 B square 0.0 0.0 pentagon 0.0 0.0 hexagon 0.0 0.0