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.

Files for serial-visualisation, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size serial_visualisation-1.2.0-py3-none-any.whl (8.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size serial-visualisation-1.2.0.tar.gz (7.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page