profile.c  price, trade, correlation, and seasonal analysis
The profile.c library contains functions for generating price or trade profiles, MAE charts, or seasonal analysis charts in [Test] mode. The functions are normally used during strategy development for analyzing trade profits or for finding seasonal effects. They can also be used as templates for building userspecific profile charts.
plotPriceProfile (int bars, int type)
Generates a price difference profile starting at the current bar.
This function is normally called by a trade signal for checking its predictive
power. It produces a histogram of
the mean price movement following the signal. The red bars in the histogram are the averaged
mean price difference to the
entry point in pips, the blue/grey bars are their standard deviations, divided by 4 for better scaling.
Price difference profile at entering a trade with the workshop 4 system. Note the small adverse excursion after 24 hours.
Parameters:
bars 
Number of bars to plot in the price profile.. 
type 
Type of the plot.
0 = plot price difference in pips to the first bar.
1 = plot price change in pips from the previous bar.
2 = plot negative price difference to the first bar (for short trades).
3 = plot negative price change from the previous bar. 
plotTradeProfile (int bars)
Generates a profit distribution chart after the test run. The distribution shows the frequency of trades dependent on their profit or loss. The blue bars in the chart are the number of trades (right y axis), the red bars are the sum of their returns in pips (left y axis). The x axis is the trade profit or loss in pips. The example chart below shows a system with about 100 trades that hit their profit target at 100 pips, and about 30 trades that hit their stop at 100 pips loss. Inbetween there's a distibution of trades with mostly small losses. Note that the shown profit/loss is not exactly 100 pips due to spread and slippage.
Profit distribution of a system with Stop and TakeProfit distances both at 100 pips.
Parameters:
bars > 0 
Number of bars to plot in the profit distribution. The more bars, the finer the resolution. 
bars < 0 
Step width of the profit distribution in pips per bar. The smaller the step width, the finer the resolution. 
plotMAEGraph (int bars)
plotMAEPercentGraph (int bars)
plotMFEGraph (int bars)
plotMFEPercentGraph (int bars)
Generates a Maximum Adverse Excursion / Maximum Favorable Excursion graph after the test run. The Maximum Adverse Excursion
(MAE) is the worst drawdown of an individual trade, the difference of its highest interim profit to its worst interim loss.
The Maximum Favorable Excursion (MFE) is the opposite. The graph displays any trade as a dot in a chart showing its MAE
or MFE on the x axis and its profit on the y axis in pip units or in percent of
the price. Winning trades are green, losing trades are red. This graph can be used for analyzing the exit behavior of the trades and finding the optimal stop or take profit distances.
MAE graph of the Workshop 5 system.
Parameters:
bars > 0 
Number of bars to plot. The more bars, the finer the resolution. 
bars < 0 
Step width of the MAE distribution in pips per bar. The smaller the step width, the finer the resolution. 
plotDay (var value, int type)
plotWeek (var value, int type)
plotMonth (var value, int type)
plotYear (var value, int type)
Seasonal analysis; generates a day, week, month or year distribution of a given value in a histogram (see also seasonal strength). This way seasonal effects of a trading system, a variable, or a price curve can be found. The red bars in the chart are the average value at a certain hour or day, the blue bars are their standard deviations divided by 4 for better scaling.
Week statistics with hourly returns of the workshop 4 EUR/USD system. Note the seasonal oscillation of the standard deviation  a price curve effect known as heteroskedasticity.
plotWFOCycle (var value, int type)
Analyzes the development of the value over a WFO cycle (x axis = trading days since cycle start). Can be used to determine if the profit deteriorates towards the end of the cycle, thus suggesting shorter cycles.
Parameters:
value 
Value to be evaluated, for instance price(0) or Equity. 
type 
0 = evaluate value difference to the season begin.
1 = evaluate value difference to the previous bar.

plotDayProfit ()
plotWeekProfit ()
plotMonthProfit ()
plotQuarterProfit ()
plotWFOProfit ()
Plots bars equivalent to the gain or loss of the previous day, week, month, quarter, or WFO cycle in a new window in the price chart (thus, clicking [Result] is required). The blue bars are the profit in units of the account currency, the red bars are the loss.
Since the bars represent the previous period, they are shifted by one period.
Quarterly profit/loss of the Workshop 4 EUR/USD system.
plotCorrelogram(var Value, int Lag)
plotCorrelogram(var Value1, var Value2, int Lag)
Generates in the EXITRUN a histogram of the correlation of a variable with itself, or with another variable, for sequential values of lag.
On random data, such autocorrelations should be near zero for all time lags. But if the data is nonrandom, one or more of the autocorrelations will be significantly nonzero.
The above correlogram displays a significant correlation (0.14) of the variable with its value from the previous bar. The correllations with earlier bars (2...49) are not as significant.
Parameters:
Value1 
First variable to be evaluated, for instance price(0)price(1). 
Value2 
Second variable to be evaluated. 
Lag 
Maximum autocorrelation lag.

plotHistogram(string Name, var Val, var Step, var Weight, int Color)
Helper function that plots a single histogram bar. Bars belonging to the same
step range are accumulated.
Parameters:
Name 
Name of the histogram. 
Val 
X axis label of the bar to be plotted. 
Step 
Distance in Val units between two bars on the x axis. 
Weight 
Weight, to be added to the accumulated height of the bar. Negative
weights plot downwards bars.

Color 
Color of the histogram bars. 1 for plotting labels at all gaps on the x axis. 
plotHeatmap(string name, var* Data, int Rows, int Cols)
plotHeatmap(string name, mat Matrix)
Plots a heatmap in the EXITRUN from the given Matrix
or the Data array of size Rows*Cols, f.i. a correlation matrix. The matrix elements must be in the 0..1 range, and are displayed as squares with a color range from blue (0) to red (1).
Since the heatmap is simulated with colored dots, you might need to scale the
chart before exporting so
that it looks nice. A different type of heatmap  a contour chart  can be
plotted with the dataChart function.
Parameters:
Data 
Pointer of a var array with Rows *
Cols elements. 
Rows, Cols 
Array size. 
Remarks:
 All profile functions are contained in source code in include\profile.c, and can be used as templates for writing other chart plotting or analysis functions of any kind.
 For adding the profile functions, the line #include <profile.c> must be added at the begin of the script.
 Price profile or distribution histograms should
normally only be plotted for a single asset and algorithm, since every market and every system will generate a different profile. In a portfolio strategy, temporarily disable the other assets and algos for plotting a profile of a component.
 Only one histogram can be plotted, not several at the same time; unused plot commands must be commented out for not interfering with the active chart.
Histograms are only plotted in [Test] mode, not in [Train] and [Trade] mode.
 The size and resolution of the histogram can be set up with the plot parameters.
Label spacing at the x axis can be set up with PlotLabels.
 Week, month, and year analysis is based on trading days, not calendar days. Therefore the week has 5 days, the month 22 days, and the year 252 days. Due to the different number of trading days (20..23) in a month, they are normalized to 22, so day 22 is always the last trading day of the month.
 The standard deviations (blue bars in the chart) show how much the values differ from their average, and thus indicate the significance of a nonzero average. The smaller the blue bar and the bigger the red bar, the more significant is the seasonal effect. In the case of prices or returns, the standard deviation is a measure of volatility.
 When developing a strategy, it is helpful to examine the price difference profile at every trade entry bar for verifying the trade entry rules and for determining the trade exit rules.
Examples:
#include <profile.c>
// Price difference profile
function run()
{
vars Trend = series(LowPass(series(price()),500));
if(valley(Trend)) {
plotPriceProfile(40,0);
enterLong();
} else if(peak(Trend)) {
plotPriceProfile(40,2);
enterShort();
}
}
#include <profile.c>
// Trade distribution or quarterly profit/loss
function run()
{
vars Trend = series(LowPass(series(price()),500));
Stop = 100*PIP;
TakeProfit = 100*PIP;
if(valley(Trend))
enterLong();
else if(peak(Trend))
enterShort();
PlotHeight1 = 320;
PlotScale = 4;
plotTradeProfile(50);
}
#include <profile.c>
// Weekly return analysis or quarterly profit/loss
function run()
{
vars Trend = series(LowPass(series(price()),500));
if(valley(Trend))
enterLong();
else if(peak(Trend))
enterShort();
PlotHeight1 = 320;
PlotScale = 3;
set(PLOTNOW);
plotWeek(Equity,1);
//plotQuarterProfit();
}
#include <profile.c>
// Correlogram of HightoHigh differences of selected asset
function run()
{
PlotHeight1 = 320;
PlotScale = 10;
plotCorrelogram(priceHigh(0)priceHigh(1),50);
}
#define DAYS 252 // 1 year
#define NN 30 // max number of assets
#include <profile.c>
// plot a heatmap of asset correlations
function run()
{
BarPeriod = 1440;
StartDate = NOW;
LookBack = DAYS;
vars Returns[NN];
var Correlations[NN][NN]; // NN*NN matrix
int N=0;
while(asset(loop("USD/CAD","EUR/USD","GBP/USD","USD/JPY")))
Returns[N++] = series(RET(1));
int i,j;
if(is(EXITRUN)) {
for(i=0; i<N; i++)
for(j=0; j<N; j++)
Correlations[N*i+j] = Correlation(Returns[i],Returns[j],DAYS);
plotHeatmap("Correlation",Correlations,N,N);
}
}
See also:
plot, plot parameters, colors, season
► latest version online