Bars Since Highest (Variable Length) [BarsSinceHighVL]

Return to Complete List of Functions

The Bars Since Highest (Variable Length) function determines the number of bars since the highest value in a data series occured within a variable period. Parameters ------------------ Data          The data to evaluate. This is typically a field in a data series or a calculated value. Period        The number of bars of data to analyze for the condition, including the current value.                   For example, a period of 3 includes the current value and the two previous values. Maximum Period   The maximum value that Period can contain.                              Larger values require extra memory to be set aside for this function to be calculated. Note: An end point to the Period parameter can be simulated using the Lag function to obtain a previous value of this function. See the notes for the Lag function for more information. Function Value ------------------------ This function determines the number of bars ago when the highest value in a data series within a given period most recently occured. If the data series does not have enough data to fill the period or it contains a null during the period, a null is returned. If the period is greater than the maximum period or negative, the value is not defined. If the period contains a fractional number, only the integer portion will be used. Usage ----------- Variable length functions can be used in association with other calculations, such as "Bars Since" functions, to determine values since an event occurred. For example, the following formula would return the number of bars since the highest high after the lowest low in the last ten bars: BarsSinceHighVL ( High, Add ( BarsSinceLow ( Low, 10 ) , 1 ) , 10)