CustomMatPlot (CMP) is a plotting library for C++. It provides an API for embedding plot components into applications using the JUCE framework. The plot component is easy to integrate and is customizable using the included lookandfeel class.

• Features
• Requirements
• Controls
• LookAndFeel
• Graph line attributes
• Examples
• Realtime frequency response example
• Tests
• License

CMP implements many of the same features that exist in Matplotlib. Below is the feature list of CMP:

• Axis scaling: Linear and logarithmic.
• Customizable view using the lookandfeel class.
• Legend.
• Zoom.
• Trace.
• Fill area between two graphs.
• Axis labels.
• Ticks and Tick-labels.
• Grids and tiny grids.
• Markers: Star, triangles, square etc.
• Custom stroke path.
• Callback for every visible data point.
• Callback for trace points.
• Two different downsampler levels.
• Move points in the graph with mouse.
• Customizable user input mapping using lookandfeel class.

• Compiler that supports C++17
• CMake 3.12

The CMP component implements MouseEvents to interact with the plot using the mouse. Below is a list of default mouse commands which can be overridden using a custom lookandfeel class (see "move_pixel_points" example):

1. Left-click and drag anywhere in the graph area to zoom into the plot. The zoom area is displayed as a traced rectangle.
2. Right click to zoom out to home.
3. Double-click to add a trace-point to the graph lines closest to the mouse pointer.
4. Double-click on a trace-point to remove it.
5. Drag the trace point to move it along the graph-line.
6. Move the trace point label by dragging it.
7. Move the legend by dragging it.
8. Move pixel points.
9. Panning.

Customize the plot to your liking by overriding the lookandfeel functions. See the lookandfeel example.

Use the graph line attributes to change the appearance of the graph lines. See custom_graph_attributes example.

The examples can be built using the following commands:

# Clone repository
git clone https://github.com/franshej/CustomMatPlot.git

cd CustomMatPlot

# Update submodules
git submodule update --init

mkdir build
cd build

# Config & build
cmake ../ -DCMP_BUILD_EXAMPLES=ON
make -j4

An example app plotting the frequency response of the incoming left and right audio signals can be seen here: Realtime plot example

The juce::UnitTest class is wrapped into macros to make it easier to write new structured tests.

SECTION(PlotTest, "Plot class") {
  cmp::Plot plot;

  TEST("Part 1: empty graph line.") {
    const auto graph_lines = getChildComponentHelper<cmp::GraphLine>(plot);
    expect(graph_lines.empty());
  }

  TEST("Part 2: single graph line") {
    plot.plot({y_data1});
    ...
  }
}

To make it more convenient to write new manual tests, the CMP library implements test macros similar to those in Google tests.

The following example below will plot a ramp of 10 values from 0-9:

TEST(ramp, non_real_time) {
  ADD_PLOT;

  std::vector<float> y_test_data(10u);
  std::iota(y_test_data.begin(), y_test_data.end(), 0.0f);

  PLOT_Y({y_test_data});
}

The MIT License (MIT)

Copyright (c) 2017-2022 Frans Rosencrantz

Free Software, Hell Yeah!