SwingLow (Function)

The SwingLow function returns the low pivot price where a Swing Low occurred.

Syntax

SwingLow(Instance, Price, Strength, Length)

Returns (Double)

A numeric value containing the low pivot price where 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 bars to be considered.

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 SwingLow. 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 SwingLow.

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

If no SwingLow 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

Assigns to Value1 the most recently occurring Close in over the last 10 bars that has a strength of 4 on both the left and right sides of the swing bar..

Value1 = SwingLow(1,Close,4,10);