How to visualize the waveforms

Programs that run on your Raspberry Shake

Helicorder web plot

http://raspberryshake.local/heli

The helicorder plot is a web-based application native to your Raspberry Shake that displays 12 hours of data at a time like this:

_images/R52CB_SHZ_AM_00.2017041400.gif

After boot up, give the helicorder plotting program ~15 minutes to plot the first trace. The helicorder plotting program is configured to update every 2 minutes. GIF images are saved to:

/opt/data/gifs

The helicorder is not updated in real-time. For real-time data use Swarm or seisgram2k.

You can adjust the helicorder’s scale by visiting the Raspberry Shake’s webpage at http://raspberryshake.local/ >> Settings >> Advanced >> Helicorder Scaling Value.

Programs run from your desktop or laptop computer

Note

The programs listed here are installed on your desktop or laptop computer and not on the Raspberry Shake itself. They are third-party programs that were not developed by the Raspberry Shake team. We have made modifications to them or to Raspberry Shake itself to ensure compatibility.

Warning

Since many of the programs below work in real time, it is important that your local desktop computer or laptop where the programs are executing has correct time. Most computer can easily sync their system times to “Network Timing Protocol” or NTP servers.

There are a lot of programs available that you can install locally on your desktop or laptop computer for data visualization and interrogation. These programs generally connect remotely to your Raspberry Shake via a special communication protocol called SeedLink. In the case of Swarm, you can also easily connect to the Raspberry Shake Community server to see waveforms from all of the other Raspberry Shakes in the world- and there are HUNDREDS of them!

jAmaSeis

jAmaSeis, a program for visualizing waveform data, and determining earthquake locations/ magnitudes, was developed by IRIS for the Seismographs in Schools program. OSOP funded the changes need to make jAmaSeis Raspberry Shake and SeedLink-compatible in early 2017.

jAmaSeis, which is installed on your desktop or laptop runs on all platforms (Linux, MAC, Windows) and connects remotely to your Raspberry Shake to acquire the waveform data.

_images/Travel_Time_Computation.jpg

Download

jAmaSeis can be downloaded from the IRIS website at jAmaSeis.

Tutorials

Click here for the official jAmaSeis Manual and operating system-specific installation instructions.

For our step-by-step and operating system-specific installation instructions see: jAmaSeis Installation Guide.

Raspberry Shake-specific configuration

To get jAmaSeis up and running with your Raspberry Shake:

  1. Choose File >> Add Source. This will open both the “Sources Manager” and “Add Source” windows.
  2. Click on the “Raspberry Shake” button. This will close the “Add Source” window and open the “Raspberry Shake source” window.
  3. Leave the IP:Port default as “raspberryshake.local:18000” or change “raspberryshake.local” to your Raspberry Shake’s actual IP address. Notice that whereas Swarm runs on port 16032, jAmaSeis runs on port 18000.
  4. Click on the “Get Stations” button that appear beneath the IP field. This will interrogate the Raspberry Shake’s local SeedLink server and autopopulate the field for you.
  5. Hit the “OK” button which will close the “Raspberry Shake source” window and bring you back to the “Source Manager” Window. You should see your Raspberry Shake listed as a source.
  6. Click on “OK” at the “Sources Manager” screen. The helicorder plot of your Raspberry Shake should now appear in the main window. Give it a minute or two to populate the data.

seisgram2k

seisgram2k is a great program for visualizing earth motions recorded by your Raspberry Shake’s in real-time:

_images/seisgram2k-rt.jpg

Download

You can download seisgram2k here. We recommend this version: seisgram2k for schools. This version has some neat additions that are designed for school users and amateurs. The nicest feature is an interactive traveltime plotter which lets users slide a seismogram around on a plot of P and S traveltimes to determine the distance to an earthquake as seen below:

_images/seisgram2k-plot.png

The school version of the software also contains simple filter and spectrum/ spectrogram tools.

Tutorials

Click here for a short guide on how to use the software.

For our step-by-step and operating system-specific installation instructions see: seisgram2k Installation Guide.

Example seisgram2k execution for 1D

$ java -cp SeisGram2K70_SCHOOL.jar net.alomax.seisgram2k.SeisGram2K  -seedlink "raspberryshake.local:18000#AM_R5DCF:00SHZ#300"

Replace “R5DCF” with your Raspberry Shake’s station name. Notice that whereas Swarm runs on port 16032, seisgram2k runs on port 18000.

Example seisgram2k execution for 3D

$ java -cp SeisGram2K70_SCHOOL.jar net.alomax.seisgram2k.SeisGram2K  -seedlink "raspberryshake.local:18000#AM_R5DCF:00EH?#300"

Replace “R5DCF” with your Raspberry Shake’s station name. Notice that whereas Swarm runs on port 16032, seisgram2k runs on port 18000.

Special Windows Note

For Windows users you might consider creating a batch file containing the following:

SeisGram2K70_SCHOOL.jar net.alomax.seisgram2k.SeisGram2K  -seedlink "raspberryshake.local:18000#AM_R5DCF:00SHZ#300"

And similarly replacing “R5DCF” with your Raspberry Shake’s station name. Then save the file to the Seisgram2k directory as “Seisgram2k.bat”. Then you can click to open the batch file and this will load Seisgram2k and connect to your Raspberry Shake.

Swarm

Swarm is an extraordinary and useful tool that will allow you to enjoy, explore, discover and understand earthquakes in a simple way. Swarm allows you to visualize the seismic data from your Raspberry Shake from your desktop or laptop computer. Swarm was developed by the USGS Volcano Hazards Program and is easily the most widely used seismological application. It runs from your desktop or laptop computer on Linux, MAC and Windows and remotely accesses the data from your Raspberry Shake.

_images/swarm-r3967.png

Download

You can download the preconfigured Swarm application from http://raspberryshake.local >> Actions >> DOWNLOAD SWARM (button).

Tutorials

Click here for the USGS’s tutorial on how to use Swarm.

For our step-by-step and operating system-specific installation instructions see: Swarm Installation Guide.

Raspberry Shake-specific configuration

If you are configuring Swarm on your own, we recommend not using the SeedLink Server Data Source. The SeedLink Server implementation in Swarm only has access to the data currently in the SeedLink buffer. Use the Winston Wave Server Data Source to connect to the OSOP Wave Server instead (Read more about OWS here). The OWS is highly optimized and has the added benefit that it serves what is inside of the SeedLink Server buffer PLUS any data on disk (Raspberry Shake saves the last 7 days of data to disk for this reason).

Data Source Name: myShake
     Data Source: Winston Wave Server (this is a proxy for the OSOP Wave Server)
              IP: raspberryshake.local OR the actual IP
            Port: 16032
         Timeout: 15 seconds
 Use Compression: Yes

Note

The default Winston Wave Server port is 16022. Raspberry Shake’s OSOP Wave Server connection operates on 16032.

Click here to learn more about the OSOP Wave Server (OWS).

Historical data

And you can add a second data source to see historical data from your Raspberry Shake and any other Raspberry Shake in the AM network:

Data Source Name: RS Community CAPS
     Data Source: Winston Wave Server (this is a proxy for the Common Acquisition Protocol Server)
              IP: caps.raspberryshakedata.com
            Port: 16022
         Timeout: 15 seconds
 Use Compression: Yes

Click here to learn more about the Common Acquisition Protocol Server (CAPS).

Waveforms on disk

On the Raspberry Shake, continuous waveform data, as that seen with Swarm, are saved in miniSEED format to:

/opt/data/archive

The archive structure is: YEAR/NETWORK/STATION/CHANNEL/<DAILY MINISEED FILES>

Each daily miniSEED file is generally about 15 Mb in size, though the files can be bigger or smaller depending on the actual amplitudes recorded which affect the compression.

By default 7 days of continuous data are saved to disk. This is, however, configurable at in the Raspberry Shake’s webpage at http://raspberryshake.local/ Settings >> Advanced >> Waveform Data Retention >> Waveform Files Retained for X Days.

Warning

Be careful when configuring this parameter! You risk filling up the disk space. If this happens, you will not longer be able to access your Raspberry Shake. By default we ship Raspberry Shakes with an 8 Gb micro SD card. We estimate the that OS and software consume ~3 Gb of disk space, leaving you with ~5 Gb for data. At 15 Mb/ day/ channel, that is ~330 days MAX for the 1D and much less for the 3D / 4D.

Tools for computer programmers

Scripting language tool-boxes (MATLAB and Python)

These MATLAB and Python toolboxes are useful for programmers who want to create their own data visualization or processing routines.

MATLAB: GISMO

Python: Obspy