Skip to main content

A package for visualisation of serial data in a grid.

Project description


For simple visualisation of serial input (e.g. from an Arduino or similar device).

Version: 1.2.0
Author: ES Alexander
Release Date: 12/Dec/2019

You need to know:

Allows the reading of serial input to a computer, and display of it in a grid as an image. The displayed grid can be optionally blurred for sub-pixel resolution, and can also be formatted with a fully-customisable RGB or greyscale colourmap. The displayed grid can be saved to a constant-framerate video.

Each set of serial values should be separated by a newline character ('\n'), and values within a set should be tab-separated ('\t').

To run:

  1. download and install Python 3 if not already installed (select add to PATH)
  2. windows users: open command prompt (e.g. press windows key, type cmd, press enter), Mac users: open terminal
  3. type pip install --upgrade serial-visualisation (only have to do this once at the start of your session, and probably only once per computer) - this step may cause issues if python and/or pip are not in your PATH. Google 'add pip to path' for a solution. Users with multiple Python installs may need to use pip3 instead of pip.
  4. make sure your Arduino software on the computer isn't using the serial port (only one program can access it at once, so program the Arduino normally, and then just don't open the serial plotter or monitor, and run this instead)
  5. run using python -m serial_grid.serial_grid (or python3 with multiple Python installs)
  6. answer the questions, and optionally save your settings
  7. wait for it to start displaying (takes a few seconds it seems)
  8. click the Data window and press 'q' or 'Q' or Escape to quit, or press 'p' (play/pause), 'c' (continue), or 's' (start/stop) to pause and/or resume the display (they're all the same, just pick your preferred key).

I hope this works well for your project! If there are any problems, or suggestions for improvement, please submit an Issue on the github page (

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

serial-visualisation-1.2.0.tar.gz (7.3 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page