# Rate of Change Ratio

## Function Prototype

/* Rate of Change Ratio */
/* Type: indicator */
/* Input arrays: 1    Options: 1    Output arrays: 1 */
/* Inputs: real */
/* Options: period */
/* Outputs: rocr */
int ti_rocr_start(TI_REAL const *options);
int ti_rocr(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 Rate of Change Ratio indicator calculates the change between the current price and the price n bars ago.

It takes one parameter, the period n.

The calculation is as follows:

$$rocr_{t} = \frac{in_{t}}{in_{t-n}}$$

## Example Usage

### Calling From C

/* Example usage of Rate of Change Ratio */
/* 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]; /* rocr */

/* Determine how large the output size is for our options. */
const int out_size = in_size - ti_rocr_start(options);

/* Allocate memory for output. */
outputs[0] = malloc(sizeof(TI_REAL) * out_size); assert(outputs[0] != 0); /* rocr */

/* Run the actual calculation. */
const int ret = ti_rocr(in_size, inputs, options, outputs);
assert(ret == TI_OKAY);


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

-- Example usage of Rate of Change Ratio
rocr = ti.rocr(input, 5)


## Example Calculation

period = 5

dateinputrocr
2005-11-0181.59
2005-11-0281.06
2005-11-0382.87
2005-11-0483.00
2005-11-0783.61
2005-11-0883.151.02
2005-11-0982.841.02
2005-11-1083.991.01
2005-11-1184.551.02
2005-11-1484.361.01
2005-11-1585.531.03
2005-11-1686.541.05
2005-11-1786.891.04
2005-11-1887.771.04
2005-11-2187.291.04

## Other Indicators

Previous indicator: Rate of Change

Next indicator: Vector Round

Random indicator: Chande Momentum Oscillator