SwingLowBar (Function)

The SwingLowBar function returns the number of bars ago a Swing Low bar occurred.

Syntax

SwingLowBar(Instance, Price, Strength, Length)

Returns (Integer)

A numeric value containing the number of bars ago the specified Swing Low 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 Low occurs when the Price of a bar is at least as Low as the same Price on the preceding bar(s), and Lower than the same Price on the bar(s) that follow it.

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

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

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

If no SwingLowBar 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 low occurred based on the Close with 3 bars on either side of the swing within 10 trailing bars.

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