# XTRADE.ROC

**AXCEL.XTRADE.ROC function**

This function is part of XTRADE functions group which is a collection of several technical indicators for creating technical trading rules. XTRADE.ROC calculates the rate of change of a series of positive numbers over n periods. It simplifies the calculation of stock or security returns for both continuous and discrete types.

Disclaimer:

Due to many factors, over which we have no control, performance and/or outcomes may differ substantially from any estimates, projections or predictions that have been made by our services or functions. We use several software and services from sources believed to be reliable, however accuracy and completeness cannot be guaranteed. Loss of all or part of the original capital invested in an investment or investment strategy derived by these functions and/or services may occur. Any investments and/or transactions implied by our services or functions are done at your own risk.

**Syntax**

AXCEL.XTRADE.ROC(stockprice, n, [type], [dateFormat], [plot])

The AXCEL.XTRADE.ROC function syntax has the following arguments:

**stockprice** Required. This is a table of stock price or any other values such as volume. The format must be a table of two columns, the first column for time/date index and the second column is the values. Here is an example:

Date | Price |

08/24/2020 | 120.10 |

08/25/2020 | 121.65 |

08/26/2020 | 119.88 |

… | … |

… | … |

AXCEL.XTRADE.ROC function uses the second column for calculating rate of changes.

**n** Required. Number of periods for calculation of rate of change.

**type** Optional. You can choose between “continuous”, i.e. Ln( P_{i} / P_{i-n} ) and “discrete”, i.e. 1 – ( P_{i} – P_{i-n} ) / P_{i-n} , for calculation of changes. Default is “continuous”.

**dateFormat** Optional. If the date in Date columns is Excel standard date format, you do not need to provide any format, and Axcel will automatically identify the date format and applies the conversion. However, if the date is provided in TEXT format, you should define the date format for appropriate conversion. Here are the elements of the date format:

/ or - : Separators %d: day %m: month %y: 2-digit year (for example 98 or 07) %Y: 4-digit year (for example 1998 or 2007)

Here are some examples of date format:

for "08/22/2019" : "%m/%d/%Y" for "19/08/22" : "%y/%m/%d" for "2019-08-22" : "%Y-%m-%d"

**plot** Optional. The default is FALSE. If you set it TRUE, Axcel provides you an advanced interactive visualization showing security price and rate of changes (ROC).

Here is an example:

when you type =AXCEL.XTRADE.ROC the Intellisense guides you through required and optional (shows in brackets []) entries as shown below:

In this example, we have:

=AXCEL.XTRADE.ROC(A1:B300, 1,,, TRUE)

which means that our data is located at cells from A1 to B300, we set the number of periods for roc calculation at 1 which means that we are looking for daily returns. We skipped the type argument which sets it at the default value of “continuous”. Also, since we use Excel standard date format, we skipped the dateFormat entry and we would like to have visualization by setting the plot to TRUE. Here is the outcome:

As presented above, Axcel generates daily returns and reports them in column *ROC*. Also, the outcome is visualized in the task pane and ready to be expanded in your browser. In this example, since we set n to 1, the first ROC record shows *NA* after execution.

See also: All other *AXCEL.XTRADE* functions.