Debug Plotter

This crate provides a convenient macro to quickly plot variables.

Documentation

For more information on how to use this crate, please take a look at the documentation or the examples.

Usage

An Example

In this example, we quickly want to plot the variables a, b, and c. Optionally, we can name the plot. Plots are saved as a PNG image in the plots directory that is created in the working directory.

fn main() {
    for a in 0usize..10usize {
        let b = (a as f32 / 2.0).sin() * 10.0;
        let c = 5 - (a as i32);

        debug_plotter::plot!(a, b, c where caption = "My Plot");
    }
}

The example above generates a plot named "My Plot" and saves it to 'plots/My_Plot.png`.

Additional Use Cases

The macro takes a list of variables. By default, the value of the variable is mapped to the y axis, and the x axis shows the iteration number.

debug_plotter::plot!(a, b, c);

It is possible to pass a tuple if you want the x axis to be another value instead of the iteration number.

debug_plotter::plot!((x, a), (x, b), (x, c));

It is also possible to rename variables in the legend using the keyword as.

debug_plotter::plot!(a as "Alice", b as "Bob", c as "Charlie");

It is possible to provide additional options for the plot after a where keyword.

debug_plotter::plot!(a, b, c where caption = "My Caption");

The following table lists all available options.

Identifier	Example Value	Description
caption	"caption"	Sets the caption of the plot.
size	(400, 300)	Sets the size of the resulting image or window.
x_desc	"x description"	Sets the description of the x axis.
y_desc	"y description"	Sets the description of the y axis.
path	"/plots/my_plot.jpg"	Defines where the plot is saved.
x_range	0f64..100f64	Defines start and end of the x axis.
y_range	0f64..100f64	Defines start and end of the y axis.
values	1000usize	Defines the maximal number of values that are stored. If the macro is called more times than this number, the oldest value is dropped.
live	true	Enables live mode which opens the plot in a window with live updates. Requires feature live, which is enabled by default.

Debug and Release Mode

The plot! macro generates plots in debug and release mode. If you want to avoid generating plots in release mode, use debug_plot! instead.