DataProfile

DataProfile ( iDataHolder data , double pricePerRow , iDataHolder startNewProfile , int onExpansion , int numberOfProfiles , double value area percent );

Default values:

Description

The DataProfile function plots an activity profile for any given input variable such as study or function. The activity profile is essentially a horizontal diagram that gives insight into which values are most often reached by the input variable.

The histogram is calculated based on the following algorithm:

1. The system finds the value range of the variable.
2. This value range is broken into intervals. This process can be automatic (the range is broken into 85 equal parts), ticksize-based (each interval's length is equal to the minimum value movement), and manual (interval length is specified by user). The interval length defines the height of each histogram row.
3. The system calculates the number of times the variable value has reached each of the intervals.
4. Each histogram row then has a length proportional to the corresponding number calculated in Step 3. 

Here is how you can read the DataProfile histogram:

• The longest row represents the value most often reached by the input variable. It is also called Point Of Control.
• The range surrounding the Point Of Control where 70% of the value movements took place is called Value Area and represents frequent values. The mentioned percentage is the default and can be modified using input parameters.

Input Parameters

Example

declare lower;



def rsi = reference RSI();

def condition = GetYear() != GetYear()[1];



profile CustomProfile = DataProfile(data = rsi, onExpansion = no, startNewProfile = condition);

CustomProfile.Show();



plot POC = CustomProfile.GetPointOfControl();

The above code displays yearly data profiles of RSI and their Points Of Control as a plot.