This repository contains two python scripts that can take .csv exports from PingPlotter and graph them using the Plotly graphing library.
To run this script, simply run python3 gui.py
and select the PingPlotter .csv export you want to graph.
Note: The free version of PingPlotter does not support .csv exports, but there is a free 14 day trial of PingPlotter Premium when you first install the application.
Before running the script, there are two things you must do to setup the script; installing the Python package dependencies and exporting your PingPlotter capture into a .csv file.
This is a rather easy step to do but can require some extra steps if you are on a non-Windows OS.
For Windows, simply run python3 -m pip install -r requirements.txt -U
to install/upgrade all the packages this script uses.
For MacOS (which is only supported by PingPlotter Professional & Cloud), first browse to this page and look if you have a new enough version of Python that HAS BEEN DOWNLOADED FROM PYTHON.ORG. The Apple supplied version of Python seems to be generally buggy with tkinter applications. After ensuring that you have a version of Python that works with tkinter, run python3 -m pip install -r requirements.txt -U
.
For Linux (which is only supported by PingPlotter Cloud), first run sudo apt install python3-tk
to install the tk GUI dependencies. After that finishes installing, run python3 -m pip install -r requirements.txt -U
.
You can check to make sure that tkinter is working properly by running python3 -m tkinter
. If a small window appears letting you know what version you have installed, then tkinter is working properly.
As I said earlier, the free version of PingPlotter does not support .csv exports. However, there is a free 14 day trial of PingPlotter Premium when you first install the application.
After capturing whatever ping data you want, first navigate to File | Export to Text File...
Then select either Local time zone or UTC time zone for the time format. You CANNOT select Don't include times for the time format as the x-axis of the graph uses these times. For Samples to Export, you can select either All Samples or whatever range you have currently in focus. Lastly and most important, for the Export Format select 1 column per hop, 1 per sample (data table is long). This script will not work with the other export format.
After all of this has been done, you should be able to run python3 gui.py
which should open a file selection window for you to select your .csv export.