SwingHighBar (Function)

The SwingHighBar function returns the number of bars ago a Swing High bar occurred.

Syntax

SwingHighBar(Instance, Price, Strength, Length)

Returns (Integer)

A numeric value containing the number of bars ago the specified Swing High occurred, or -1 if not found.

Parameters

Name	Type	Description
Instance	Numeric	Sets which occurrence (that is, 1 = most recent, 2 = 2nd most recent, and so on) to return.
Price	Numeric	Specifies which bar value (price, function, or formula) to use.
Strength	Numeric	Sets the required number of bars on either side of the swing bar.
Length	Numeric	Sets the number of trailing bars to consider.

Remarks

A Swing High occurs when the Price of a bar is at least as high as the same Price on the preceding bar(s), and higher than the same Price on the bar(s) that follow it.

The input Strength is the number of bars on each side of the SwingHighBar. A strength of one indicates that the value returned by the input Price must be greater than or equal to the same value returned for the bar on its left and greater than the bar on its right.

The input Length refers to the number of bars being examined for the SwingHighBar.

The input Instance refers to which SwingHighBar you want to use. For example, if in a twenty-one bar period three swing highs were found, it becomes necessary to specify which SwingHighBar is desired. If the most recent SwingHighBar is desired, a one (1) would be substituted for the input Instance.

If no SwingHighBar is found in the period (Length) specified, the function will return a minus one (-1). The value of the input Length must exceed Strength by at least one. In addition, the Maximum number of bars referenced by a study (known as MaxBarsBack) must be greater than the sum of the values of Strength and Length.

Example

Plots the number of bars ago that the most recent swing bar high occurred based on the Close with 3 bars on either side of the swing within 10 trailing bars.

Plot1(SwingHighBar(1,Close,3,10);