README.md

# Why not just get your plots in numpy?!

Why not just have a simple plot1(values,size,title, scatter=True, pt_color, ...) -> np.ndarray

function API which gives your plot (figures, grid, axis,labels if needed) in any way you tell it to?

And then you take that and overlay, mask, stretch, transform and render at wherever in frame array/canvas/memory you need?

Here I took this concept implementation and stuck it on running mug neural network in 3 lines of code to mess with the detector in physical world (try in examples/mug_objectron/demo.py):

                jplt.plot1_at(image, ang_zs,
                            title='Angle from Z axis', offset=(50,50), size=(270, 300),
                            point_color=(255,0,0),line_color=(255,0,0), label_color=(255,0,0), grid_color=(126,126,126))
                jplt.plot1_at(image, ang_ys,
                              title='Angle from Y axis', offset=(400,50), size=(270, 300),
                              point_color=(0,255,0), line_color=(0,255,0),label_color=(0,255,0), grid_color=(126,126,126),
                              scatter=False)
                jplt.plot1_at(image,ang_xs,
                              title='Angle from X axis', offset=(750,50), size=(270, 300),
                              point_color=(0,0,255), line_color=(0,0,255),label_color=(0,0,255), grid_color=(126,126,126),
                              scatter=False)

It measured at 20-100x performance of matplotlib.

timer "full justpyplot + rendering": avg 382 µs ± 135 µs, max 962 µs

Because I did the plotting in native, vectorized way which is an interesting problems topic in itself and This turned out to be a concept of the real-time, vectorized plotting library which allows you to control controlling every basic part of your graph/plot parts you may need - including the opacity;

It showed useful in robotics and in general if you want to take control of your plot rendering/recording in your own hands for grab your plots directly for overlaying, GIFing visual debugging, tweaking, streaming, etc; It allows direct control and access img masks of 4 elemental properties of plot: figures, grid, axis and labels

WHY USE IT

Python Plotting status quo: matplotlib (and its copys) need 3 to 6 steps hoopla to get your plot's figures, grid, axis and labels in easy tensor/array format (such as simple ndarray)

The status quo basically requires you to screenshot in memory and buffer plot bytes back to pixel/img tensor. That makes you suffer multimillisecond performance hit every single frame

Obviously it's very unpleasant.
Having plot frames you can do tweaking/publishing/rendering/GIFing etc.. yourself and, importantly for computer vision, it's too much a performance looser for real-time aspect of what you plot, such as physical/robotic testing and debugging, physical/manual manipulation of CV/camera/mechanical setup.

Also: it is a hermetic python plotlib rewrite - it doesn't suffer from other matplotlib vices.
Also: this code is an instance of plotting/rendering done in vectorized way which is important in ML/AI industry - the plot workflow can be directly embedded in visual neural networks

It's useful in robotics where you have a physical feedback loop based on the dependency you're plotting when you manipulating it by hand such as steering the drone. It can be very useful for real-time plotting, visual debugging for camera/computer vision applications and generally as composable rewrite if a python plotting lib.

Feel free to contribute/take over at this point.

INSTALATION

You can copy justpyplot.py file code respecting the license; For use in Jupyter notebooks its convienent to:

pip install justpyplot

BASIC USAGE

You can explore the documentation for the justplot function currently, options probably support any flexing or adjusting the plot as you need such as colors, scatter, connected with line thickness, labels, etc

You just pass one or two arrays signifying dependency and pass it to the justplot. You can plot on exiting image frame at specified offset by plot1_at, plot2_at function or directly generate plot mask, you can completely control opacity of every element as well as every graphical or textual parameter of the plot.

import numpy as np 
import cv2
import time
from justpyplot import justpyplot as jplt

t0=time.perf_counter()
xs, ys = [], []
while(cv2.waitKey(1) != 27):
    xt = time.perf_counter() - t0
    yx = np.sin(xt)
    xs.append(xt)
    ys.append(yx)
    
    vals = np.array(ys)
    plotted_array = jplt.plot1(vals,title="sin() from Clock")
    
    cv2.imshow('np array plot', plotted_array)