# Vector Round

## Function Prototype

/* Vector Round */
/* Type: simple */
/* Input arrays: 1    Options: 0    Output arrays: 1 */
/* Inputs: real */
/* Options: none */
/* Outputs: round */
int ti_round_start(TI_REAL const *options);
int ti_round(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.

Vector Round returns the closest integer for each element in the input array. Ties are resolved by taking the largest number.

$$round_{t} = \lfloor input_{t} + 0.5 \rfloor$$

## Example Usage

### Calling From C

/* Example usage of Vector Round */
/* Assuming that 'input' is a pre-loaded array of size 'in_size'. */
TI_REAL *inputs[] = {input};
TI_REAL options[] = {}; /* No options */
TI_REAL *outputs[1]; /* round */

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

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

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

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

-- Example usage of Vector Round
round = ti.round(input)

## Example Calculation

dateinputround
2005-11-0181.5982.00
2005-11-0281.0681.00
2005-11-0382.8783.00
2005-11-0483.0083.00
2005-11-0783.6184.00
2005-11-0883.1583.00
2005-11-0982.8483.00
2005-11-1083.9984.00
2005-11-1184.5585.00
2005-11-1484.3684.00
2005-11-1585.5386.00
2005-11-1686.5487.00
2005-11-1786.8987.00
2005-11-1887.7788.00
2005-11-2187.2987.00

## Other Indicators

Previous indicator: Rate of Change Ratio

Next indicator: Relative Strength Index

Random indicator: Standard Error Over Period