## Function Prototype

```
/* Exponential Moving Average */
/* Type: overlay */
/* Input arrays: 1 Options: 1 Output arrays: 1 */
/* Inputs: real */
/* Options: period */
/* Outputs: ema */
int ti_ema_start(TI_REAL const *options);
int ti_ema(int size,
TI_REAL const *const *inputs,
TI_REAL const *options,
TI_REAL *const *outputs);
```

## Description

This documentation is still a work in progress. It has omissions, and it probably has errors too. If you see any issues, or have any general feedback, please get in touch.

The exponential moving average, or exponential smoothing function, works by calculating each bar as a portion of the current input and a portion of the previous exponential moving average.

It takes one parameter, the period `n`

, a positive integer. Larger values for
`n`

will have a greater smoothing effect on the input data but will also create
more lag.

First a scaling factor, `a`

, is calculated:

This will satisfy the relation:

Then the exponential moving average is calculated for each bar as:

The calculation is started by simply setting the first `ema`

output to the first input.

## See Also

- Double Exponential Moving Average
- Simple Moving Average
- Triple Exponential Moving Average
- Wilders Smoothing

## References

- Kaufman, Perry J. (2013) Trading Systems and Methods
- Murphy, J. (1999) Technical Analysis of the Financial Markets
- Achelis, S. (2000) Technical Analysis from A to Z, 2nd Edition
- Wikipedia: Exponential Smoothing

## Example Usage

### Calling From C

```
/* Example usage of Exponential Moving Average */
/* Assuming that 'input' is a pre-loaded array of size 'in_size'. */
TI_REAL *inputs[] = {input};
TI_REAL options[] = {5}; /* period */
TI_REAL *outputs[1]; /* ema */
/* Determine how large the output size is for our options. */
const int out_size = in_size - ti_ema_start(options);
/* Allocate memory for output. */
outputs[0] = malloc(sizeof(TI_REAL) * out_size); assert(outputs[0] != 0); /* ema */
/* Run the actual calculation. */
const int ret = ti_ema(in_size, inputs, options, outputs);
assert(ret == TI_OKAY);
```

### Calling From Lua (with Tulip Chart bindings)

```
-- Example usage of Exponential Moving Average
ema = ti.ema(input, 5)
```

## Example Calculation

period = 5

date | input | ema |
---|---|---|

2005-11-01 | 81.59 | 81.59 |

2005-11-02 | 81.06 | 81.41 |

2005-11-03 | 82.87 | 81.90 |

2005-11-04 | 83.00 | 82.27 |

2005-11-07 | 83.61 | 82.71 |

2005-11-08 | 83.15 | 82.86 |

2005-11-09 | 82.84 | 82.85 |

2005-11-10 | 83.99 | 83.23 |

2005-11-11 | 84.55 | 83.67 |

2005-11-14 | 84.36 | 83.90 |

2005-11-15 | 85.53 | 84.44 |

2005-11-16 | 86.54 | 85.14 |

2005-11-17 | 86.89 | 85.73 |

2005-11-18 | 87.77 | 86.41 |

2005-11-21 | 87.29 | 86.70 |

## Chart

## Other Indicators

Previous indicator: Exponential Decay

Next indicator: Ease of Movement

Random indicator: Mesa Sine Wave