ExtremesFC (Function)

$image\trumpet2.gif$ Disclaimer

The ExtremesFC (Fast Calculation) series function returns the extreme highest or lowest value over a range of bars and how many bars ago the extreme value occurred. There may be times when more two or more bars have the exact same extreme highest or lowest value; when this happens the function identifies the most recent occurrence.

Syntax

ExtremesFC(Price,Length,HiLo,oExtremeVal,oExtremeBar)

Returns (Integer)

The oExtremeVal and oExtremeBar output parameters return the extreme value and the number of bars ago it occurred. The ExtremesFC function itself returns a value of 1.

Parameters

Name	Type	Description
Price	Numeric	Specifies which bar value (price, function, or formula) to compare for highest and lowest extremes.
Length	Numeric	Sets the number of bars to consider for extremes.
HiLo	Numeric	Sets whether the function will return the highest or lowest extreme value. 1=Highest, -1=Lowest.
oExtremeVal	Numeric	Outputs the highest or lowest extreme value found for the range of bars based on the HiLo setting.
oExtremeBar	Numeric	Outputs the number of bars ago the extreme value occurred.

Remarks

The input parameter Price can be a bar value such as Close, High, Low, Open, or Volume. It can also be any mathematical calculation such as: ( High + Low) / 2, or a numeric function such as RSI, Stochastic, or ADX.

See Multiple Output Function for more information on using output parameters to return values.

This series function returns exactly the same values as Extremes except that it uses a fast calculation method that takes slightly more memory than the non-FC version.

Example

Assigns to Value2 the highest High of the last 20 bars using the oExtremeVal output parameter, and assigns to Value3 the number of bars ago the highest High occurred using oExtremeBar output parameter. Value1 is assigned a value of 1:

vars: oExtremeVal(0), oExtremeBar(0);

Value1 = ExtremesFC(High, 20, 1, oExtremeVal, oExtremeBar);

Value2 = oExtremeVal;