You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

838 lines
45 KiB
HTML

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<!DOCTYPE html>
<html >
<head>
<meta charset="utf-8" />
<title>scmv &#8212; SeisComP Release documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script src="../_static/jquery.js"></script>
<script src="../_static/underscore.js"></script>
<script src="../_static/doctools.js"></script>
<script src="../_static/language_data.js"></script>
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="scolv" href="scolv.html" />
<link rel="prev" title="scmm" href="scmm.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">5.3.0</span>
</div>
</div>
</div>
<div class="nav">
<div class="container">
<div class="content"><a class="pull-right" id="sidebar-toggle">TOC</a>
<div class="related" role="navigation" aria-label="related navigation">
<ul>
<li class="right">
<a href="../genindex.html" title="General Index"
accesskey="I">
index
</a>
</li>
<li class="right">
<a href="scolv.html" title="scolv"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="scmm.html" title="scmm"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
<li class="nav-item nav-item-1">
<a href="../gui.html" accesskey="U">Graphical User Interfaces</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<div class="section" id="scmv">
<span id="id1"></span><h1>scmv<a class="headerlink" href="#scmv" title="Permalink to this headline"></a></h1>
<p><strong>Map view</strong></p>
<div class="section" id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>scmv visualizes the actual information regarding earthquakes, trigger status,
ground motion and station quality. This information is visualized in a map
showing also the topography of the region including bathymetry, state borders
and geologic faults. scmv provides two different tabs with maps showing the
ground motion and the network status.</p>
<div class="section" id="ground-motion-status">
<h3>Ground motion status<a class="headerlink" href="#ground-motion-status" title="Permalink to this headline"></a></h3>
<p>The ground motion tab (fig. <a class="reference internal" href="#fig-scmv-gm"><span class="std std-ref">Ground motion tab</span></a>) shows the actual groundmotion
in nm/s at each station color-coded. Furthermore the trigger status (new picks)
of the stations are announced by blinking triangles (the same in all
other tabs). In case a new pick is associated to an event, the blinking color
changes from red to green (default). Events are represented by open circles
and the depth is color-coded. By right mouse click on the symbol of a station
more detailed information are shown in an information widget (fig. <a class="reference internal" href="#fig-scmv-infowidget"><span class="std std-ref">Station information widget</span></a>).</p>
<div class="figure align-center" id="id3">
<span id="fig-scmv-gm"></span><a class="reference internal image-reference" href="../_images/ground-motion.png"><img alt="../_images/ground-motion.png" src="../_images/ground-motion.png" style="width: 16cm;" /></a>
<p class="caption"><span class="caption-text">Ground motion tab</span><a class="headerlink" href="#id3" title="Permalink to this image"></a></p>
<div class="legend">
<p>Tab 1-2 = Ground Motion, Network Status tab; Station A = station with ground
motion between 0 and 200 nm/s; Station B = triggering (red blinking) station;
Station C = station of undefined status; Station D = triggering and associated
station (green blinking); EQ = location of the earthquake/event; P = spreading
of the P-wave; S = spreading of the S-wave; Legend = ground motion scale.</p>
</div>
</div>
</div>
<div class="section" id="network-status">
<h3>Network status<a class="headerlink" href="#network-status" title="Permalink to this headline"></a></h3>
<p>The network status tab (fig. <a class="reference internal" href="#fig-scmv-netstat"><span class="std std-ref">Network status tab</span></a>) visualizes the quality control
parameters of all shown stations. The colors of the triangles represent the data
the selected parameters of a station, e.g. latency or delay. More detailed information about station quality
can be derived by opening an information widget (fig. <a class="reference internal" href="#fig-scmv-infowidget"><span class="std std-ref">Station information widget</span></a> left)
with a right mouse click on the symbol.</p>
<div class="figure align-center" id="id4">
<span id="fig-scmv-netstat"></span><a class="reference internal image-reference" href="../_images/netstat.png"><img alt="../_images/netstat.png" src="../_images/netstat.png" style="width: 16cm;" /></a>
<p class="caption"><span class="caption-text">Network status tab</span><a class="headerlink" href="#id4" title="Permalink to this image"></a></p>
<div class="legend">
<p>Station A = station with up to 20 sec data latency/delay;
Station B = station with up to 10 min data latency/delay and a warning;
Station C = disabled station;
EQ = location of a recent or historic earthquake/event;
Legend = scale of the delay;
Status = connection status.</p>
</div>
</div>
<p>The visualized QC parameters can be selected in the QC parameters widget of scmv.</p>
<div class="figure align-center" id="id5">
<span id="fig-scmv-qc-select"></span><a class="reference internal image-reference" href="../_images/qc-selection.png"><img alt="../_images/qc-selection.png" src="../_images/qc-selection.png" style="width: 16cm;" /></a>
<p class="caption"><span class="caption-text">QC parameters selection widget</span><a class="headerlink" href="#id5" title="Permalink to this image"></a></p>
</div>
<p>The station information widget opens by right mouse click on a station symbol
in one of the scmv maps. The widget gives a more detailed list of parameters.
For a station general information (coordinates, network code etc.), quality
parameter (latency, gaps etc.), amplitude information and the actual waveform
data are provided. For an event information like the location, the number of
stations and the azimuthal gap are shown.</p>
<div class="figure align-center" id="id6">
<span id="fig-scmv-infowidget"></span><a class="reference internal image-reference" href="../_images/infowidget-station.png"><img alt="../_images/infowidget-station.png" src="../_images/infowidget-station.png" style="width: 8cm;" /></a>
<p class="caption"><span class="caption-text">Station information widget</span><a class="headerlink" href="#id6" title="Permalink to this image"></a></p>
</div>
<p>The info widget of a station shows station information like network code
and location. The quality of the station can be checked here. The lower
part shows the last 15 minutes of waveforms including picks (if available).</p>
</div>
<div class="section" id="event-information">
<h3>Event information<a class="headerlink" href="#event-information" title="Permalink to this headline"></a></h3>
<p>In addition to the current event scmv also shows all events it has currently
saved in its session as circles. This depends on the configured time span it remembers
events. Showing the events can give a convenient overview of the network activity.
If available focal mechanisms are displayed with dashed lines connecting to their location.
The circles and focal mechanisms are again colored by their depth and sized by
magnitude.</p>
<div class="figure align-center" id="id7">
<span id="fig-scmv-historic-origins"></span><a class="reference internal image-reference" href="../_images/historic-origins.png"><img alt="../_images/historic-origins.png" src="../_images/historic-origins.png" style="width: 16cm;" /></a>
<p class="caption"><span class="caption-text">Show historic origins</span><a class="headerlink" href="#id7" title="Permalink to this image"></a></p>
<div class="legend">
<p>All historic origins currently saved in scmv are shown as circles.</p>
</div>
</div>
<p>The events shown an the map can be confined by selecting the mode and the status
of preferred origins in the event selection widget.</p>
<div class="figure align-center" id="id8">
<span id="fig-scmv-event-select"></span><a class="reference internal image-reference" href="../_images/event-selection.png"><img alt="../_images/event-selection.png" src="../_images/event-selection.png" style="width: 16cm;" /></a>
<p class="caption"><span class="caption-text">Event selection widget</span><a class="headerlink" href="#id8" title="Permalink to this image"></a></p>
</div>
<p>The event information widget opens by right mouse click on an event symbol.
It shows event details.
Clicking on the “Show Details” button allows to open the preferred origin of
the event in other GUIs such as in scolv.</p>
<div class="figure align-center" id="id9">
<span id="fig-scmv-event-info"></span><a class="reference internal image-reference" href="../_images/event-info.png"><img alt="../_images/event-info.png" src="../_images/event-info.png" style="width: 8cm;" /></a>
<p class="caption"><span class="caption-text">Event information widget</span><a class="headerlink" href="#id9" title="Permalink to this image"></a></p>
</div>
</div>
</div>
<div class="section" id="hotkeys">
<h2>Hotkeys<a class="headerlink" href="#hotkeys" title="Permalink to this headline"></a></h2>
<table class="docutils align-default">
<colgroup>
<col style="width: 34%" />
<col style="width: 66%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Hotkey</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">F2</kbd></p></td>
<td><p>Setup connection dialog</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">F3</kbd></p></td>
<td><p>Toggle ray paths and associated stations</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">F6</kbd></p></td>
<td><p>Hide propagation of P and S waves</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">F7</kbd></p></td>
<td><p>Toggle legend</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">F8</kbd></p></td>
<td><p>Toggle historic origins</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">F9</kbd></p></td>
<td><p>Toggle station annotation</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">F10</kbd></p></td>
<td><p>Toggle event list (event tab)</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">F11</kbd></p></td>
<td><p>Toggle full screen mode</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">CTRL + f</kbd></p></td>
<td><p>Seach station</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Arrows</kbd></p></td>
<td><p>Move focus</p></td>
</tr>
<tr class="row-even"><td><p>Mouse wheel</p></td>
<td><p>Zoom in or out</p></td>
</tr>
<tr class="row-odd"><td><p>Double click</p></td>
<td><p>Center map</p></td>
</tr>
<tr class="row-even"><td><p>Right mouse button</p></td>
<td><p>Open info widget</p></td>
</tr>
<tr class="row-odd"><td><p>Mid mouse button</p></td>
<td><p>Set preliminary origin</p></td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="use-cases">
<h2>Use cases<a class="headerlink" href="#use-cases" title="Permalink to this headline"></a></h2>
<div class="section" id="get-station-information">
<h3>Get station information<a class="headerlink" href="#get-station-information" title="Permalink to this headline"></a></h3>
<ul class="simple">
<li><p>Position the mouse above a triangle representing a station.</p></li>
<li><p>Click the right mouse button for opening the station info widget.</p></li>
<li><p>Choose one station in case several stations are in the selection range.</p></li>
</ul>
</div>
<div class="section" id="get-event-information">
<h3>Get event information<a class="headerlink" href="#get-event-information" title="Permalink to this headline"></a></h3>
<ul class="simple">
<li><p>Position the mouse above a circle representing a location of an event.</p></li>
<li><p>Click the right mouse button for opening the event info widget.</p></li>
<li><p>Choose one event in case several events are in the selection range.</p></li>
</ul>
</div>
<div class="section" id="set-preliminary-origin">
<h3>Set preliminary origin<a class="headerlink" href="#set-preliminary-origin" title="Permalink to this headline"></a></h3>
<ul>
<li><p>Position the mouse in the map</p></li>
<li><p>Press the middle mouse button</p></li>
<li><p>Set date &amp; time and latitude, longitude &amp; depth</p></li>
<li><p>Press “Create” to open the origin in another GUI, e.g. scolv.</p>
<a class="reference internal image-reference" href="../_images/artificial-origin.png"><img alt="../_images/artificial-origin.png" src="../_images/artificial-origin.png" style="width: 4cm;" /></a>
</li>
</ul>
</div>
<div class="section" id="search-station-network">
<h3>Search station/network<a class="headerlink" href="#search-station-network" title="Permalink to this headline"></a></h3>
<ul class="simple">
<li><p>Press <kbd class="kbd docutils literal notranslate">CTRL + f</kbd></p></li>
<li><p>Type station/network name</p></li>
<li><p>Double click in a station in the list to center the map at this location</p></li>
</ul>
</div>
</div>
<div class="section" id="module-configuration">
<span id="scmv-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this headline"></a></h2>
<div class="line-block">
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/scmv.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/scmv.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/scmv.cfg</span></code></div>
</div>
<p>scmv inherits <a class="reference internal" href="global.html#global-configuration"><span class="std std-ref">global options</span></a>.</p>
<dl class="confval">
<dt id="confval-displaymode">
<code class="sig-name descname">displaymode</code><a class="headerlink" href="#confval-displaymode" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Start scmv in one of the available display modes:</p>
<p>groundmotion or qualitycontrol</p>
<p>and without tabs and menus as walldisplay.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-groundMotionRecordLifeSpan">
<code class="sig-name descname">groundMotionRecordLifeSpan</code><a class="headerlink" href="#confval-groundMotionRecordLifeSpan" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">300</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>s</em></p>
<p>Set the maximum latency in seconds of the ground motion records
to be valid.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-removeEventDataOlderThan">
<code class="sig-name descname">removeEventDataOlderThan</code><a class="headerlink" href="#confval-removeEventDataOlderThan" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">43200</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Set the time span in seconds to keep events.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-readEventsNotOlderThan">
<code class="sig-name descname">readEventsNotOlderThan</code><a class="headerlink" href="#confval-readEventsNotOlderThan" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Set the time span in seconds to read events initially from
database.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-centerOrigins">
<code class="sig-name descname">centerOrigins</code><a class="headerlink" href="#confval-centerOrigins" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>If a new origin/event is set/selected this option defines if the
map is centered or not at the origin location.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-eventActivityLifeSpan">
<code class="sig-name descname">eventActivityLifeSpan</code><a class="headerlink" href="#confval-eventActivityLifeSpan" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">900</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Time span of which an event is active after origin time to
show blinking associated stations.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-expiredEventsInterval">
<code class="sig-name descname">expiredEventsInterval</code><a class="headerlink" href="#confval-expiredEventsInterval" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>A positive value (greater than zero) defines the interval to check
for expired events. A negative or zero value disables the interval
check and expired events are only removed when a new event is declared
or an existing event is updated.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-annotations">
<code class="sig-name descname">annotations</code><a class="headerlink" href="#confval-annotations" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Enable/disable drawing of station annotations at startup.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-annotationsWithChannels">
<code class="sig-name descname">annotationsWithChannels</code><a class="headerlink" href="#confval-annotationsWithChannels" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Enable/disable drawing of station annotations with
location/channel codes.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-mapLegendPosition">
<code class="sig-name descname">mapLegendPosition</code><a class="headerlink" href="#confval-mapLegendPosition" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">topleft</span></code></p>
<p>Type: <em>string</em></p>
<p>Set the location of the map symbol legend (QC, ground motion).
Use either: topleft, topright, bottomright or bottomleft.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-eventLegendPosition">
<code class="sig-name descname">eventLegendPosition</code><a class="headerlink" href="#confval-eventLegendPosition" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">bottomleft</span></code></p>
<p>Type: <em>string</em></p>
<p>Set the location of the event symbol legend. Use either:
topleft, topright, bottomright or bottomleft.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-eventTable.visible">
<code class="sig-name descname">eventTable.visible</code><a class="headerlink" href="#confval-eventTable.visible" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Whether to show the event table initially or not.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-eventTable.columns">
<code class="sig-name descname">eventTable.columns</code><a class="headerlink" href="#confval-eventTable.columns" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>The columns that are visible in the table. If nothing
is specified then all columns are visible. Valid column names are:
“Event”, “Origin Time”, “Magnitude”,
“Magnitude Type”, “Region”, “Latitude”,
“Longitude”, “Depth”.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-stations.groundMotionFilter">
<code class="sig-name descname">stations.groundMotionFilter</code><a class="headerlink" href="#confval-stations.groundMotionFilter" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&quot;RMHP(50)&gt;&gt;ITAPER(20)&gt;&gt;BW(2,0.04,2)&quot;</span></code></p>
<p>Type: <em>string</em></p>
<p>The filter applied to waveforms for measuring ground motion.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>display.*</strong>
<em>Allow to define an initial rectangular region for the map.</em></p>
</div>
<dl class="confval">
<dt id="confval-display.latmin">
<code class="sig-name descname">display.latmin</code><a class="headerlink" href="#confval-display.latmin" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">-90</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>Minimum latitude in degrees.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-display.lonmin">
<code class="sig-name descname">display.lonmin</code><a class="headerlink" href="#confval-display.lonmin" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">-180</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>Minimum longitude in degrees.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-display.latmax">
<code class="sig-name descname">display.latmax</code><a class="headerlink" href="#confval-display.latmax" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">90</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>Maximum latitude in degrees.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-display.lonmax">
<code class="sig-name descname">display.lonmax</code><a class="headerlink" href="#confval-display.lonmax" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">180</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>Maximum longitude in degrees.</p>
</dd></dl>
</div>
<div class="section" id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this headline"></a></h2>
<p><strong class="program">scmv [options]</strong></p>
<div class="section" id="generic">
<h3>Generic<a class="headerlink" href="#generic" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scmv-h">
<code class="sig-name descname">-h</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--help</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-h" title="Permalink to this definition"></a></dt>
<dd><p>Show help message.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-v">
<code class="sig-name descname">-V</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--version</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-v" title="Permalink to this definition"></a></dt>
<dd><p>Show version information.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-config-file">
<code class="sig-name descname">--config-file</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-config-file" title="Permalink to this definition"></a></dt>
<dd><p>Use alternative configuration file. When this option is
used the loading of all stages is disabled. Only the
given configuration file is parsed and used. To use
another name for the configuration create a symbolic
link of the application or copy it. Example:
scautopick -&gt; scautopick2.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-plugins">
<code class="sig-name descname">--plugins</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-plugins" title="Permalink to this definition"></a></dt>
<dd><p>Load given plugins.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-auto-shutdown">
<code class="sig-name descname">--auto-shutdown</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-auto-shutdown" title="Permalink to this definition"></a></dt>
<dd><p>Enable/disable self-shutdown because a master module shutdown.
This only works when messaging is enabled and the master
module sends a shutdown message (enabled with start-stop-msg
for the master module).</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-shutdown-master-module">
<code class="sig-name descname">--shutdown-master-module</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-shutdown-master-module" title="Permalink to this definition"></a></dt>
<dd><p>Set the name of the master-module used for auto-shutdown.
This is the application name of the module actually
started. If symlinks are used, then it is the name of
the symlinked application.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-shutdown-master-username">
<code class="sig-name descname">--shutdown-master-username</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-shutdown-master-username" title="Permalink to this definition"></a></dt>
<dd><p>Set the name of the master-username of the messaging
used for auto-shutdown. If “shutdown-master-module” is
given as well, this parameter is ignored.</p>
</dd></dl>
</div>
<div class="section" id="verbosity">
<h3>Verbosity<a class="headerlink" href="#verbosity" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scmv-verbosity">
<code class="sig-name descname">--verbosity</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-verbosity" title="Permalink to this definition"></a></dt>
<dd><p>Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info,
4:debug.</p>
</dd></dl>
<dl class="option">
<dt id="id2">
<code class="sig-name descname">-v</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--v</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#id2" title="Permalink to this definition"></a></dt>
<dd><p>Increase verbosity level (may be repeated, eg. -vv).</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-q">
<code class="sig-name descname">-q</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--quiet</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-q" title="Permalink to this definition"></a></dt>
<dd><p>Quiet mode: no logging output.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-component">
<code class="sig-name descname">--component</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-component" title="Permalink to this definition"></a></dt>
<dd><p>Limit the logging to a certain component. This option can
be given more than once.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-s">
<code class="sig-name descname">-s</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--syslog</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-s" title="Permalink to this definition"></a></dt>
<dd><p>Use syslog logging backend. The output usually goes to
/var/lib/messages.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-l">
<code class="sig-name descname">-l</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--lockfile</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-l" title="Permalink to this definition"></a></dt>
<dd><p>Path to lock file.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-console">
<code class="sig-name descname">--console</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-console" title="Permalink to this definition"></a></dt>
<dd><p>Send log output to stdout.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-debug">
<code class="sig-name descname">--debug</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-debug" title="Permalink to this definition"></a></dt>
<dd><p>Execute in debug mode.
Equivalent to verbosity=4 console=1 .</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-log-file">
<code class="sig-name descname">--log-file</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-log-file" title="Permalink to this definition"></a></dt>
<dd><p>Use alternative log file.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-print-component">
<code class="sig-name descname">--print-component</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-print-component" title="Permalink to this definition"></a></dt>
<dd><p>For each log entry print the component right after the
log level. By default the component output is enabled
for file output but disabled for console output.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-trace">
<code class="sig-name descname">--trace</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-trace" title="Permalink to this definition"></a></dt>
<dd><p>Execute in trace mode.
Equivalent to verbosity=4 console=1 print-component=1
print-context=1 .</p>
</dd></dl>
</div>
<div class="section" id="messaging">
<h3>Messaging<a class="headerlink" href="#messaging" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scmv-u">
<code class="sig-name descname">-u</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--user</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-u" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.username"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.username</span></code></a>.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-host">
<code class="sig-name descname">-H</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--host</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-host" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.server"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.server</span></code></a>.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-t">
<code class="sig-name descname">-t</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--timeout</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-t" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.timeout"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.timeout</span></code></a>.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-g">
<code class="sig-name descname">-g</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--primary-group</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-g" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.primaryGroup"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.primaryGroup</span></code></a>.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-subscribe-group">
<code class="sig-name descname">-S</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--subscribe-group</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-subscribe-group" title="Permalink to this definition"></a></dt>
<dd><p>A group to subscribe to.
This option can be given more than once.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-content-type">
<code class="sig-name descname">--content-type</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-start-stop-msg">
<code class="sig-name descname">--start-stop-msg</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
</dd></dl>
</div>
<div class="section" id="database">
<h3>Database<a class="headerlink" href="#database" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scmv-db-driver-list">
<code class="sig-name descname">--db-driver-list</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-db-driver-list" title="Permalink to this definition"></a></dt>
<dd><p>List all supported database drivers.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-d">
<code class="sig-name descname">-d</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--database</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-d" title="Permalink to this definition"></a></dt>
<dd><p>The database connection string, format:
<a class="reference external" href="service://user:pwd&#64;host/database">service://user:pwd&#64;host/database</a>.
“service” is the name of the database driver which
can be queried with “db-driver-list”.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-config-module">
<code class="sig-name descname">--config-module</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-config-module" title="Permalink to this definition"></a></dt>
<dd><p>The config module to use.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-inventory-db">
<code class="sig-name descname">--inventory-db</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-inventory-db" title="Permalink to this definition"></a></dt>
<dd><p>Load the inventory from the given database or file, format:
[<a class="reference external" href="service://]location">service://]location</a> .</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-db-disable">
<code class="sig-name descname">--db-disable</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-db-disable" title="Permalink to this definition"></a></dt>
<dd><p>Do not use the database at all</p>
</dd></dl>
</div>
<div class="section" id="records">
<h3>Records<a class="headerlink" href="#records" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scmv-record-driver-list">
<code class="sig-name descname">--record-driver-list</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-record-driver-list" title="Permalink to this definition"></a></dt>
<dd><p>List all supported record stream drivers.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-i">
<code class="sig-name descname">-I</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--record-url</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-i" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
[<a class="reference external" href="service://">service://</a>]location[#type].
“service” is the name of the recordstream driver
which can be queried with “record-driver-list”.
If “service” is not given, “<a class="reference external" href="file://">file://</a>” is
used.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-record-file">
<code class="sig-name descname">--record-file</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-record-file" title="Permalink to this definition"></a></dt>
<dd><p>Specify a file as record source.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-record-type">
<code class="sig-name descname">--record-type</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-record-type" title="Permalink to this definition"></a></dt>
<dd><p>Specify a type for the records being read.</p>
</dd></dl>
</div>
<div class="section" id="cities">
<h3>Cities<a class="headerlink" href="#cities" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scmv-city-xml">
<code class="sig-name descname">--city-xml</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-city-xml" title="Permalink to this definition"></a></dt>
<dd><p>The path to the cities XML file. This overrides the default
paths. Compare with the global parameter “citiesXML”.</p>
</dd></dl>
</div>
<div class="section" id="user-interface">
<h3>User interface<a class="headerlink" href="#user-interface" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scmv-f">
<code class="sig-name descname">-F</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--full-screen</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-f" title="Permalink to this definition"></a></dt>
<dd><p>Start the application filling the entire screen.
This only works with GUI applications.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-n">
<code class="sig-name descname">-N</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--non-interactive</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-n" title="Permalink to this definition"></a></dt>
<dd><p>Use non-interactive presentation mode. This only works with
GUI applications.</p>
</dd></dl>
</div>
<div class="section" id="mapview">
<h3>Mapview<a class="headerlink" href="#mapview" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scmv-displaymode">
<code class="sig-name descname">--displaymode</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scmv-displaymode" title="Permalink to this definition"></a></dt>
<dd><p>Start scmv as walldisplay.
Modes: groundmotion, qualitycontrol</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scmv-with-legend">
<code class="sig-name descname">--with-legend</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmv-with-legend" title="Permalink to this definition"></a></dt>
<dd><p>Show the map legend if started as walldisplay.</p>
</dd></dl>
</div>
</div>
</div>
<div id="anchors-bottom"></div>
</div>
<div class="sidebar" role="navigation" aria-label="main navigation">
<div id="anchors-top"></div>
<div id="anchors" class="content">
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" />
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>$('#searchbox').show(0);</script>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">scmv</a><ul>
<li><a class="reference internal" href="#description">Description</a><ul>
<li><a class="reference internal" href="#ground-motion-status">Ground motion status</a></li>
<li><a class="reference internal" href="#network-status">Network status</a></li>
<li><a class="reference internal" href="#event-information">Event information</a></li>
</ul>
</li>
<li><a class="reference internal" href="#hotkeys">Hotkeys</a></li>
<li><a class="reference internal" href="#use-cases">Use cases</a><ul>
<li><a class="reference internal" href="#get-station-information">Get station information</a></li>
<li><a class="reference internal" href="#get-event-information">Get event information</a></li>
<li><a class="reference internal" href="#set-preliminary-origin">Set preliminary origin</a></li>
<li><a class="reference internal" href="#search-station-network">Search station/network</a></li>
</ul>
</li>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a><ul>
<li><a class="reference internal" href="#generic">Generic</a></li>
<li><a class="reference internal" href="#verbosity">Verbosity</a></li>
<li><a class="reference internal" href="#messaging">Messaging</a></li>
<li><a class="reference internal" href="#database">Database</a></li>
<li><a class="reference internal" href="#records">Records</a></li>
<li><a class="reference internal" href="#cities">Cities</a></li>
<li><a class="reference internal" href="#user-interface">User interface</a></li>
<li><a class="reference internal" href="#mapview">Mapview</a></li>
</ul>
</li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="scmm.html"
title="previous chapter">scmm</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="scolv.html"
title="next chapter">scolv</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/scmv.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="horizontal layout content">
<a class="fade-in" href="https://www.gempa.de" target="_blank">
<img class="brand" src="../_static/brands/gempa.svg"/>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>5.3.0</b> Release
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.
</div>
</div>
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
<img class="brand" src="../_static/brands/gfz.svg"/>
</a>
</div>
</div>
</div>
</body>
</html>