ScottPlot.NET
Create a Custom Plot Types - ScottPlot FAQ
By creating a class that implements IPlottable, users can create custom plot types and have full control over styling and data management.

ScottPlot comes with dozens of plot types (bar, scatter, pie, etc.), but users can create their own to customize styling and behavior. ScottPlot uses the term Plottable to describe objects which can be added to plots, store data, and contain logic to draw on the chart.

  • Plottables are classes that implement IPlottable
  • Plottables store data (typically X/Y positions)
  • Plottables have a Render() function that draws data on a Bitmap

Example: Rainbow Plot

Let’s create a simple custom plot type that draws circles at X/Y coordinates using rainbow colors.

using ScottPlot.Plottable;
using ScottPlotTests;
using System;
using System.Drawing;
using System.Linq;

class RainbowPlot : IPlottable
{
    double[] Xs { get; }
    double[] Ys { get; }
    Color[] Colors { get; }

    public RainbowPlot(double[] xs, double[] ys)
    {
        Xs = xs;
        Ys = ys;
        Colors = new Color[Xs.Length];

        // precalculate the color for each data point
        Color[] rainbowColors = { Color.Red, Color.Orange, Color.Yellow,
            Color.Green, Color.Blue, Color.Indigo, Color.Violet };

        for (int i = 0; i < Xs.Length; i++)
            Colors[i] = rainbowColors[i % rainbowColors.Length];
    }

    // Additional properties facilitate advanced customization
    public float Radius { get; set; } = 10;

    // These default values are fine for most cases
    public bool IsVisible { get; set; } = true;
    public int XAxisIndex { get; set; } = 0;
    public int YAxisIndex { get; set; } = 0;
    public void ValidateData(bool deep = false) { }

    // Return an empty array for plottables that do not appear in the legend
    public LegendItem[] GetLegendItems() 
        => Array.Empty<LegendItem>(); 

    // This method returns the bounds of the data
    public AxisLimits GetAxisLimits() =>
        new AxisLimits(Xs.Min(), Xs.Max(), Ys.Min(), Ys.Max());

    // This method describes how to plot the data on the cart.
    public void Render(PlotDimensions dims, System.Drawing.Bitmap bmp, bool lowQuality = false)
    {
        // Use ScottPlot's GDI helper functions to create System.Drawing objects
        using var gfx = ScottPlot.Drawing.GDI.Graphics(bmp, dims, lowQuality);
        using var brush = (SolidBrush)ScottPlot.Drawing.GDI.Brush(Color.Black);

        // Render data by drawing on the Graphics object
        for (int i = 0; i < Xs.Length; i++)
        {
            // Use 'dims' methods to convert between axis coordinates and pixel positions
            float xPixel = dims.GetPixelX(Xs[i]);
            float yPixel = dims.GetPixelY(Ys[i]);

            brush.Color = Colors[i];
            gfx.FillEllipse(brush,
                x: xPixel - Radius,
                y: yPixel - Radius,
                width: Radius * 2,
                height: Radius * 2);
        }
    }
}

Console Demo

Instantiate the custom plottable and add it to a plot:

double[] xs = ScottPlot.Generate.Consecutive(51);
double[] ys = ScottPlot.Generate.Sin(51);
RainbowPlot myPlottable = new(xs, ys);

ScottPlot.Plot plt = new(400, 300);
plt.Add(myPlottable);
plt.SaveFig("plot.png");

WinForms Demo

Instantiate the custom plottable and add it to a plot:

double[] xs = ScottPlot.Generate.Consecutive(51);
double[] ys = ScottPlot.Generate.Sin(51);
RainbowPlot myPlottable = new(xs, ys);

formsPlot1.Plot.Add(myPlottable);
formsPlot1.Refresh();

Learn More by Reviewing Official Plot Types

Learn more about how plottables are commonly constructed by inspecting the code behind the simplest plot types distributed with ScottPlot:

Other interfaces in the ScottPlot.Plottable namespace give plottables extra functionality, such as appearing in the legend, or drag/drop mouse interactivity.

You don’t need to implement any of these additional interfaces to get started, but advanced users will benefit from knowing they exist. The purpose of all interfaces are described by XML comments.