.. _sec-vortex-intro: Introduction ************ |appname| is multi-sensor, multi-station volcano monitoring module combining seismic waveform data with camera images and other sensors such as pressure, temperature and geochemistry. The stations and sensors can be selected from a map. Raw and processed data from different sensors and event sensor types can be analyzed side-by-side. |appname| combines some of the most useful techniques of volcano monitoring like RSAM and SSAM. **RSAM**, Real-time Seismic-Amplitude Measurement, represents the overall signal size over periods of 10 minutes. In situations when the number of earthquakes is so high that individual earthquakes can't be seen, or the level of volcanic tremor is such that seismograms no longer show a change in signal level, then RSAM is an excellent way of showing changes with time. **SSAM**, Seismic Spectral-Amplitude Measurement, shows the relative signal size in different frequency bands. Using SSAM it is possible to get an idea of whether a signal is produced by earthquakes, by wind or traffic noise, or by volcanic tremor. Earthquakes, wind and traffic noise all tend to have energy at a wide range of frequencies (a wide-band signal), while volcanic tremor tends to have energy in a more limited range of frequencies (a narrow-band signal). In addition to these 2 techniques |appname| integrates also other sensor data like video data to provide a more complete picture of the ongoing situation. .. note:: While time series can be received in :term:`miniSEED` format from sources which are standard in |scname| such as :cite:t:`seedlink` and :cite:t:`fdsn` the processing of other non-miniSEED data such as video streams may require the connection to the CAPS server :cite:p:`caps`. The CAPS server :cite:p:`caps` is provided by another |gempa| package and can be purchased independent of |appname|. .. _sec-vortex-features: Features ******** |appname| provides data processing and visualization methods for real-time volcano monitoring: * Overview over the current and past state of one or more volcanos simultaneously * Simultaneous multi-sensor analysis * Simultaneous multi-station analysis * Camera supervision complementing data analysis * Interactive detection and analysis of volcanic seismic events assisted by user-friendly, flexible graphical user interfaces (GUIs) * On-the-fly GUI re-configuration during runtime |appname| provides an interactive GUI that has different tabs which are configurable: * :ref:`Map tab` showing station locations on a map * :ref:`Overview tab` showing the data from multiple stations * :ref:`Details tab` showing the detailed data for one station allowing to detect volcanic events interactively. * :ref:`Event tab` load and filter events from your databse into the system. Run custom scripts. The data are provided in widgets that can be re-arranged during runtime. .. _sec-vortex-architecture: Architecture ============ |appname| is connected to a |scname| system to fetch the station meta data and to a server to receive the real-time data from all configured stations and multiple sensor types. For data in other than :term:`miniSEED` format the connection to a CAPS server :cite:p:`caps` is required. .. _sec-vortex-maptab: Map tab ======= One or more stations can be selected interactively from a map for viewing the data in the :ref:`Overview ` and the :ref:`Details ` tabs: .. figure:: media/vortex-map.png :align: center :width: 16cm VORTEX Map tab for selecting sensor stations. Right-clicking on a station on the map tab allows to add the data to the Overview and the Details tabs. .. _sec-vortex-overviewtab: Overview tab ============ The stations shown in the Overview tab are selected from the map tab. In the overview tab, the same component of all stations can be viewed side-by-side. Raw or processed data can be viewed, including: * Raw waveforms from different components * Processed waveforms * Camera data Select the data type and the component by clicking on *Data View* and *Channel*, respectively. Waveforms can be normalized in different ways to enhance the signal visibility. Click on *Offset Mode* to make the selection .. figure:: media/vortex-overview.png :align: center :width: 16cm VORTEX Overview tab for selecting sensor components, raw or processed data and color scaling. The layout of the data widget matrix is controlled by :ref:`configuration ` and can be adjusted during runtime. .. _sec-vortex-stationtab: Details tab =========== The Details tab allows to view the raw and processed data from multiple components and different sensors of the same station simultaneously. E.g. in this tab the seismic data may be compared with auxiliary streams such as pressure data and live images of a camera to interpret the data. The Details tab also allows to create artificial origins for identified events which can be processed in other GUIs. .. figure:: media/vortex-station.png :align: center :width: 16cm VORTEX Details tab for viewing raw or processed data from multiple sensors of the same station side-by-side. The display of the data can be adjusted during runtime. .. _sec-vortex-eventtab: Events tab =========== The Events tab allows to load events from the databse. These events can then be filtered by depth, magnitude, location, etc. The list of events can be imported to the vortex session, by clicking the map symbol. After that, the events are visible on the map and can be selected there or from a dropdown- menu in the overview tab. Furthermore it is possible to run python scripts, with the event list as an input, that will generate HTML output. With this tool a variety of analysis can be easily run and adapted. .. figure:: media/vortex-events.png :align: center :width: 16cm VORTEX Events tab for loading and filtering events and running custom scripts. .. list-table:: * - .. figure:: media/vortex-3dplot.png :width: 80% :align: center Fig 1. 3D Plot - .. figure:: media/vortex-grplot.png :width: 80% :align: center Fig 2. Gutenberg-Richter Plot The display of the data can be adjusted during runtime.