Skip to content

Home

Jump to bottom
Ian Nesbitt edited this page Mar 24, 2020 · 4 revisions
https://raw.githubusercontent.com/raspishake/rsudp/master/docs/_static/logo.png

rsudp

Continuous sudden motion and visual monitoring of Raspberry Shake data
Written by Ian Nesbitt (@iannesbitt) and Richard Boaz (@ivor)
https://img.shields.io/pypi/v/rsudp https://img.shields.io/pypi/dm/rsudp https://img.shields.io/github/license/raspishake/rsudp https://img.shields.io/badge/docs-passed-brightgreen https://scrutinizer-ci.com/g/raspishake/rsudp/badges/build.png?b=master https://scrutinizer-ci.com/g/raspishake/rsudp/badges/quality-score.png?b=master

rsudp is an open source program developed for the community by Raspberry Shake S.A. to actively monitor and plot UDP data cast output from Raspberry Shake instruments. The project's source repository is here.

The project has full documentation here as well as tutorial instructions here. Additionally, our documentation features video walkthroughs, a brief developer's guide, and module documentation.

rsudp contains nine main features:

  1. Alarm - an earthquake/sudden motion alert trigger, complete with a bandpass filter and stream deconvolution capabilities
  2. AlertSound - a thread that plays a MP3 audio file in the event of an alarm
  3. Plot - a live-plotting routine to display data as it arrives on the port, with an option to save plots some time after an alarm
  4. Tweeter - a thread that broadcasts a Twitter message when the alarm module is triggered, and optionally can tweet saved plots from the plot module
  5. Telegrammer - a thread similar to the Tweeter module that sends a Telegram message when an alarm is triggered, which can also broadcast saved images
  6. Writer - a simple miniSEED writer
  7. Forward - forward a data cast to another IP/port destination
  8. Custom - run custom code when an ALARM message is received
  9. Print - a debugging tool to output raw data to the command line

rsudp is written in Python but requires no coding knowledge to run. Simply follow the instructions to install the software, go to your Shake's web front end, configure a UDP datacast to your computer's local IP address, start the software from the command line, and watch the data roll in.

https://raw.githubusercontent.com/raspishake/rsudp/master/docs/_static/4d-event.png

(Above) a plot of an earthquake on the four channels of a Raspberry Shake 4D (EHZ---the geophone channel, and EHE, EHN, and ENZ---the accelerometer east, north, and vertical channels).

Clone this wiki locally