Skip to main content

Tools for receiving and interacting with Raspberry Shake UDP data

Project description

Raspberry Shake event logo

rsudp

Continuous sudden motion and visual monitoring of Raspberry Shake data

Written by Ian Nesbitt (@iannesbitt) and Richard Boaz (@ivor)

PyPI PyPI - Downloads GitHub Documentation Build Status Code Coverage Scrutinizer Code Quality JOSS Publication Status

rsudp is a tool for receiving and interacting with data casts from Raspberry Shake personal seismographs and Raspberry Boom pressure transducer instruments.

rsudp has full documentation here. We also have tutorial instructions to install, set up, and run rsudp there. Additionally, our documentation features YouTube walkthroughs, notes for contributors, a brief Developer's guide, and module documentation.

rsudp contains ten main features:

  1. Alert - 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 the alert module signalling an alarm state
  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 alert 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 one or several IP/port destinations
  8. RSAM - computes RSAM (Real-time Seismic AMplitude) and either prints or forwards it to an IP/port destination
  9. Custom - run custom code when an ALARM message is received
  10. 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.

Earthquake plot recorded on a Raspberry Shake 4D

(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).

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

rsudp-1.1.0.tar.gz (475.7 kB view hashes)

Uploaded source

Built Distribution

rsudp-1.1.0-py3-none-any.whl (496.5 kB view hashes)

Uploaded py3

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