A low-requirement jupyter notebook designed to read and plot RaspberryShake UDP packets in real time
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
LICENSE
README.md
img.gif
shake_udp_live.ipynb

README.md

shake-UDP-live

A jupyter notebook designed to read and plot RaspberryShake UDP packets in real time

Example Plot

Disclaimer about script performance

This program is fairly processor-intensive, owing primarily to the large number of Fourier Transform calculations happening on each loop, and the fact that I'm not practiced at finding efficiencies in scripts. I haven't tested it on machines other than my own, but can envision people running into reduced performance problems in some cases. Even on my workstation the best I can do seems to be about 3.9 frames per second.

It may help to run this program without anything else open. (If you're on a Mac, this means actually quitting each open program in your dock, not just closing open windows.) You can speed up the program significantly by decreasing the number of seconds of data to display (i.e. 30 instead of 60). Inevitably you may end up with dropped packets simply because your processor can't keep up with the data rate.

If performance is an issue for you, please email me at ian dot nesbitt at gmail dot com and I will send you a less resource-hungry version (without the spectrogram). If you can find ways to make these calculations more efficient, please contribute to this project!

Installing

  1. You will find the first steps to being able to run this program in the RaspberryShake documentation regarding UDP. Please refer there, then come back to this page. If you've already forwarded your UDP output to the machine you will run this script on, see step 2. If you've tried this and still need help, please feel free to post a question on the community forum. I personally forwarded data from a remote RaspberryShake to port 18002 on my workstation, which is how the script is set up currently.

  2. The next step is to install Anaconda. Depending on your level of comfort with the command line, this may or may not be a trivial task. There's a lot of stuff on Google about this, so I won't post anything here.

  3. Once you have Anaconda installed, download this repository. In a command prompt, type

git clone https://github.com/iannesbitt/shake-UDP-live

This command will cause Git to create a folder and download the contents of this repository into it.

  1. Now go to a command prompt and type jupyter-notebook. A browser window will open. Using the Jupyter browser, navigate to the location on your computer where you downloaded this repository and open the file named shake_udp_live.ipynb. Change the port variable to reflect the local port number to which your Shake is sending data. Then, click on the "Cell" menu and click on "Run All".

  2. Enjoy beautiful live data!