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.
Note: I'm not a senior developer so there may be several design flaws.
- 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 tace points.
- Two different downsampler levels.
- Move points in the garph with mouse.
- Customizable userinput mapping using lookandfeel class.
- Compiler that supports C++17
- CMake 3.12
The CMP compontent implements MouseEvents to interact with the plot using the mouse. Below is a list with the default added mouse commands which can be overrided using a custom lookandfeel class (see "move_graph_points" example):
- Left click drag anywhere in the graph area to zoom into the plot. The zoom area is displayed as traced lined rectangle.
- Right click to zoom out to home.
- Double-click to add a trace-point to the graph lines closest to the mouse pointer.
- Double-click on a trace-point to remove it.
- Drag the trace point to move it along the graph-line.
- Move the trace point label by dragging it.
- Move the legend to by dragging it.
- Move graph points.
- Panning for linear scaling
- #TODO: Panning for logarithmic scaling
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
To make it more convenient to write new tests the CMP library implements tests macros similar to the macros 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!