Example 308 GUI Plot

Table of Contents

• Live Demo
• Whole Code

Sometimes, it's not just the current value of a measurement that matters, but also how it changes over time. Examples include temperature trends, stability monitoring, or control system setpoints.

For such cases, a plot is extremely useful, as it allows us to visualize changes over time.
Luckily, creating a plot with Shellminator is easy! Let's walk through the steps.
First, you'll need to include the plot module:

#include "GUI/Shellminator-PlotModule.hpp"

Currently, Shellminator’s plotter is quite simple —it only supports one-dimensional data vectors.
While it may not be as advanced as Matplotlib, it runs on tiny AVR microcontrollers with minimal memory!

// Data points
float plotData[] = { 10, 20, 30, 20, 10, 0, -10, -20, -30, -20 };
 
// Number of points in the data
int plotDataSize = sizeof(plotData) / sizeof(plotData[0]);

It’s a good practice to calculate the number of data points automatically like in the example above.
Now, create a ShellminatorPlot object and pass the data:

// Create a plot object
ShellminatorPlot plot(plotData, plotDataSize, "My Plot");

The plot name can be anything you like—just make sure it describes your data well!
Finally, to show the plot on the screen, just call:

shell.beginScreen(&plot);

Live Demo

Whole Code

/*
 * Created on Aug 10 2020
 *
 * Copyright (c) 2023 - Daniel Hajnal
 * hajnal.daniel96@gmail.com
 * This file is part of the Shellminator project.
 * Modified 2023.05.13
*/
 
#include "Shellminator.hpp"
#include "GUI/Shellminator-PlotModule.hpp"
 
// Create a Shellminator object, and initialize it to use Serial
Shellminator shell( &Serial );
 
// Data points
float plotData[] = { 10, 20, 30, 20, 10, 0, -10, -20, -30, -20 };
 
// Number of points in the data
int plotDataSize = sizeof( plotData ) / sizeof( plotData[ 0 ] );
 
// Create a plot object
ShellminatorPlot plot( plotData, plotDataSize, "My Plot" );
 
 
// System init section.
void setup(){
 
    Serial.begin(115200);
 
    // Clear the terminal
    shell.clear();
 
    Serial.println( "Program Start!" );
 
    shell.begin( "arnold" );
    shell.beginScreen( &plot );
 
}
 
// Infinite loop.
void loop(){
 
    shell.update();
 
}

Previous	Next
GUI List Example	GUI Plot Advanced Example