GitBook: [master] 12 pages modified

Author: risenW

api-reference/dataframe/danfo.dataframe.add.md

@@ -4,21 +4,189 @@ description: 'Get Addition of DataFrame and other, element-wise (binary operator
 
 # DataFrame.add
 
-Equivalent to `dataframe + other`, but with support to substitute a fill\_value for missing data in one of the inputs. With reverse version, radd.
+danfo.DataFrame.**add**\(axis\) \[[source](https://github.com/opensource9ja/danfojs/blob/fe56860b0a303d218d60ba71dee6abf594401556/danfojs/src/core/frame.js#L347)\]
 
-Among flexible wrappers \(add, sub, mul, div, mod, pow\) to arithmetic operators: +, -, \*, /, //, %, \*\*.
+| Parameters | Type | Description | Default |
+| :--- | :--- | :--- | :--- |
+| other | DataFrame, Series, Array or Scalar | Object to modulo with |  |
+| axis | Int | 0 for row, 1 for column | 0 |
 
-**parameter:** {other} DataFrame, Series, Array or Number to add
+**Returns:**
 
-                  **return:** {DataFrame}
+       ****return **DataFrame**
 
+## **Examples**
+
+### Addition of **scalar to** DataFrame:
+
+{% tabs %}
+{% tab title="Node" %}
+```javascript
+const dfd = require("danfojs")
+
+let data = [{"Col1": [10, 45, 56, 10]}, {"Col2": [23, 20, 10, 24]}]
+let df = new dfd.DataFrame(data)
+
+let df_new = df.add(2)
+
+df_new.print()
+```
+{% endtab %}
+
+{% tab title="Browser" %}
+```
+
+```
+{% endtab %}
+{% endtabs %}
+
+{% tabs %}
+{% tab title="Output" %}
+```text
+╔═══╤═══════════════════╤═══════════════════╗
+║   │ Col1              │ Col2              ║
+╟───┼───────────────────┼───────────────────╢
+║ 0 │ 12                │ 25                ║
+╟───┼───────────────────┼───────────────────╢
+║ 1 │ 47                │ 22                ║
+╟───┼───────────────────┼───────────────────╢
+║ 2 │ 58                │ 12                ║
+╟───┼───────────────────┼───────────────────╢
+║ 3 │ 12                │ 26                ║
+╚═══╧═══════════════════╧═══════════════════╝
+```
+{% endtab %}
+{% endtabs %}
+
+### Addition of  **Series to** DataFrame along the column axis:
+
+{% tabs %}
+{% tab title="Node" %}
 ```javascript
-let data = [[0, 2, 4], [360, 180, 360]]
-let df = new DataFrame(data)
-df.add(2)
+const dfd = require("danfojs")
+
+
+let data = [{ "Col1": [1, 4, 5, 1] }, { "Col2": [3, 2, 0, 4] }]
+let df = new dfd.DataFrame(data)
+let sf = new dfd.Series([4, 5])
+
+let df_new = df.add(sf, axis = 1)
+
+df_new.print()
 ```
+{% endtab %}
 
+{% tab title="Browser" %}
+```
 
+```
+{% endtab %}
+{% endtabs %}
+
+{% tabs %}
+{% tab title="Output" %}
+```text
+╔═══╤═══════════════════╤═══════════════════╗
+║   │ Col1              │ Col2              ║
+╟───┼───────────────────┼───────────────────╢
+║ 0 │ 5                 │ 8                 ║
+╟───┼───────────────────┼───────────────────╢
+║ 1 │ 8                 │ 7                 ║
+╟───┼───────────────────┼───────────────────╢
+║ 2 │ 9                 │ 5                 ║
+╟───┼───────────────────┼───────────────────╢
+║ 3 │ 5                 │ 9                 ║
+╚═══╧═══════════════════╧═══════════════════╝
+```
+{% endtab %}
+{% endtabs %}
+
+### Addition of  ****DataFrame to a DataFrame
+
+{% tabs %}
+{% tab title="Node" %}
+```javascript
+const dfd = require("danfojs")
+
+let data = [{"Col1": [1, 4, 5, 0]}, {"Col2": [2, 0, 1, 4]}]
+let data2 = [{"new_col1": [1, 5, 20, 10]}, {"new_Col2": [20, 2, 1, 2]}]
+
+let df = new dfd.DataFrame(data)
+let df2 = new dfd.DataFrame(data2)
+
+let df_new = df.add(df2)
+
+df_new.print()
+
+```
+{% endtab %}
+
+{% tab title="Browser" %}
+```
+
+```
+{% endtab %}
+{% endtabs %}
+
+{% tabs %}
+{% tab title="Output" %}
+```text
+╔═══╤═══════════════════╤═══════════════════╗
+║   │ Col1              │ Col2              ║
+╟───┼───────────────────┼───────────────────╢
+║ 0 │ 2                 │ 22                ║
+╟───┼───────────────────┼───────────────────╢
+║ 1 │ 9                 │ 2                 ║
+╟───┼───────────────────┼───────────────────╢
+║ 2 │ 25                │ 2                 ║
+╟───┼───────────────────┼───────────────────╢
+║ 3 │ 10                │ 6                 ║
+╚═══╧═══════════════════╧═══════════════════╝
+```
+{% endtab %}
+{% endtabs %}
+
+### Addition of ****JavaScript Array to DataFrame
+
+{% tabs %}
+{% tab title="Node" %}
+```javascript
+const dfd = require("danfojs")
+
+let data = [{"Col1": [10, 45, 56, 10]}, {"Col2": [23, 20, 10, 24]}]
+let df = new dfd.DataFrame(data)
+let val = [2,2]
+
+let df_new = df.add(val, axis=1)
+
+df_new.print()
+```
+{% endtab %}
+
+{% tab title="Browser" %}
+```
+
+```
+{% endtab %}
+{% endtabs %}
+
+{% tabs %}
+{% tab title="Output" %}
+```text
+╔═══╤═══════════════════╤═══════════════════╗
+║   │ Col1              │ Col2              ║
+╟───┼───────────────────┼───────────────────╢
+║ 0 │ 12                │ 25                ║
+╟───┼───────────────────┼───────────────────╢
+║ 1 │ 47                │ 22                ║
+╟───┼───────────────────┼───────────────────╢
+║ 2 │ 58                │ 12                ║
+╟───┼───────────────────┼───────────────────╢
+║ 3 │ 12                │ 26                ║
+╚═══╧═══════════════════╧═══════════════════╝
+```
+{% endtab %}
+{% endtabs %}