plot (string name, var value, int type, int color)

plot (string name, vars data, int type, int color)

plotBar (string name, int pos, var label, var value, int type, int color)

plotGraph (string name, var x, var y, int type, int color)

plotData (string name): DATA*

Parameters:

Remarks:

• In [Test] mode the chart is either automatically plotted after the test, or at pressing [Result], dependent on PLOTNOW. In [Trade] mode the chart is plotted every day or in shorter intervals, dependent on PlotPeriod. In [Train] mode charts are not plotted, instead parameter histograms are plotted that show the information ratio and the number of winning and losing trades for each parameter. Histograms and charts can not be plotted at the same time; plotBar overrides plot.
• When LOGFILE is set, the data from the histogram or chart is also stored in a *_plot.csv file in the Log folder for further evaluation with Excel™ or other spreadsheet programs.
• For zooming in a certain date, use either StartDate and EndDate for the whole simulation, or PlotDate and PlotBars for zooming the chart only. For more pixels per chart, set up PlotScale and PlotWidth. For not plotting a chart when [Result] is clicked, set PlotWidth at 0.
• When extra charts are opened with NEW, the order of plot calls determines in which chart the curves are plotted. The order is determined by the first plot call in or after the FIRSTRUN. Subsequent calls can then be in arbitrary order. When plot order matters and plots depend on if(...) conditions, enforce the right order in the first run f.i. with if(is(FIRSTRUN)).  Candles and bands can only be plotted in the main chart.
• If plot is called several times with the same name in the same run cycle, only the last data value is plotted. If a plot command is not called in a run, the plotted curve will have gaps at the skipped bars. This can be used for plotting dotted lines.
• Every plot name on a chart must have the same plot type and color. For plotting a curve in different colors, use alternating curves with the same value and different name. In a histogram, any graph or symbol can have an individual color.
• plotGraph has a limit to the number of elements (lines, symbols) per name. Exceeding the limit causes an Error 038 message. For adding more elements to the chart, use plotGraph with different element names.
• Any plot command is normally linked to the current asset. When multiple assets are traded, only prices, trades, and curves linked to the asset selected with the [Asset] scrollbox are plotted; curves linked to other assets are only plotted when PlotMode got set to PL_ALL. For plotting parameters of different assets together, store them in different variables and then plot all together without calling asset() inbetween. For instance, inside an asset loop you can store them in a var array with one element per asset, then plot all elements of the array after the asset loop. The curves are then visible on the chart when you select the last asset of the loop and click [Result].
• For removing default chart elements such as price candles or equity curves, set their Color to 0.
• Use the color function for setting color ranges.
• For plotting a symbol only at every second bar, use if(Bar%2) plot(...);
• Trade profiles, MAE graphs, seasonal profiles, correlograms or heat maps can be plotted with the functions from the profile library.
• Curves can be plotted even without a run function - f.i. for HFT simulation - when the bars are increased by priceQuote. Make sure that the plot function is then called at every bar for avoiding gaps in the curve.

Examples:

// Compare price distribution (red) with random distribution (blue)
function run()
{
  vars Price = series(price(0));
  int num = NumRiseFall(Price,20);
  plotBar("Price",2*num,num,1,SUM|BARS,RED);	

  vars Random = series(0);
  Random[0] = Random[1] + random();
  num = NumRiseFall(Random,20);
  plotBar("Random",2*num+1,0,1,SUM|BARS,BLUE);	
}

// plotGraph test
function run()
{
  set(PLOTNOW);
// plot green dots above the price at every 20th bar
  if(Bar%20 == 0)
    plot("Dotted",1.01*price(),DOT,GREEN);
 
  if(Bar == 500) {
// plot a single blue rectangle in the price chart 
    plotGraph("Rectangle",0,0.99*price(),LINE,BLUE);     // start point
    plotGraph("Rectangle",-500,0.99*price(),LINE,BLUE);  // 1st corner
    plotGraph("Rectangle",-500,1.01*price(),LINE,BLUE);  // 2nd corner
    plotGraph("Rectangle",0,1.01*price(),LINE,BLUE);     // 3rd corner
    plotGraph("Rectangle",0,0.99*price(),LINE|END,BLUE); // 4th corner and end point
 
// plot a single red dot
    plotGraph("Single Dot",-250,price(),DOT,RED);
  } 
}

// Plotting a histogram bar
void plotHistogram(string Name,var Value,var Step,int Color)
{
  var Bin = floor(Value/Step);
  plotBar(Name,Bucket,Step*Bin,1,SUM+BARS+LBL2,Color);
}

See also: