3494 lines
215 KiB
HTML
3494 lines
215 KiB
HTML
<!DOCTYPE html>
|
||
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||
|
||
<title>scolv — 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/pygments.css?v=72bcf2f2" />
|
||
<link rel="stylesheet" type="text/css" href="../_static/seiscomp.css?v=c6da7ce6" />
|
||
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
|
||
<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 data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
|
||
<script src="../_static/doctools.js?v=888ff710"></script>
|
||
<script src="../_static/sphinx_highlight.js?v=4825356b"></script>
|
||
<link rel="index" title="Index" href="../genindex.html" />
|
||
<link rel="search" title="Search" href="../search.html" />
|
||
<link rel="next" title="scqcv" href="scqcv.html" />
|
||
<link rel="prev" title="scmv" href="scmv.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">6.9.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="scqcv.html" title="scqcv"
|
||
accesskey="N">
|
||
next
|
||
</a>
|
||
</li>
|
||
<li class="right">
|
||
<a href="scmv.html" title="scmv"
|
||
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">
|
||
|
||
<section id="scolv">
|
||
<span id="id1"></span><h1>scolv<a class="headerlink" href="#scolv" title="Permalink to this heading">¶</a></h1>
|
||
<p><strong>Origin locator view</strong></p>
|
||
<section id="description">
|
||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading">¶</a></h2>
|
||
<div class="four column layout"><figure class="align-default" id="id8">
|
||
<img alt="scolv" src="../_images/scolv-location.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">scolv: OriginLocatorView <a class="reference internal" href="#scolv-sec-location-tab"><span class="std std-ref">Location tab</span></a>
|
||
with event and phase information</span><a class="headerlink" href="#id8" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<figure class="align-default" id="id9">
|
||
<img alt="scolv picker" src="../_images/scolv-picker.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">scolv: OriginLocatorView <a class="reference internal" href="#scolv-sec-waveform-review"><span class="std std-ref">phase picker</span></a>
|
||
with waveforms and phase information</span><a class="headerlink" href="#id9" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<figure class="align-default" id="id10">
|
||
<img alt="scolv picker" src="../_images/scolv-event.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">scolv: OriginLocatorView <a class="reference internal" href="#fig-scolv-event"><span class="std std-ref">Event tab</span></a> with all origins</span><a class="headerlink" href="#id10" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<figure class="align-default" id="id11">
|
||
<img alt="scolv picker" src="../_images/scolv-magnitude-picker.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">scolv: OriginLocatorView <a class="reference internal" href="#scolv-sec-amplitude-review"><span class="std std-ref">amplitude waveform review</span></a>
|
||
with station magnitudes</span><a class="headerlink" href="#id11" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
</div><p>scolv is the main interactive tool to revise or review origin and event information.
|
||
It thus provides the entire functionality to analyze earthquake parameters:</p>
|
||
<ul class="simple">
|
||
<li><p>Phase picks and arrivals in diagrams and waveforms</p></li>
|
||
<li><p>Hypocenter location and source time with uncertainties</p></li>
|
||
<li><p>Focal mechanism from first-motion polarities</p></li>
|
||
<li><p>Magnitudes in diagrams and waveforms</p></li>
|
||
<li><p>Origin status and certainty</p></li>
|
||
<li><p>Event association</p></li>
|
||
<li><p>Event type</p></li>
|
||
</ul>
|
||
<p>The main scolv window is divided into 4 perspectives (tabs) from which external windows
|
||
can be opened:</p>
|
||
<ul class="simple">
|
||
<li><p><a class="reference internal" href="#scolv-sec-location-tab"><span class="std std-ref">Location tab</span></a>: Details of the selected <a class="reference internal" href="../base/glossary.html#term-origin"><span class="xref std std-term">origin</span></a> with</p>
|
||
<ul>
|
||
<li><p><a class="reference internal" href="#scolv-sec-waveform-review"><span class="std std-ref">Phase picker</span></a> (external window): Review
|
||
waveforms for phase picking including polarities, uncertainties, spectra and
|
||
spectrograms,</p></li>
|
||
<li><p><a class="reference internal" href="#scolv-sec-commit"><span class="std std-ref">Extended commit</span></a> (external window): Commit solution
|
||
with additional options.</p></li>
|
||
</ul>
|
||
</li>
|
||
<li><p><a class="reference internal" href="#scolv-sec-magnitude-tab"><span class="std std-ref">Magnitudes tab</span></a>: Magnitude details of the
|
||
selected origin with</p>
|
||
<ul>
|
||
<li><p><a class="reference internal" href="#scolv-sec-amplitude-review"><span class="std std-ref">Amplitude waveform review</span></a> (external window):
|
||
Waveform review for measuring amplitudes and for computing magnitudes.</p></li>
|
||
</ul>
|
||
</li>
|
||
<li><p><a class="reference internal" href="#fig-scolv-event"><span class="std std-ref">Event tab</span></a>: Origins and focal mechanisms referenced
|
||
by the selected <a class="reference internal" href="../base/glossary.html#term-event"><span class="xref std std-term">event</span></a>.</p></li>
|
||
<li><p><a class="reference internal" href="#fig-scolv-events"><span class="std std-ref">Events tab</span></a>: Table of event parameters of the loaded
|
||
events with interactive filtering of database requests and loaded events.</p></li>
|
||
</ul>
|
||
</section>
|
||
<section id="modes-of-operation">
|
||
<h2>Modes of Operation<a class="headerlink" href="#modes-of-operation" title="Permalink to this heading">¶</a></h2>
|
||
<p>scolv can be operated in 2 modes:</p>
|
||
<ul>
|
||
<li><p><strong>Connected to the messaging</strong> where all event and station inventory parameters
|
||
are received from the <a class="reference internal" href="../base/concepts/messaging.html#concepts-messaging"><span class="std std-ref">messaging</span></a> or the database and
|
||
<em>updated in real time</em>. New or updated
|
||
parameters can be commited to the messaging. Simply start scolv without any argument
|
||
or connect to a specific host providing the messaging, e.g.:</p>
|
||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scolv
|
||
scolv<span class="w"> </span>-H<span class="w"> </span><span class="o">[</span>host<span class="o">]</span>
|
||
</pre></div>
|
||
</div>
|
||
</li>
|
||
<li><p><strong>Offline without messaging</strong> where all event and station
|
||
inventory parameters are read from an XML files or from the database and
|
||
<em>updated interactively</em>. New or updated parameters can be written to an XML file.
|
||
Execute scolv with the command-line option
|
||
<code class="docutils literal notranslate"><span class="pre">--offline</span></code> and optionally provide the database or inventory and bindings
|
||
parameters in <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> format to fetch event parameters as well as inventory
|
||
and bindings configuration parameters. Examples:</p>
|
||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scolv<span class="w"> </span>--offline
|
||
scolv<span class="w"> </span>--offline<span class="w"> </span>-d<span class="w"> </span><span class="o">[</span>database<span class="o">]</span>
|
||
scolv<span class="w"> </span>--offline<span class="w"> </span>--inventory-db<span class="w"> </span><span class="o">[</span>inventory<span class="o">]</span><span class="w"> </span>--config-db<span class="w"> </span><span class="o">[</span>config<span class="o">]</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>Select one XML file in the <cite>File</cite> menu to read event parameters.
|
||
After processing, the parameters can be saved to another XML file though the
|
||
<cite>File</cite> menu.</p>
|
||
</li>
|
||
</ul>
|
||
</section>
|
||
<section id="location-tab">
|
||
<span id="scolv-sec-location-tab"></span><h2>Location Tab<a class="headerlink" href="#location-tab" title="Permalink to this heading">¶</a></h2>
|
||
<p>The Location tab shows detailed information of the associated
|
||
phases and the residuals from the chosen origin additional information about the
|
||
hypocenter, time, station distribution, helps to find outlier.</p>
|
||
<figure class="align-center" id="id12">
|
||
<span id="fig-scolv-location"></span><a class="reference internal image-reference" href="../_images/tab_location.png"><img alt="../_images/tab_location.png" src="../_images/tab_location.png" style="width: 16cm;" /></a>
|
||
<figcaption>
|
||
<p><span class="caption-text">Location tab of scolv with summary widget to the left.</span><a class="headerlink" href="#id12" title="Permalink to this image">¶</a></p>
|
||
<div class="legend">
|
||
<p>(<strong>Redo/Undo</strong>) Switch to last/next location result
|
||
(<strong>Tab 1-4</strong>) Location/Magnitude/Event/Events tab
|
||
(<strong>Map</strong>) map with the event location, associated stations, the color coded
|
||
residuals (red-positive, blue-negative) and ray paths
|
||
(<strong>Information</strong>) Origin information including time, epicentre, depth, number of
|
||
used and available phases, RMS, azimuthal gap and minimum
|
||
station distance
|
||
(<strong>List</strong>) Table of associated arrivals (phases) containing stream information
|
||
and phase information
|
||
(<strong>Tab 5-10</strong>) Arrival residual plots against distance and azimuth (linear and
|
||
polar) in a separate tab
|
||
(<strong>Plot</strong>) Arrival residual plot (distance over residual in seconds)
|
||
(<strong>Depth</strong>) Checkbox to fix to a defined depth
|
||
(<strong>B1</strong>) Relocate with the given arrival information
|
||
(<strong>B2</strong>) Open Manual Picker
|
||
(<strong>B3</strong>) Import picks of other automatic origins belonging to the same event
|
||
(<strong>B4</strong>) Compute magnitudes
|
||
(<strong>B5</strong>) Commit origin
|
||
(<strong>Summary</strong>) all information of the preferred origin of the loaded event</p>
|
||
</div>
|
||
</figcaption>
|
||
</figure>
|
||
<section id="summary-widget">
|
||
<span id="scolv-sec-summary-widget"></span><h3>Summary widget<a class="headerlink" href="#summary-widget" title="Permalink to this heading">¶</a></h3>
|
||
<p>The summary widget in the Location tab contains two other tabs: <em>Preferred</em> and
|
||
<em>Current</em>. <em>Preferred</em>
|
||
reflects the current official (database) state of the event while <em>Current</em>
|
||
shows the current solution (location and magnitudes). Activate the Summary widget
|
||
by pressing <kbd class="kbd docutils literal notranslate">F8</kbd> or from the <em>View</em> menu.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>The summary tab is available for all other tabs of the scolv main window and
|
||
also for other GUI applications.</p>
|
||
</div>
|
||
</section>
|
||
<section id="diagrams">
|
||
<span id="scolv-sec-diagrams"></span><h3>Diagrams<a class="headerlink" href="#diagrams" title="Permalink to this heading">¶</a></h3>
|
||
<p>The default arrival residual plot is shown in the figure above. Additional
|
||
plots are available to analyze arrivals which can be shown by activating the
|
||
corresponding tab.</p>
|
||
<p>In these diagrams, arrival can be activated or deactivating for <a class="reference internal" href="#scolv-sec-relocating"><span class="std std-ref">relocating</span></a>
|
||
by clicking on a point or by selecting a range using mouse drag. Deselecting is
|
||
available by mouse drag when pressing <kbd class="kbd docutils literal notranslate">Ctrl</kbd>.</p>
|
||
<figure class="align-center" id="id13">
|
||
<a class="reference internal image-reference" href="../_images/tab_location_plots.png"><img alt="../_images/tab_location_plots.png" src="../_images/tab_location_plots.png" style="width: 18cm;" /></a>
|
||
<figcaption>
|
||
<p><span class="caption-text">Additional arrival plots in Location tab of the main window</span><a class="headerlink" href="#id13" title="Permalink to this image">¶</a></p>
|
||
<div class="legend">
|
||
<p>From upper left to lower right: <strong>1</strong>) travel-time residual vs distance, <strong>2</strong>)
|
||
travel-time residual vs azimuth, <strong>3</strong>) azimuth vs distance in polar plot
|
||
<strong>4</strong>) travel-time vs distance, <strong>5</strong>) corrected travel-time vs distance
|
||
<strong>6</strong>) focal mechanism.</p>
|
||
</div>
|
||
</figcaption>
|
||
</figure>
|
||
<p>The move out plot uses the reduced travel time with a default reduction velocity
|
||
of 6km/s. This value is configurable by <a class="reference internal" href="#confval-olv.Pvel"><code class="xref std std-confval docutils literal notranslate"><span class="pre">olv.Pvel</span></code></a>, either in the configuration file
|
||
(<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>) or in the <a class="reference internal" href="#scolv-settings"><span class="std std-ref">settings window</span></a>, e.g.:</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Reduction velocity used for move out plot</span>
|
||
<span class="na">olv.Pvel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">6.0</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>The diagrams in the scolv Location tab present observations (e.g. arrival residuals). Each plot
|
||
is also interactive to select a subset of data or to zoom into a region.</p>
|
||
<p>A plot filter can be defined. Filtering means that arrivals that match the
|
||
filter are not plotted. They are filtered out visually. To enable a filter
|
||
click the link “not active” right below the plot tabs. A setup window pops up
|
||
where the filter can be defined. Currently only a filter by azimuth around
|
||
epicenter can be applied.</p>
|
||
<figure class="align-center">
|
||
<a class="reference internal image-reference" href="../_images/plot-filter-setup.png"><img alt="../_images/plot-filter-setup.png" src="../_images/plot-filter-setup.png" style="width: 8cm;" /></a>
|
||
</figure>
|
||
<p>Select the center azimuth and the extent to either side. If OK is pressed all
|
||
arrivals that fall outside the defined azimuthal area are hidden from the plot
|
||
and the line below the tabs turns into “Filter is active”. Clicking on the
|
||
link again and select the “None” filter will show all arrivals in the plot again.</p>
|
||
<p>Plots can also be configured to show or hide dashed grid lines. Use <a class="reference internal" href="#confval-olv.drawGridLines"><code class="xref std std-confval docutils literal notranslate"><span class="pre">olv.drawGridLines</span></code></a>
|
||
for configuration (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>). The default is true.</p>
|
||
</section>
|
||
<section id="arrival-table">
|
||
<span id="scolv-sec-location-arrival-table"></span><h3>Arrival table<a class="headerlink" href="#arrival-table" title="Permalink to this heading">¶</a></h3>
|
||
<p>The arrival table shows all arrivals of the current origin. The columns are
|
||
sortable by clicking on the corresponding header item. Additional data columns
|
||
can be shown or active columns can be hidden, either initially or interactively.
|
||
Available column identifiers are:</p>
|
||
<ul class="simple">
|
||
<li><p><strong>Used</strong></p></li>
|
||
<li><p><strong>Status</strong></p></li>
|
||
<li><p><strong>Phase</strong></p></li>
|
||
<li><p>Weight</p></li>
|
||
<li><p>Method</p></li>
|
||
<li><p>Polarity</p></li>
|
||
<li><p>Takeoff</p></li>
|
||
<li><p><strong>Net</strong></p></li>
|
||
<li><p><strong>Sta</strong></p></li>
|
||
<li><p><strong>Loc/Cha</strong></p></li>
|
||
<li><p><strong>Res</strong></p></li>
|
||
<li><p><strong>Dis</strong></p></li>
|
||
<li><p><strong>Az</strong></p></li>
|
||
<li><p><strong>Time</strong></p></li>
|
||
<li><p><strong>Timeres</strong></p></li>
|
||
<li><p>Slo</p></li>
|
||
<li><p>Slores</p></li>
|
||
<li><p>Baz</p></li>
|
||
<li><p>Bazres</p></li>
|
||
<li><p><strong>+/-</strong></p></li>
|
||
<li><p>Created</p></li>
|
||
<li><p>Latency</p></li>
|
||
</ul>
|
||
<p>The columns printed bold are shown initially. The initial column
|
||
list can be changed in <code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code> by adjusting <a class="reference internal" href="#confval-olv.arrivalTable.visibleColumns"><code class="xref std std-confval docutils literal notranslate"><span class="pre">olv.arrivalTable.visibleColumns</span></code></a>:</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">olv.arrivalTable.visibleColumns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Used, Status, Weight, Phase, Net, Sta,</span><span class="se">\</span>
|
||
<span class="w"> </span><span class="s">Loc/Cha, Res, Dis, Az, Time, +/-</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>The user can also interactively select what columns are be visible or hidden
|
||
from a context menu which pops up after a right click on the table header.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/arrivals-header-context.png" src="../_images/arrivals-header-context.png" />
|
||
</figure>
|
||
<p>The checkbox in the first column indicates if the arrival was used for locating the
|
||
origin. The overall usage state of arrival contains three flags: arrival time used,
|
||
backazimuth used and slowness used. If any of these flags is active then the
|
||
overall usage state is active as well. The arrival table shows those flags indicated
|
||
by <strong>T</strong> for pick time, <strong>S</strong> for horizontal slowness and <strong>B</strong> for backazimuth.
|
||
A flag is rendered with a dash if the referred pick does not contain the
|
||
corresponding feature. For example, if a pick does not carry a backazimuth
|
||
measure then the backazimuth flag is disabled. It would not make sense to
|
||
activate backazimuth usage without a corresponding measure.</p>
|
||
<p>In most cases, only the time flag, indicated by the capital <strong>T</strong>, will be active.
|
||
The other two flags are rendered with dashes, meaning that they are inactive.
|
||
Background: an arrival refers to a pick which can hold several features. The basic
|
||
feature a pick must hold is the pick time. Some modules such as for array processing
|
||
might compute additional pick features. Such features can be the backazimuth and
|
||
the horizontal slowness. Locators like LocSAT were developed to use those features
|
||
to increase the precision of a location. Special applictions are locations based
|
||
borehole networks with poor azimuthal coverage or locations with very few stations.</p>
|
||
<p>There may be cases where a backazimuth measure of a pick should not be used by
|
||
the locator. In contrast, if a backazimuth is available but the timing is bad,
|
||
disabling the use of the pick time but including the backazimuth may be advantageous.
|
||
For that a simple weight value is not enough. With a weight one cannot separate
|
||
whether or not to use a particular feature. So the arrival does not only refer
|
||
to a pick but holds flags indicating which features of that pick should be used
|
||
for locating.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/arrival-flags.png" src="../_images/arrival-flags.png" />
|
||
</figure>
|
||
<p>Single or multiple rows can be selected in the table. The selection of multiple
|
||
rows works either with Ctrl+LeftMouse (add single row) or
|
||
Shift+LeftMouse (range selection).</p>
|
||
<p>When pressing the right mouse button on a selected row a context menu pops up.
|
||
If an unselected row is used, the current selection will be reset and only the
|
||
row below the mouse is selected.</p>
|
||
<p>The context menu allows to:</p>
|
||
<ul class="simple">
|
||
<li><p>Select arrivals based on a certain criterion,</p></li>
|
||
<li><p>Activate/deactivate selected pick features,</p></li>
|
||
<li><p>Delete selected arrivals,</p></li>
|
||
<li><p>Rename phases of selected arrivals.</p></li>
|
||
</ul>
|
||
<figure class="align-center">
|
||
<img alt="../_images/arrivals-context.png" src="../_images/arrivals-context.png" />
|
||
</figure>
|
||
<p>If arrivals are deleted, they are removed physically from this solution in
|
||
contrast to deactivate an arrival where only the used flags are set to zero.</p>
|
||
</section>
|
||
<section id="phase-picker-review-waveforms">
|
||
<span id="scolv-sec-waveform-review"></span><h3>Phase picker: review waveforms<a class="headerlink" href="#phase-picker-review-waveforms" title="Permalink to this heading">¶</a></h3>
|
||
<p>The <em>Picker</em> button opens the interactive waveform picker window. It allows
|
||
to view and process waveforms for</p>
|
||
<ul class="simple">
|
||
<li><p>Picking additional phases,</p></li>
|
||
<li><p>Confirming picks,</p></li>
|
||
<li><p>Adding additional pick information such as polarity and uncertainty,</p></li>
|
||
<li><p>Data procssing, e.g. filtering, rotation, spectrogram and much more.</p></li>
|
||
</ul>
|
||
<p>The phase picker window is divided into two parts:</p>
|
||
<ul class="simple">
|
||
<li><p>The zoom trace and</p></li>
|
||
<li><p>The trace list.</p></li>
|
||
</ul>
|
||
<p>The zoom trace shows a sub area of the active trace in the list.</p>
|
||
<figure class="align-center" id="fig-scolv-picker">
|
||
<a class="reference internal image-reference" href="../_images/picker.png"><img alt="../_images/picker.png" src="../_images/picker.png" style="width: 16cm;" /></a>
|
||
</figure>
|
||
<section id="request-waveforms">
|
||
<h4>Request waveforms<a class="headerlink" href="#request-waveforms" title="Permalink to this heading">¶</a></h4>
|
||
<p>When the picker window opens waveforms are initially requested for all streams
|
||
which have associated phase picks (arrivals). More waveforms can be fetched
|
||
interavtively:</p>
|
||
<ol class="arabic simple">
|
||
<li><p>Provide a maximum distance,</p></li>
|
||
<li><p>Click on the purple <cite>Add</cite> button to load the data.</p></li>
|
||
</ol>
|
||
<p>Toggle viewing data without arrivals by clicking the purple <cite>Hide</cite> button.</p>
|
||
<p>During request the background of the traces is changed according to the current
|
||
state:</p>
|
||
<ul class="simple">
|
||
<li><p>Yellow: waveforms requested but not yet received.</p></li>
|
||
<li><p>Red: acquisition finished and data is not available.</p></li>
|
||
<li><p>Green: waveforms received and acquisition still in progress.</p></li>
|
||
<li><p>Gray: meta data are missing.</p></li>
|
||
</ul>
|
||
<figure class="align-center">
|
||
<a class="reference internal image-reference" href="../_images/picker-acqui.png"><img alt="../_images/picker-acqui.png" src="../_images/picker-acqui.png" style="width: 16cm;" /></a>
|
||
</figure>
|
||
<p>If a trace displays all three components and amplitudes are scaled up, they are
|
||
not clipped to their window area. The clipping behavior can be toggled by
|
||
either pressing <kbd class="kbd docutils literal notranslate">C</kbd> or in the menu
|
||
<span class="menuselection">View ‣ Zoomtrace ‣ Clip components to viewport</span>.</p>
|
||
<p>The difference is shown in the following two images:</p>
|
||
<figure class="align-center" id="id14">
|
||
<a class="reference internal image-reference" href="../_images/clobber-off.png"><img alt="../_images/clobber-off.png" src="../_images/clobber-off.png" style="width: 16cm;" /></a>
|
||
<figcaption>
|
||
<p><span class="caption-text">Trace clipping enabled</span><a class="headerlink" href="#id14" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<figure class="align-center" id="id15">
|
||
<a class="reference internal image-reference" href="../_images/clobber-on.png"><img alt="../_images/clobber-on.png" src="../_images/clobber-on.png" style="width: 16cm;" /></a>
|
||
<figcaption>
|
||
<p><span class="caption-text">Trace clipping disabled</span><a class="headerlink" href="#id15" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
</section>
|
||
<section id="c-3c-data">
|
||
<h4>1C / 3C data<a class="headerlink" href="#c-3c-data" title="Permalink to this heading">¶</a></h4>
|
||
<p>Initially the picker window shows only the vertical channels for each station that
|
||
have been associated with the current location. When opening, it can be configured to</p>
|
||
<ul class="simple">
|
||
<li><p>Load all components: <a class="reference internal" href="#confval-picker.loadAllComponents"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.loadAllComponents</span></code></a>,</p></li>
|
||
<li><p>Show all components: <a class="reference internal" href="#confval-picker.showAllComponents"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.showAllComponents</span></code></a>.</p></li>
|
||
</ul>
|
||
<p>Hotkey <kbd class="kbd docutils literal notranslate">t</kbd> can be used to toggle beetween 1- and 3-component data. Use the
|
||
yellow buttons or <a class="reference internal" href="#sec-scolv-hotkeys"><span class="std std-ref">hot keys</span></a> to load components not yet
|
||
loaded.</p>
|
||
</section>
|
||
<section id="data-filtering">
|
||
<h4>Data filtering<a class="headerlink" href="#data-filtering" title="Permalink to this heading">¶</a></h4>
|
||
<p>When the picker window opens, the waveforms are filtered by the default filter
|
||
configured in <a class="reference internal" href="#confval-picker.filters"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.filters</span></code></a>. Selecting filters or unfitlered data
|
||
interactively is available by choosing the filter from the filter menu or
|
||
<a class="reference internal" href="#sec-scolv-hotkeys"><span class="std std-ref">hot keys</span></a>.</p>
|
||
</section>
|
||
<section id="waveform-rotation">
|
||
<h4>Waveform rotation<a class="headerlink" href="#waveform-rotation" title="Permalink to this heading">¶</a></h4>
|
||
<p>Waveforms can be rotated to better view details. For rotating the waveform
|
||
components into ZNE or ZRT system a new drop down list was added in the toolbar.
|
||
Selecting either ZNE or ZRT implies that all missing components are requested.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/rotation-options.png" src="../_images/rotation-options.png" />
|
||
</figure>
|
||
</section>
|
||
<section id="phase-picks">
|
||
<h4>Phase picks<a class="headerlink" href="#phase-picks" title="Permalink to this heading">¶</a></h4>
|
||
<p>Phase picks shown on waveforms are color-coded:</p>
|
||
<ul class="simple">
|
||
<li><p>Red: automatic</p></li>
|
||
<li><p>Green: manual</p></li>
|
||
<li><p>Blue: predicted using the selected travel-time table</p></li>
|
||
</ul>
|
||
<p>Mature and light colors indicate arrivals and unassociated picks, respectively.
|
||
Unassociated picks can be shown/hidden using <kbd class="kbd docutils literal notranslate">Ctrl</kbd> + <kbd class="kbd docutils literal notranslate">5</kbd>.</p>
|
||
<section id="phase-picking">
|
||
<h5>Phase picking<a class="headerlink" href="#phase-picking" title="Permalink to this heading">¶</a></h5>
|
||
<p>Initially the picker window allows to pick the arrival times of the following phases:</p>
|
||
<ul class="simple">
|
||
<li><p>P</p></li>
|
||
<li><p>Pn</p></li>
|
||
<li><p>Pg</p></li>
|
||
<li><p>pP</p></li>
|
||
<li><p>S</p></li>
|
||
<li><p>Sg</p></li>
|
||
</ul>
|
||
<p>Up to 9 phase types can be configured for selection by
|
||
<a class="reference internal" href="#sec-scolv-hotkeys"><span class="std std-ref">hot keys</span></a>. This list of favourite phases can be customized
|
||
by <a class="reference internal" href="#confval-picker.phases.favourites"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.phases.favourites</span></code></a>, e.g. (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define a list of favourite phases for quick access</span>
|
||
<span class="na">picker.phases.favourites</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Pn, P, Pg, PmP, P1, Pg, Sg, S, Sn, SmS</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>The list of favourites is used to assign shortcuts to. <kbd class="kbd docutils literal notranslate">1</kbd> is assigned
|
||
to the first phase in the list, <kbd class="kbd docutils literal notranslate">2</kbd> to the second and so on.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>Shortcuts are assigned only to the first 9 favourite phases. All
|
||
other defined phases can be activated from the <em>Picking</em> menu.</p>
|
||
</div>
|
||
<p>The phases can be also grouped to reflect e.g. regional
|
||
and teleseismic profiles. In group not hot keys are available.
|
||
An example configuration looks like this (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define two phase groups: regional and teleseismic</span>
|
||
<span class="na">picker.phases.groups</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">regional, teleseismic</span>
|
||
|
||
<span class="c1"># Define all phases of group "regional"</span>
|
||
<span class="na">picker.phases.groups.regional</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Pn, P, Pg, PmP, P1, Sg, S, Sn, SmS</span>
|
||
|
||
<span class="c1"># Define all phases of group "teleseismic"</span>
|
||
<span class="na">picker.phases.groups.teleseismic</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">pP, sP, sS, PKP, PKP</span>
|
||
</pre></div>
|
||
</div>
|
||
<figure class="align-center" id="id16">
|
||
<img alt="../_images/phases-menu.png" src="../_images/phases-menu.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">Pick phase selection menu</span><a class="headerlink" href="#id16" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<p>For making a phase pick the picking mode must be activated by choosing a phase in the
|
||
Picking menu. Short cuts are:</p>
|
||
<ul class="simple">
|
||
<li><p>Blue P and S buttons for picking P and phases, respectively (hot keys <kbd class="kbd docutils literal notranslate">F1</kbd>, <kbd class="kbd docutils literal notranslate">F2</kbd>),</p></li>
|
||
<li><p>Numbers shown in the picking menu used as hot keys.</p></li>
|
||
</ul>
|
||
<p>Additional information can be added interactively to the picks:</p>
|
||
<ul class="simple">
|
||
<li><p><a class="reference internal" href="#scolv-sec-uncertainties"><span class="std std-ref">Pick uncertainties</span></a>,</p></li>
|
||
<li><p><a class="reference internal" href="#scolv-sec-polarities"><span class="std std-ref">Phase polarities</span></a>.</p></li>
|
||
</ul>
|
||
<p>Press <kbd class="kbd docutils literal notranslate">ESC</kbd> to leave the picking menu. To send all picks to the main scolv
|
||
window click on the red <cite>Apply</cite> button or press <kbd class="kbd docutils literal notranslate">F5</kbd>. The picks will be used
|
||
immediately for <a class="reference internal" href="#scolv-sec-relocating"><span class="std std-ref">relocating</span></a>.</p>
|
||
<div class="admonition warning">
|
||
<p class="admonition-title">Warning</p>
|
||
<p>All manual work will be lost when closing the picker window without sending
|
||
the picks.</p>
|
||
</div>
|
||
</section>
|
||
<section id="pick-uncertainties">
|
||
<span id="scolv-sec-uncertainties"></span><h5>Pick uncertainties<a class="headerlink" href="#pick-uncertainties" title="Permalink to this heading">¶</a></h5>
|
||
<p>If the mouse hovers a pick, a dashed rectangle is drawn around this pick. Then
|
||
the pick is active and the right mouse button can be pressed to open the context
|
||
menu where the polarity and uncertainty can be defined. The following screen shot
|
||
shows the available uncertainties.</p>
|
||
<figure class="align-center" id="id17">
|
||
<img alt="../_images/pick-context2.png" src="../_images/pick-context2.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">Pick context menu</span><a class="headerlink" href="#id17" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<p>Additionally, pick uncertainties can be defined freely whereas choosing
|
||
among a predefined set of uncertainties is a lot faster. The way, pick uncertainties
|
||
are used depends on the applied locator routine and its configuration.
|
||
To set the uncertainty of a pick more easily a list of predefined uncertainties can be
|
||
defined using <a class="reference internal" href="#confval-picker.uncertainties"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.uncertainties</span></code></a>, e.g.:</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">picker.uncertainties</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">0.05, 0.1, 0.2, "(0.1,0.2)", "(0.05,0.02)"</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>where single values define symmetric and pairs of values define asymmetric uncertainties.
|
||
The pre-defined uncertainties can be selected during picking using
|
||
<a class="reference internal" href="#sec-scolv-hotkeys"><span class="std std-ref">hot keys</span></a>, e.g.
|
||
<kbd class="kbd docutils literal notranslate">1</kbd> or <kbd class="kbd docutils literal notranslate">2</kbd> for the 1st or the 2nd value defined in <a class="reference internal" href="#confval-picker.uncertainties"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.uncertainties</span></code></a>.
|
||
Later, the uncertainties can be adjusted manually.
|
||
As for phase types, uncertainty profiles can be additionally configured (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define available pick uncertainty profiles. Single values</span>
|
||
<span class="c1"># are symmetric uncertainties whereas tuples are asymmetric</span>
|
||
<span class="c1"># uncertainties: (left,right). Uncertainty values are given</span>
|
||
<span class="c1"># in seconds.</span>
|
||
|
||
<span class="c1"># Define an uncertainty profile for local events</span>
|
||
<span class="na">picker.uncertainties.profile.local</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">0.05, 0.1, 0.2, 0.3, "(0.1,0.2)"</span>
|
||
|
||
<span class="c1"># Define an uncertainty profile for teleseismic events</span>
|
||
<span class="na">picker.uncertainties.profile.teleseismic</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">0.5, 1, 2, 3, "(1,2)"</span>
|
||
|
||
<span class="c1"># Define the list of uncertainty sets that are active in scolv.</span>
|
||
<span class="c1"># This first set in the list is used by default. The other sets</span>
|
||
<span class="c1"># can be activated in the settings dialog (scolv: F3)</span>
|
||
<span class="na">picker.uncertainties.preferred</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">local, teleseismic</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>If an uncertainty is selected, the active pick is copied into a manual pick
|
||
and the uncertainty is displayed as semi transparent bar to the left and
|
||
to the right of the pick. The width of the bar corresponds to the uncertainty
|
||
in seconds.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/pick-uncertainty.png" src="../_images/pick-uncertainty.png" />
|
||
</figure>
|
||
</section>
|
||
<section id="phase-polarities">
|
||
<span id="scolv-sec-polarities"></span><h5>Phase polarities<a class="headerlink" href="#phase-polarities" title="Permalink to this heading">¶</a></h5>
|
||
<p>Furthermore the phase pick polarity can be defined. When this is the polarity
|
||
of the first arrival P phase it can be used to manually set the focal mechanisms
|
||
of the origin in the <a class="reference internal" href="#scolv-sec-diagrams"><span class="std std-ref">FirstMotion</span></a> diagram.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/pick-context.png" src="../_images/pick-context.png" />
|
||
</figure>
|
||
<p>Right-click on the pick to make a choice: Either <em>positive</em>, <em>negative</em>,
|
||
<em>undecidable</em> or <em>unset</em> is available. You may speed up your work by using
|
||
<a class="reference internal" href="#sec-scolv-hotkeys"><span class="std std-ref">hot keys</span></a>. If set, the polarity is displayed as an
|
||
arrow. <em>Undecidable</em> is displayed as a cross (X).</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/pick-polarity.png" src="../_images/pick-polarity.png" />
|
||
</figure>
|
||
</section>
|
||
</section>
|
||
</section>
|
||
<section id="relocate-events">
|
||
<span id="scolv-sec-relocating"></span><h3>Relocate events<a class="headerlink" href="#relocate-events" title="Permalink to this heading">¶</a></h3>
|
||
<p>The <em>Relocate</em> button allows relocating based on the selected pick set. Picks may
|
||
be manually adjusted or created before in the
|
||
<a class="reference internal" href="#scolv-sec-waveform-review"><span class="std std-ref">wave review window</span></a> or arrival properties may
|
||
be directly adjusted in the <a class="reference internal" href="#scolv-sec-location-arrival-table"><span class="std std-ref">arrival table</span></a>.
|
||
Prior to relocating choose the locator, the locator profile and additional parameters
|
||
to the right or from the the tool box.</p>
|
||
<figure class="align-center">
|
||
<a class="reference internal image-reference" href="../_images/scolv-relocating.png"><img alt="../_images/scolv-relocating.png" src="../_images/scolv-relocating.png" style="width: 16cm;" /></a>
|
||
</figure>
|
||
<p>Defaults may be configured, e.g.</p>
|
||
<ul class="simple">
|
||
<li><p><a class="reference internal" href="#confval-olv.locator.interface"><code class="xref std std-confval docutils literal notranslate"><span class="pre">olv.locator.interface</span></code></a>: Default locator</p></li>
|
||
<li><p><a class="reference internal" href="#confval-olv.locator.defaultProfile"><code class="xref std std-confval docutils literal notranslate"><span class="pre">olv.locator.defaultProfile</span></code></a>: Default profile of the default locator</p></li>
|
||
<li><p><a class="reference internal" href="#confval-olv.locator.minimumDepth"><code class="xref std std-confval docutils literal notranslate"><span class="pre">olv.locator.minimumDepth</span></code></a>: Minimum depth for the locator to consider.</p></li>
|
||
</ul>
|
||
<p>The locators available by default in <cite>SeisComP</cite> are</p>
|
||
<ul class="simple">
|
||
<li><p><a class="reference internal" href="global_fixedhypocenter.html#global-fixedhypocenter"><span class="std std-ref">LOCSAT</span></a>,</p></li>
|
||
<li><p><a class="reference internal" href="global_locsat.html#global-locsat"><span class="std std-ref">FixedHypocenter</span></a>.</p></li>
|
||
</ul>
|
||
<p>Additional locator routines are available by <a class="reference internal" href="../base/concepts/plugins.html#concepts-plugins"><span class="std std-ref">SeisComP plugins</span></a> which
|
||
provide their own specific global configuration. Read the
|
||
<a class="reference internal" href="../base/concepts/locators.html#concepts-locators"><span class="std std-ref">concepts section on locators</span></a> for an introduction.</p>
|
||
<p>Pressing <em>Relocate</em> creates a new origin and updates the arrival table and the
|
||
parameters displayed in the Location tab.</p>
|
||
<p>Undoing and redoing actions is availalbe by buttons and
|
||
<a class="reference internal" href="#sec-scolv-hotkeys"><span class="std std-ref">hot keys</span></a>.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/tab_previous-next.png" src="../_images/tab_previous-next.png" />
|
||
</figure>
|
||
<div class="admonition hint">
|
||
<p class="admonition-title">Hint</p>
|
||
<p>You need to create a new origin for <a class="reference internal" href="#scolv-sec-magnitudes"><span class="std std-ref">computing magnitudes</span></a>.</p>
|
||
</div>
|
||
</section>
|
||
<section id="compute-magnitudes">
|
||
<span id="scolv-sec-magnitudes"></span><h3>Compute magnitudes<a class="headerlink" href="#compute-magnitudes" title="Permalink to this heading">¶</a></h3>
|
||
<p>When an event was <a class="reference internal" href="#scolv-sec-relocating"><span class="std std-ref">relocated</span></a> a new origin is created
|
||
and new magnitudes can be calculated by using the
|
||
“Compute Magnitudes” button. The advantage of calculating the magnitudes before
|
||
committing the new origin, is the possibility to check the resulting magnitudes
|
||
before they are computed manually by <a class="reference internal" href="scmag.html#scmag"><span class="std std-ref">scmag</span></a>.</p>
|
||
<p><a class="reference internal" href="#fig-scolv-location-amp-status"><span class="std std-ref">An amplitudes status window</span></a> will pop up showing the progress
|
||
information of measurements. The amplitudes are either measured or fetched from
|
||
database if the pick is unchanged and the amplitude is already in the system.
|
||
For new manual picks, waveforms are requested to measured the amplitudes. The
|
||
popup window contains information about the progress, limitations and possible
|
||
errors.</p>
|
||
<figure class="align-center" id="id18">
|
||
<span id="fig-scolv-location-amp-status"></span><img alt="../_images/tab_location_amp_status.png" src="../_images/tab_location_amp_status.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">Measure amplitudes status window.</span><a class="headerlink" href="#id18" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<p>After closing the amplitude status window magnitudes are computed and
|
||
possible limitations are shown, if applicable, in the magnitudes status window.
|
||
Confirm this window in order to proceed.</p>
|
||
<figure class="align-center" id="id19">
|
||
<span id="fig-scolv-location-mag-status"></span><img alt="../_images/tab_location_mag_status.png" src="../_images/tab_location_mag_status.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">Compute magnitudes status window.</span><a class="headerlink" href="#id19" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<p>All available magnitudes are then shown and can be interactively re-processed in
|
||
the <a class="reference internal" href="#scolv-sec-magnitude-tab"><span class="std std-ref">Magnitudes tab</span></a>.</p>
|
||
</section>
|
||
<section id="commit-a-solution">
|
||
<span id="scolv-sec-commit"></span><h3>Commit a solution<a class="headerlink" href="#commit-a-solution" title="Permalink to this heading">¶</a></h3>
|
||
<p>Committing a solution means to send the location (including optional magnitudes)
|
||
to the processing system and let it decide what origin becomes preferred.</p>
|
||
<p>To optimize the workflow</p>
|
||
<ol class="arabic simple">
|
||
<li><p>Select an event</p></li>
|
||
<li><p>Review solution</p></li>
|
||
<li><p>Commit solution</p></li>
|
||
<li><p><em>Optional:</em> Change to Event tab for setting</p>
|
||
<ul class="simple">
|
||
<li><p>This solution preferred</p></li>
|
||
<li><p>Event type</p></li>
|
||
<li><p>Event certainty</p></li>
|
||
<li><p>Preferred magnitude</p></li>
|
||
<li><p>Preferred focal mechanism</p></li>
|
||
</ul>
|
||
</li>
|
||
<li><p>Change to Events tab</p></li>
|
||
<li><p>Goto 1.</p></li>
|
||
</ol>
|
||
<p>Instead of selecting events from the Events tab, the previous or the next event
|
||
can be conveniently selected from the edit buttons above the Location tab.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/tab_previous-next.png" src="../_images/tab_previous-next.png" />
|
||
</figure>
|
||
<section id="additional-options">
|
||
<span id="scolv-sec-commit-additional"></span><h4>Additional options<a class="headerlink" href="#additional-options" title="Permalink to this heading">¶</a></h4>
|
||
<p>Instead of optionally setting parameters in the Event tab an additional commit
|
||
mode allows to directly set certain parameters such as</p>
|
||
<ul class="simple">
|
||
<li><p>Event type</p></li>
|
||
<li><p>Ovent certainty</p></li>
|
||
<li><p>Origin</p></li>
|
||
<li><p>Event comment</p></li>
|
||
</ul>
|
||
<p>and to choose options along with the location and its magnitudes. After pressing
|
||
and holding the Commit button down for a little while, a menu pops up which
|
||
allows to select <em>With additional options</em>.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/commit-options.png" src="../_images/commit-options.png" />
|
||
</figure>
|
||
<p>Selecting this entry
|
||
brings up another window where the different options can be set.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/commit-options2.png" src="../_images/commit-options2.png" />
|
||
</figure>
|
||
<p>It allows to fix the origin to be committed as preferred origin and to set the
|
||
event type in one go. If <em>Return to event list after commit</em> is ticked, the
|
||
event list is activated after pressing OK to select another event quickly.</p>
|
||
<dl class="simple">
|
||
<dt><em>Earthquake name</em></dt><dd><p>Contains the event description <em>earthquake name</em>. If this field is empty, the
|
||
description will be removed from the event otherwise it will be added.</p>
|
||
</dd>
|
||
<dt><em>Comment</em></dt><dd><p>Contains an optional event comment added as comment with ID <em>Operator</em>. The
|
||
comment text can be visualized in event lists
|
||
(<a class="reference internal" href="#scolv-events-tab"><span class="std std-ref">Events tab</span></a>) by configuration of the global parameters
|
||
<a class="reference internal" href="global_gui.html#confval-eventlist.customColumn.eventCommentID"><code class="xref std std-confval docutils literal notranslate"><span class="pre">eventlist.customColumn.eventCommentID</span></code></a> or <code class="xref std std-confval docutils literal notranslate"><span class="pre">eventlist.scripts.*</span></code>.</p>
|
||
</dd>
|
||
</dl>
|
||
</section>
|
||
<section id="custom-commits">
|
||
<span id="sec-scolv-custom-commit"></span><h4>Custom commits<a class="headerlink" href="#custom-commits" title="Permalink to this heading">¶</a></h4>
|
||
<p>As a shortcut for committing with additional options,
|
||
<a class="reference internal" href="#fig-scolv-custom-commit"><span class="std std-ref">custom commit buttons</span></a> can be added by
|
||
configuration: Add, enable and configure a custom commit profile in
|
||
<code class="xref std std-confval docutils literal notranslate"><span class="pre">olv.customCommits</span></code>.
|
||
With custom commit buttons origin and event paramters can be set, e.g.:</p>
|
||
<ul class="simple">
|
||
<li><p>Origin status</p></li>
|
||
<li><p>Fixing the origin</p></li>
|
||
<li><p>Event type</p></li>
|
||
<li><p>Event type certainty</p></li>
|
||
<li><p>Magnitude type of the <a class="reference internal" href="../base/glossary.html#term-preferred-magnitude"><span class="xref std std-term">preferred magnitude</span></a>. The preferred magnitude
|
||
can also be set in the <a class="reference internal" href="#scolv-sec-magnitude-summary"><span class="std std-ref">magnitude tab</span></a>.</p></li>
|
||
<li><p>Event comments</p></li>
|
||
</ul>
|
||
<figure class="align-center" id="id20">
|
||
<span id="fig-scolv-custom-commit"></span><a class="reference internal image-reference" href="../_images/commit-custom.png"><img alt="../_images/commit-custom.png" src="../_images/commit-custom.png" style="width: 16cm;" /></a>
|
||
<figcaption>
|
||
<p><span class="caption-text">Custom commit buttons in the Location tab for configured actions and with specific label and color.</span><a class="headerlink" href="#id20" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
</section>
|
||
</section>
|
||
</section>
|
||
<section id="magnitudes-tab">
|
||
<span id="scolv-sec-magnitude-tab"></span><h2>Magnitudes Tab<a class="headerlink" href="#magnitudes-tab" title="Permalink to this heading">¶</a></h2>
|
||
<p>The Magnitude tab shows all available magnitude information for the current
|
||
origin. They can be recomputed after creating a new origin, e.g. by relocating.</p>
|
||
<figure class="align-center" id="id21">
|
||
<span id="fig-scolv-magnitudes"></span><a class="reference internal image-reference" href="../_images/tab_magnitudes.png"><img alt="../_images/tab_magnitudes.png" src="../_images/tab_magnitudes.png" style="width: 16cm;" /></a>
|
||
<figcaption>
|
||
<p><span class="caption-text">Magnitudes tab of scolv.</span><a class="headerlink" href="#id21" title="Permalink to this image">¶</a></p>
|
||
<div class="legend">
|
||
<p>(<strong>Map</strong>) Map with residual and status of the station magnitude, filled
|
||
circles show stations which delivered a magnitude, empty circles represent
|
||
for which no magnitude was calculated
|
||
(<strong>Magnitude tabs</strong>) Each magnitude and the residuals are displayed in a
|
||
separate tab, no residuals are displayed for deduced magnitudes like
|
||
Mw(mB) or M
|
||
(<strong>Information</strong>) Magnitude information including network magnitude value,
|
||
magnitude error, number of used and available station magnitudes and
|
||
minimum/maximum station magnitude
|
||
(<strong>List</strong>) Station magnitude table with weights
|
||
(<strong>Plot</strong>) Station magnitude residual from network magnitude (distance
|
||
over residual)
|
||
(<strong>Weighting</strong>) Weighting scheme for the network magnitude
|
||
(<strong>B1</strong>) Recalculation of the network magnitudes
|
||
(<strong>B2</strong>) Open waveform review</p>
|
||
</div>
|
||
</figcaption>
|
||
</figure>
|
||
<section id="station-magnitudes">
|
||
<span id="scolv-sec-magnitude-station"></span><h3>Station magnitudes<a class="headerlink" href="#station-magnitudes" title="Permalink to this heading">¶</a></h3>
|
||
<p>For each of the different magnitude types (e.g. mb, mB, MLv, Mw(mB)),
|
||
the <a class="reference internal" href="scmag.html#scmag-stationm"><span class="std std-ref">station magnitudes</span></a> are shown in the magnitude residual plot and the table.
|
||
The residual plot visualizes the difference between the station magnitude and
|
||
the network magnitude for the different station distances. After relocation the
|
||
magnitudes can be recalculated by the “Compute Magnitudes” button in the
|
||
Location tab.</p>
|
||
<p>The station magnitudes can also be recalculated by
|
||
<a class="reference internal" href="#scolv-sec-amplitude-review"><span class="std std-ref">interactive waveform analysis</span></a>. Press the B2 button to
|
||
start the interactive analysis.</p>
|
||
<div class="admonition important">
|
||
<p class="admonition-title">Important</p>
|
||
<p>Magnitudes cannot be recalculated for origins loaded from
|
||
database. To review magnitudes, create a new origin (relocate), recompute
|
||
magnitudes and then change into this tab to open either the waveform
|
||
review window or to just remove outliers.</p>
|
||
</div>
|
||
</section>
|
||
<section id="network-magnitudes">
|
||
<span id="scolv-sec-magnitude-network"></span><h3>Network magnitudes<a class="headerlink" href="#network-magnitudes" title="Permalink to this heading">¶</a></h3>
|
||
<p><a class="reference internal" href="scmag.html#scmag-networkm"><span class="std std-ref">Network magnitudes</span></a> are computed from corresponding
|
||
<a class="reference internal" href="scmag.html#scmag-stationm"><span class="std std-ref">station magnitudes</span></a>.
|
||
The considered station magnitudes can be selected or unselected in the
|
||
list and in the plot of station magnitudes. The method, the status and the margins
|
||
to disregard outliers can be selected.
|
||
Normally, the 25%-trimmed mean is calculated as network magnitude to stabilize
|
||
the result against a few outliers. The 25%-trimmed mean first removes the outliers
|
||
of the outer 12.5% percentiles and then forms the mean.</p>
|
||
<p>Magnitudes that were not computed due to missing data or low signa-to-noise
|
||
ratios have a cross button rendered in their tab headers and their value is
|
||
nan (not a number). Furthermore was the status of the magnitude set to
|
||
rejected. To manually review the waveforms and to fine tune the
|
||
parameters, open the waveforms and add at least one station magnitude. Otherwise
|
||
the rejected magnitude will be removed from the origin prio to committing it.</p>
|
||
</section>
|
||
<section id="summary-magnitude">
|
||
<span id="scolv-sec-magnitude-summary"></span><h3>Summary magnitude<a class="headerlink" href="#summary-magnitude" title="Permalink to this heading">¶</a></h3>
|
||
<p>The <a class="reference internal" href="scmag.html#scmag-summarym"><span class="std std-ref">summary magnitude</span></a> typically is calculated from all network magnitudes
|
||
by <a class="reference internal" href="scmag.html#scmag"><span class="std std-ref">scmag</span></a> and set as preferred magnitude type by <a class="reference internal" href="scevent.html#scevent"><span class="std std-ref">scevent</span></a> after committing
|
||
or confirming an origin. The defaults can be changed by configuring <a class="reference internal" href="scmag.html#scmag"><span class="std std-ref">scmag</span></a>
|
||
and <a class="reference internal" href="scevent.html#scevent"><span class="std std-ref">scevent</span></a>.</p>
|
||
<p>However, in combination with <a class="reference internal" href="#sec-scolv-custom-commit"><span class="std std-ref">custom commit buttons</span></a>,
|
||
the network magnitude to be considered as the preferred can be set by hitting this
|
||
configured button or interactively in the <a class="reference internal" href="#fig-scolv-magnitudes"><span class="std std-ref">magnitude tab</span></a>
|
||
of scolv. Interactively check the box in the network magnitudes tab, then press the
|
||
custom commit button. Setting the preferred magnitude interactively in the magnitude
|
||
tab takes priority over the configuration of the custom commit button.</p>
|
||
</section>
|
||
<section id="waveform-review">
|
||
<span id="scolv-sec-amplitude-review"></span><h3>Waveform review<a class="headerlink" href="#waveform-review" title="Permalink to this heading">¶</a></h3>
|
||
<p>The magnitude review page also allows the review of waveforms.
|
||
The button <em>Waveforms</em> brings up the amplitude waveform review page.
|
||
The waveform review magnitude type is the same as the currently active tab.</p>
|
||
<figure class="align-center">
|
||
<a class="reference internal image-reference" href="../_images/magnitudes-waveforms.png"><img alt="../_images/magnitudes-waveforms.png" src="../_images/magnitudes-waveforms.png" style="width: 16cm;" /></a>
|
||
</figure>
|
||
<p>The initial view loads all traces of all arrivals within the defined distance
|
||
for that magnitude type. The zoom trace shows all components required for this
|
||
particular amplitude type and the lower part shows all stations and only the
|
||
currently active component. All traces are aligned on trigger time (blue P marker).
|
||
If a station has got an amplitude, it shows up as a red (automatic
|
||
determined amplitude) or green (manually determined amplitude) marker.
|
||
This display is similar to the Picker.</p>
|
||
<p>The toolbar contains two lines of settings. The first line is similar to the
|
||
Picker, the second line is amplitude picker specific.</p>
|
||
<figure class="align-center" id="id22">
|
||
<img alt="../_images/magnitudes-toolbar.png" src="../_images/magnitudes-toolbar.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">Second toolbar line: filter selection, filter toggle, min SNR editor,
|
||
amplitude measurement type selector, amplitude combiner selector,
|
||
(re)calculate amplitudes, apply amplitudes.</span><a class="headerlink" href="#id22" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<p>A station trace is divided into three areas:</p>
|
||
<ul class="simple">
|
||
<li><p>Dark gray: unused data</p></li>
|
||
<li><p>Light gray: data used for noise offset and noise amplitude</p></li>
|
||
<li><p>White: data used for amplitude calculation</p></li>
|
||
</ul>
|
||
<p>The example above shows nicely how different data time windows are used for
|
||
amplitude determination depending on the distance. This depends on the
|
||
amplitude type and its implementation.</p>
|
||
<p>Available actions are:</p>
|
||
<ul class="simple">
|
||
<li><p>Show raw data</p></li>
|
||
<li><p>Change processing settings</p></li>
|
||
<li><p>Adjust processing areas (noise, signal) for a single trace or all traces</p></li>
|
||
<li><p>Apply a secondary filter (e.g. to remove noise or low frequencies)</p></li>
|
||
<li><p>Pick amplitudes within a user definable time window</p></li>
|
||
<li><p>Add unpicked/unassociated stations that are within a certain distance</p></li>
|
||
<li><p>Remove bad stations</p></li>
|
||
</ul>
|
||
<section id="filtered-and-raw-data">
|
||
<h4>Filtered and raw data<a class="headerlink" href="#filtered-and-raw-data" title="Permalink to this heading">¶</a></h4>
|
||
<p>By default the processed waveforms are displayed. The processing is defined by
|
||
the magnitude type. To view the raw waveforms change the filter drop down box
|
||
to <em>Raw</em>.</p>
|
||
</section>
|
||
<section id="processing-settings">
|
||
<h4>Processing settings<a class="headerlink" href="#processing-settings" title="Permalink to this heading">¶</a></h4>
|
||
<p>A basic amplitude processor uses two basic settings: Minimum signal/noise
|
||
ratio (SNR) and data time windows. The default minimum SNR is defined by the
|
||
implementation of the amplitude algorithm. This default SNR is shown in the
|
||
toolbar right from <em>Min SNR:</em>. In some situations an operator might want to
|
||
increase or decrease the minimum SNR for some reason. This can be done by
|
||
modifying the value in the corresponding spin box.</p>
|
||
<p>In the time scale of the zoom widget and the overview three black triangles are
|
||
visible. Those triangles can be used to adjust the data time windows of either
|
||
the zoom trace (upper part) or all traces (lower part) by dragging the handle
|
||
with the left mouse button.</p>
|
||
<p>Some amplitude processors allow the modification of the type of amplitude
|
||
measurement (e.g. absolute maximum or peak-to-peak) and/or the amplitude
|
||
combiner procedure. This procedure is mostly used when a final amplitude from
|
||
two components is computed, e.g. ML on the horizontals. The combiner procedure
|
||
defines how the amplitudes of each horizontal are combined to a single amplitude,
|
||
e.g. by taking the maximum of both or the average.</p>
|
||
<p>If the amplitude processor allows any of these options, the corresponding drop
|
||
down boxes are enabled in the toolbar and can be used to change the defaults.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>Amplitudes are not recalculated if any changes to the settings are
|
||
made. Recalculation has to be activated manually (see below).</p>
|
||
</div>
|
||
</section>
|
||
<section id="secondary-filters">
|
||
<h4>Secondary filters<a class="headerlink" href="#secondary-filters" title="Permalink to this heading">¶</a></h4>
|
||
<p>Another option is to filter the data additionally to the internal filter of the
|
||
amplitude processor. Be warned that wrongly applied filters screw up the results.
|
||
The available filters can be defined in the settings dialog of scolv or in the
|
||
configuration file similar to the manual picker filters (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># List of filters available in the picker. Format:</span>
|
||
<span class="c1"># "name1;filter-definition1", "name2;filter-definition2"</span>
|
||
<span class="na">amplitudePicker.filters</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"4 pole HP @2s;BW_HP(4,0.5)"</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>The new filter selection is applied immediately to the waveforms while the amplitudes are not recalculated
|
||
(see next section).</p>
|
||
</section>
|
||
<section id="calculate-amplitudes">
|
||
<h4>Calculate amplitudes<a class="headerlink" href="#calculate-amplitudes" title="Permalink to this heading">¶</a></h4>
|
||
<p>To calculate the amplitudes of all traces with the current settings press the
|
||
green check in the toolbar. It will process all traces and recalculate the
|
||
amplitudes within the shown time windows. If an error occurs, it will show up as
|
||
a small message box in the station trace itself. If a new amplitude is available,
|
||
its state is set to manual and the marker is updated to reflect the new position
|
||
of the amplitude. If the mouse hovers an amplitude marker, a tooltip pops up
|
||
after a certain amount of time and shows information about the amplitude.</p>
|
||
<figure class="align-center">
|
||
<img alt="../_images/amplitude-tooltip.png" src="../_images/amplitude-tooltip.png" />
|
||
</figure>
|
||
</section>
|
||
<section id="pick-amplitudes">
|
||
<h4>Pick amplitudes<a class="headerlink" href="#pick-amplitudes" title="Permalink to this heading">¶</a></h4>
|
||
<p>In addition to the default picking of all stations it is also possible to
|
||
define the time window of the amplitude of a station manually. To do so,
|
||
activate picking by pressing <kbd class="kbd docutils literal notranslate">1</kbd> or in the main menu:
|
||
<span class="menuselection">Amplitudes ‣ Pick amplitudes</span>.</p>
|
||
<p>There are two modes of picking:</p>
|
||
<ol class="arabic simple">
|
||
<li><p>Create a time window by pressing with left mouse button at the start time and
|
||
releasing at the end time, or</p></li>
|
||
<li><p>Double click at a time and use a time window of [t-0.5sec;t+0.5sec]</p></li>
|
||
</ol>
|
||
</section>
|
||
<section id="add-stations-in-range">
|
||
<h4>Add stations in range<a class="headerlink" href="#add-stations-in-range" title="Permalink to this heading">¶</a></h4>
|
||
<p>Unpicked or unassociated stations can be added the same way as in the manual
|
||
picker. The new stations will not have an amplitude and need either manual
|
||
picking or global amplitude recalculation.</p>
|
||
</section>
|
||
<section id="remove-bad-stations">
|
||
<h4>Remove bad stations<a class="headerlink" href="#remove-bad-stations" title="Permalink to this heading">¶</a></h4>
|
||
<p>Stations can be disabled by either double clicking on the trace label in the
|
||
overview or by deactivating an amplitude similar to deactivating a pick.</p>
|
||
</section>
|
||
<section id="confirm-the-amplitudes">
|
||
<h4>Confirm the amplitudes<a class="headerlink" href="#confirm-the-amplitudes" title="Permalink to this heading">¶</a></h4>
|
||
<p>The red button in the toolbar confirms all amplitudes and transfers them to the
|
||
magnitude review page. Only activated amplitudes are transferred. Disabled
|
||
stations or disabled amplitudes are ignored. At this stage all magnitudes are
|
||
calculated and the network magnitude is calculated according to the available
|
||
settings: <em>Mean</em>, <em>Median</em> or <em>Trimmed mean</em>.</p>
|
||
</section>
|
||
</section>
|
||
</section>
|
||
<section id="event-tab">
|
||
<span id="scolv-sec-event-tab"></span><h2>Event Tab<a class="headerlink" href="#event-tab" title="Permalink to this heading">¶</a></h2>
|
||
<p>The Event tab gives all information of associated origins and magnitude of the
|
||
actual event. Here the selection of the preferred origin and preferred magnitude
|
||
can be influenced independent from <a class="reference internal" href="scevent.html#scevent"><span class="std std-ref">scevent</span></a>. The messaging between
|
||
scevent and scolv about the selected origins and magnitudes can be viewed in
|
||
a window that has to be opened by pulling the left side frame to the right.</p>
|
||
<figure class="align-center" id="id23">
|
||
<span id="fig-scolv-event"></span><a class="reference internal image-reference" href="../_images/tab_event.png"><img alt="../_images/tab_event.png" src="../_images/tab_event.png" style="width: 16cm;" /></a>
|
||
<figcaption>
|
||
<p><span class="caption-text">Event tab of scolv.</span><a class="headerlink" href="#id23" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<ul class="simple">
|
||
<li><p><strong>Origin list:</strong> List of all associated origins
|
||
* <strong>B1</strong> Selector for the event type
|
||
* <strong>B2</strong> Button to fix the selected origin as preferred
|
||
* <strong>B3</strong> Button to let <a class="reference internal" href="scevent.html#scevent"><span class="std std-ref">scevent</span></a> select the preferred origin</p></li>
|
||
<li><p><strong>Magnitude list</strong> List of magnitudes of the actual origin
|
||
* <strong>B4</strong> Button to fix the selected magnitude as preferred
|
||
* <strong>B5</strong> Button to let <a class="reference internal" href="scevent.html#scevent"><span class="std std-ref">scevent</span></a> select the preferred magnitude</p></li>
|
||
<li><p><strong>Focal Mechanism:</strong> List of all focal mechanisms associated to the selected event.</p></li>
|
||
</ul>
|
||
<p>The map (lower left part) shows all associated origins while the currently
|
||
selected origin (<strong>Origin list</strong>) is drawn filled.</p>
|
||
<section id="origin-list">
|
||
<span id="scolv-origin-list"></span><h3>Origin list<a class="headerlink" href="#origin-list" title="Permalink to this heading">¶</a></h3>
|
||
<p>The Origin list shows details of all available origins. You may fix/unfix an
|
||
origin to become the preferred one or select the type and set
|
||
the type uncertainty for the selected sevent.</p>
|
||
<p>Select a row or cell and
|
||
press the right mouse button to copy the row or cell, respectively.
|
||
The <em>Stat</em> column indicates a combination of the mode and the status of the origin.</p>
|
||
<p id="scolv-origin-mode">The mode is color coded:</p>
|
||
<ul class="simple">
|
||
<li><p><strong>Red</strong>: automatic</p></li>
|
||
<li><p><strong>Green</strong>: manual</p></li>
|
||
</ul>
|
||
<p id="scolv-origin-status">The status is coded by a single character:</p>
|
||
<ul class="simple">
|
||
<li><p><strong>A</strong>: unset, status not specifically set, e.g. usually automatic origins from <a class="reference internal" href="scautoloc.html#scautoloc"><span class="std std-ref">scautoloc</span></a></p></li>
|
||
<li><p><strong>F</strong>: final</p></li>
|
||
<li><p><strong>V</strong>: reviewed</p></li>
|
||
<li><p><strong>C</strong>: confirmed</p></li>
|
||
<li><p><strong>P</strong>: preliminary, e.g. XXL origins from <a class="reference internal" href="scautoloc.html#scautoloc"><span class="std std-ref">scautoloc</span></a></p></li>
|
||
<li><p><strong>R</strong>: reported</p></li>
|
||
<li><p><strong>X</strong>: rejected</p></li>
|
||
</ul>
|
||
</section>
|
||
<section id="magnitude-list">
|
||
<span id="scolv-magnitude-list"></span><h3>Magnitude list<a class="headerlink" href="#magnitude-list" title="Permalink to this heading">¶</a></h3>
|
||
<p>The magnitude list shows all available magnitudes available for the origin
|
||
selected in the <a class="reference internal" href="#scolv-origin-list"><span class="std std-ref">Origin list</span></a>. You may fix/unfix a
|
||
magnitude type to become the preferred magnitude.</p>
|
||
<p>Select a row or cell and
|
||
press the right mouse button to copy the row or cell, respectively.</p>
|
||
</section>
|
||
<section id="focal-mechanism-list">
|
||
<span id="scolv-fm-list"></span><h3>Focal Mechanism list<a class="headerlink" href="#focal-mechanism-list" title="Permalink to this heading">¶</a></h3>
|
||
<p>The Focal Mechanism tab shows all focal mechanisms and moment tensors associated
|
||
to the selected event. You may fix the preferred mechanism or fix/unfix
|
||
<a class="reference internal" href="../base/glossary.html#term-magnitude-moment-Mw"><span class="xref std std-term">Mw</span></a> to become the preferred magnitude.</p>
|
||
<p>Select a row or cell and
|
||
press the right mouse button to copy the row or cell, respectively.</p>
|
||
</section>
|
||
</section>
|
||
<section id="events-tab">
|
||
<span id="scolv-events-tab"></span><h2>Events Tab<a class="headerlink" href="#events-tab" title="Permalink to this heading">¶</a></h2>
|
||
<p>The Events tab gives an overview of the events in the defined time span. Listed
|
||
events are updated in real time as new events arrive in <cite>SeisComP</cite> or are loaded
|
||
from the database. The title of the tab also indicates the number of shown vs.
|
||
the total number of loaded events. The numbers can be different because events
|
||
can be <a class="reference internal" href="#scolv-events-filtering"><span class="std std-ref">hidden from the list by filtering</span></a>.</p>
|
||
<p>When starting scolv with the option <strong>–offline</strong>, events can also be loaded from an XML
|
||
file using the File menu in the main window.</p>
|
||
<figure class="align-center" id="id24">
|
||
<span id="fig-scolv-events"></span><a class="reference internal image-reference" href="../_images/tab_events.png"><img alt="../_images/tab_events.png" src="../_images/tab_events.png" style="width: 16cm;" /></a>
|
||
<figcaption>
|
||
<p><span class="caption-text">scolv Events tab with the list of events and the filter window.</span><a class="headerlink" href="#id24" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<p>Information about origin time, preferred (“best”) magnitude, preferred magnitude
|
||
type, number of phases, epicenter and depth, origin status, region, agency and
|
||
event/origin ID are similar to the event list in <a class="reference internal" href="scesv.html#scesv"><span class="std std-ref">scesv</span></a>. Additionally,
|
||
all origins associated with one event are displayed if an event item is expanded.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>The region name of an event is read from the database or received via the
|
||
messaging bus. It is an integral part of the event description and set based
|
||
on the data set available at the time of the event creation. The region name
|
||
of the origins is not part of the origin description and resolved dynamically
|
||
when the information is required. That can lead to confusion if the dataset
|
||
of the computer where the event has been created and the local dataset
|
||
differs. Therefore the region names resolved locally are rendered with italic
|
||
font style.</p>
|
||
</div>
|
||
<section id="events-table">
|
||
<h3>Events table<a class="headerlink" href="#events-table" title="Permalink to this heading">¶</a></h3>
|
||
<p>As with the arrival table the shown columns of the list are also configurable.
|
||
The available identifiers are:</p>
|
||
<ul class="simple">
|
||
<li><p><strong>OT(GMT)</strong> : origin time</p></li>
|
||
<li><p><strong>Type</strong> : event type</p></li>
|
||
<li><p>M : magnitude</p></li>
|
||
<li><p><strong>MType</strong> : magnitude type</p></li>
|
||
<li><p><strong>Phases</strong> : number of used phases</p></li>
|
||
<li><p><strong>RMS</strong> : root-mean square travel-time residual</p></li>
|
||
<li><p>AzGap: largest azimuthal gap between two neighboring stations of an origin</p></li>
|
||
<li><p><strong>Lat</strong> : latitude</p></li>
|
||
<li><p><strong>Lon</strong> : longitude</p></li>
|
||
<li><p><strong>Depth</strong> : depth</p></li>
|
||
<li><p>DType : depth type</p></li>
|
||
<li><p><strong>Stat</strong> : a combination of the <a class="reference internal" href="#scolv-origin-mode"><span class="std std-ref">color-coded mode</span></a> and
|
||
the <a class="reference internal" href="#scolv-origin-status"><span class="std std-ref">status</span></a> of the preferred origin as described by
|
||
a letter. A trailing “+” indicates that origins were contributed to the event
|
||
by multiple agencies, e.g. “C+”.</p></li>
|
||
<li><p>FM : focal mechanism</p></li>
|
||
<li><p>Origins: number of origins per event</p></li>
|
||
<li><p><strong>Agency</strong> : agency ID</p></li>
|
||
<li><p>Author : author</p></li>
|
||
<li><p><strong>Region</strong> : region name</p></li>
|
||
<li><p><strong>ID</strong> : ID of the show element, e.g. event or origin</p></li>
|
||
</ul>
|
||
<p>The bold identifiers are visible initially by default.
|
||
To show or hide columns interactively click with the right mouse button on the
|
||
table header and check or uncheck the corresponding column.</p>
|
||
<p>Sorting and re-ordering is available by clicking on the header of the columns and
|
||
by dragging the header fields, respectively. Right-click on cells to copy individual
|
||
cells values or entire rows.</p>
|
||
<p>The initial list can configured with the global module parameter
|
||
<a class="reference internal" href="global_gui.html#confval-eventlist.visibleColumns"><code class="xref std std-confval docutils literal notranslate"><span class="pre">eventlist.visibleColumns</span></code></a> in <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code> or <code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>,
|
||
e.g.:</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Remove Type and Author from column list that is initially active</span>
|
||
<span class="na">eventlist.visibleColumns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Type, M, MType Phases, RMS, Lat, Lon, Depth, DType, Stat, FM, Author, Agency, Region, ID</span>
|
||
</pre></div>
|
||
</div>
|
||
</section>
|
||
<section id="event-filtering">
|
||
<span id="scolv-events-filtering"></span><h3>Event filtering<a class="headerlink" href="#event-filtering" title="Permalink to this heading">¶</a></h3>
|
||
<p>Database request filters can be applied interactively or automatically by</p>
|
||
<ul>
|
||
<li><p><strong>Time:</strong> Select a time period or a number of days before current time.</p></li>
|
||
<li><p><strong>Interactive custom request filters</strong>: You may set and adjust a custom request
|
||
filter** in the filter parameter window which opens when pressing the Filter
|
||
button. Press <em>Read</em> to reload the events list based on the filter parameters.
|
||
<strong>The interactive custom request filter only concerns the
|
||
database request for loading events. It does not update the current list.</strong>
|
||
Use the <a class="reference internal" href="global.html#global"><span class="std std-ref">Global parameters</span></a> for presetting the values (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code> or
|
||
<code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>), e.g.:</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">eventlist.filter.database.minlat</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">51.0</span>
|
||
</pre></div>
|
||
</div>
|
||
</li>
|
||
</ul>
|
||
<p>Event lists already loaded from from the database can be filtered by</p>
|
||
<ul class="simple">
|
||
<li><p><strong>Event type:</strong> Activate by check box <em>Hide other/fake events</em>. If checked, all</p></li>
|
||
</ul>
|
||
<p>events with the configured types are hidden from the list. The default event types
|
||
to hide are <em>not existing</em> and <em>other</em> are hidden. If unchecked, the filtering
|
||
is inactive and the events are shown. <strong>Pressing the Hide button only affects
|
||
the currently loaded list.</strong> Configure the event types used for this filter as well
|
||
as the label text for the checkbox.
|
||
Use the <a class="reference internal" href="global.html#global"><span class="std std-ref">Global parameters</span></a> for presetting the values s (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code> or <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define the event types to be filtered</span>
|
||
<span class="na">eventlist.filter.types.blacklist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"not existing", "other",</span><span class="se">\</span>
|
||
<span class="w"> </span><span class="s">"outside of network interest"</span>
|
||
|
||
<span class="c1"># Define the label of the button to filter the events</span>
|
||
<span class="na">eventlist.filter.types.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Hide fake events"</span>
|
||
|
||
<span class="c1"># Define the default behavior</span>
|
||
<span class="na">eventlist.filter.types.enabled</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">true</span>
|
||
</pre></div>
|
||
</div>
|
||
<ul>
|
||
<li><p><strong>Agency</strong>: Activate by check boxes <em>Show only own origin</em> and/or “Show only
|
||
latest/preferred origin per agency”. The button <em>Show only own events</em>
|
||
will hide all events where the preferred origins agencyID is not the configured
|
||
<a class="reference internal" href="global.html#confval-agencyID"><code class="xref std std-confval docutils literal notranslate"><span class="pre">agencyID</span></code></a> of scolv. This is the default behavior which can be customized
|
||
(<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code> or <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Set the preferred agencyIDs to GFZ and EMSC</span>
|
||
<span class="na">eventlist.filter.agencies.whitelist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">GFZ, EMSC</span>
|
||
|
||
<span class="c1"># Set type to 'origins' which means that an event will pass the filter if</span>
|
||
<span class="c1"># at least one origin is from a preferred agency defined with the whitelist</span>
|
||
<span class="c1"># above. The default type is 'events' which checks only the events preferred</span>
|
||
<span class="c1"># origin.</span>
|
||
<span class="na">eventlist.filter.agencies.type</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">origins</span>
|
||
|
||
<span class="c1"># Defines the text of the option "Show only own events".</span>
|
||
<span class="na">eventlist.filter.agencies.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Show only own events"</span>
|
||
|
||
<span class="c1"># Enable this filter initially. If this option is not used, the filter</span>
|
||
<span class="c1"># is disabled by default.</span>
|
||
<span class="na">eventlist.filter.agencies.enabled</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">true</span>
|
||
</pre></div>
|
||
</div>
|
||
</li>
|
||
<li><p><strong>Source region:</strong> Select a source region, activate “Hide events” and choose to
|
||
hide events inside or outside the region.
|
||
<strong>Pressing the Hide button only affects the currently loaded list.</strong>
|
||
Pre-defined regions can be configured in the global configuration per bounding
|
||
box or region defined by a BNA or GeoJSON polygon
|
||
(<code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>, <code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Configured a list of regions that can be used as filter of the result set.</span>
|
||
<span class="na">eventlist.filter.regions.profiles</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">chile</span>
|
||
|
||
<span class="c1"># Defines the name of the region that shows up in the listbox.</span>
|
||
<span class="na">eventlist.filter.regions.region.chile.name</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Chile</span>
|
||
|
||
<span class="c1"># Defines a rectangular region with a list of 4 values: latmin, lonmin, latmax,</span>
|
||
<span class="c1"># lonmax.</span>
|
||
<span class="c1"># eventlist.filter.regions.region.chile.rect = -40, -80, -10, -60</span>
|
||
|
||
<span class="c1"># Defines the name of the polygon for the region check. If defined then the</span>
|
||
<span class="c1"># rect region has no effect. The configured polygon name is being search for in</span>
|
||
<span class="c1"># the global FEP regions and the spatial vector layer. The first polygon found</span>
|
||
<span class="c1"># with the given name will be taken.</span>
|
||
<span class="na">eventlist.filter.regions.region.chile.poly</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">chile</span>
|
||
</pre></div>
|
||
</div>
|
||
</li>
|
||
</ul>
|
||
</section>
|
||
</section>
|
||
<section id="custom-actions">
|
||
<span id="scolv-custom-actions"></span><h2>Custom Actions<a class="headerlink" href="#custom-actions" title="Permalink to this heading">¶</a></h2>
|
||
<p>Since the internal data model is limited, scolv allows
|
||
deriving custom quantities from the event or origin objects. These quantities can
|
||
be displayed or processed further by external script.
|
||
This procedure can help to evaluate origins in a better or more specific way.</p>
|
||
<p>Two sources of information are currently supported</p>
|
||
<ul class="simple">
|
||
<li><p><a class="reference internal" href="#sec-scolv-comments"><span class="std std-ref">Origin comments</span></a> provided along with origins to be
|
||
shown in scolv tabs,</p></li>
|
||
<li><p><a class="reference internal" href="#sec-scolv-scripts"><span class="std std-ref">External scripts</span></a> provided by the <cite>SeisComP</cite> operator
|
||
to extract specific information from events or origins which are shown in tabs
|
||
or processed further.</p></li>
|
||
</ul>
|
||
<section id="origin-comments">
|
||
<span id="sec-scolv-comments"></span><h3>Origin comments<a class="headerlink" href="#origin-comments" title="Permalink to this heading">¶</a></h3>
|
||
<p>Currently only one comment of an origin can be added to the different panels.</p>
|
||
<section id="id2">
|
||
<h4>Location tab<a class="headerlink" href="#id2" title="Permalink to this heading">¶</a></h4>
|
||
<p>To add an origin comment value to the information panel of the Location tab,
|
||
configure display paramters in scolv. Example (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define the comment id to be used</span>
|
||
<span class="na">display.origin.comment.id</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">SED.quality</span>
|
||
|
||
<span class="c1"># Define the default display value if no comment is available</span>
|
||
<span class="na">display.origin.comment.default</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"-"</span>
|
||
|
||
<span class="c1"># Define the label text in the information panel for this value</span>
|
||
<span class="na">display.origin.comment.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Quality</span>
|
||
</pre></div>
|
||
</div>
|
||
</section>
|
||
<section id="id3">
|
||
<h4>Event tab<a class="headerlink" href="#id3" title="Permalink to this heading">¶</a></h4>
|
||
<p>To add a custom column to the <strong>origin list of the Event tab</strong> showing an origin
|
||
comment value, configure eventedit parameters in scolv or global. Example
|
||
(<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code> or <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define the default value if no comment is present</span>
|
||
<span class="na">eventedit.origin.customColumn.default</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"-"</span>
|
||
|
||
<span class="c1"># Define the comment id to be used</span>
|
||
<span class="na">eventedit.origin.customColumn.originCommentID</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">SED.quality</span>
|
||
|
||
<span class="c1"># Define the column header label</span>
|
||
<span class="na">eventedit.origin.customColumn.name</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Qual"</span>
|
||
|
||
<span class="c1"># Define the column position in the table</span>
|
||
<span class="na">eventedit.origin.customColumn.pos</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">4</span>
|
||
|
||
<span class="c1"># Allows to map comment values (strings) to colors. In this case the</span>
|
||
<span class="c1"># comment will have A,B,C or D which is mapped to green, yellow, orange and</span>
|
||
<span class="c1"># red</span>
|
||
<span class="na">eventedit.origin.customColumn.colors</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"A:00FF00","B:rgb(64,192,0)",</span><span class="se">\</span>
|
||
<span class="w"> </span><span class="s">"C:rgb(192,64,0)","D:FF0000"</span>
|
||
</pre></div>
|
||
</div>
|
||
</section>
|
||
<section id="id4">
|
||
<h4>Events tab<a class="headerlink" href="#id4" title="Permalink to this heading">¶</a></h4>
|
||
<p>To add a custom column to the <strong>event list of the Events tab</strong> using a comment
|
||
value, configure eventlist parameters in scolv or global. Example
|
||
(<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code> or <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define the default value if no comment is present</span>
|
||
<span class="na">eventlist.customColumn.default</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"-"</span>
|
||
|
||
<span class="c1"># Define the comment id to be used</span>
|
||
<span class="na">eventlist.customColumn.originCommentID</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"SED.quality"</span>
|
||
|
||
<span class="c1"># Define the column header label</span>
|
||
<span class="na">eventlist.customColumn.name</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Qual"</span>
|
||
|
||
<span class="c1"># Define the column position in the table</span>
|
||
<span class="na">eventlist.customColumn.pos</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">5</span>
|
||
|
||
<span class="c1"># Allows to map comment values (strings) to colors. In this case the</span>
|
||
<span class="c1"># comment will have A,B,C or D which is mapped to green, yellow, orange and</span>
|
||
<span class="c1"># red</span>
|
||
<span class="na">eventlist.customColumn.colors</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"A:00FF00","B:rgb(64,192,0)",</span><span class="se">\</span>
|
||
<span class="w"> </span><span class="s">"C:rgb(192,64,0)","D:FF0000"</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>The last three examples are used to show the <em>SED.quality</em> comment value which
|
||
is set by the <a class="reference internal" href="global_nonlinloc.html#global-nonlinloc"><span class="std std-ref">NonLinLoc locator plugin</span></a>.</p>
|
||
<p>In order to show event comments, e.g.,
|
||
<a class="reference internal" href="#scolv-sec-commit-additional"><span class="std std-ref">set during committing</span></a> replace
|
||
<a class="reference internal" href="global_gui.html#confval-eventlist.customColumn.originCommentID"><code class="xref std std-confval docutils literal notranslate"><span class="pre">eventlist.customColumn.originCommentID</span></code></a> by
|
||
<a class="reference internal" href="global_gui.html#confval-eventlist.customColumn.eventCommentID"><code class="xref std std-confval docutils literal notranslate"><span class="pre">eventlist.customColumn.eventCommentID</span></code></a>:</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define the comment id to be used</span>
|
||
<span class="na">eventlist.customColumn.eventCommentID</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Operator"</span>
|
||
|
||
<span class="c1"># Define the column header label</span>
|
||
<span class="na">eventlist.customColumn.name</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Operator"</span>
|
||
</pre></div>
|
||
</div>
|
||
</section>
|
||
</section>
|
||
<section id="external-scripts">
|
||
<span id="sec-scolv-scripts"></span><h3>External scripts<a class="headerlink" href="#external-scripts" title="Permalink to this heading">¶</a></h3>
|
||
<p>User-defined scripts may generated and executed</p>
|
||
<ul class="simple">
|
||
<li><p>By <a class="reference internal" href="#sec-scolv-buttons"><span class="std std-ref">custom buttons</span></a></p></li>
|
||
<li><p>Automatically to show <a class="reference internal" href="#sec-scolv-information"><span class="std std-ref">custom information</span></a> in the
|
||
Location, Event and the Events tabs.
|
||
The information may include parameters derived from origins.</p></li>
|
||
</ul>
|
||
<section id="custom-buttons">
|
||
<span id="sec-scolv-buttons"></span><h4>Custom buttons<a class="headerlink" href="#custom-buttons" title="Permalink to this heading">¶</a></h4>
|
||
<p>scolv allows to add one custom button to the <strong>Summary window</strong> and two custom
|
||
buttons to the <strong>Location tab</strong>.
|
||
When pressing the custom buttons, user-defined external scripts are executed.
|
||
Configuration (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
||
<ul>
|
||
<li><p>Button in Summary window. Configure: <a class="reference internal" href="#confval-scripts.export"><code class="xref std std-confval docutils literal notranslate"><span class="pre">scripts.export</span></code></a> and read
|
||
<a class="reference internal" href="#confval-scripts.export"><code class="xref std std-confval docutils literal notranslate"><span class="pre">scripts.export</span></code></a> for the description of the parameters passed to the
|
||
script.</p></li>
|
||
<li><p>Up to 2 buttons in Location tab. Configure:</p>
|
||
<ul class="simple">
|
||
<li><p>button1: <a class="reference internal" href="#confval-button0"><code class="xref std std-confval docutils literal notranslate"><span class="pre">button0</span></code></a>, <a class="reference internal" href="#confval-scripts.script0"><code class="xref std std-confval docutils literal notranslate"><span class="pre">scripts.script0</span></code></a>,</p></li>
|
||
<li><p>button2: <a class="reference internal" href="#confval-button1"><code class="xref std std-confval docutils literal notranslate"><span class="pre">button1</span></code></a>, <a class="reference internal" href="#confval-scripts.script1"><code class="xref std std-confval docutils literal notranslate"><span class="pre">scripts.script1</span></code></a>.</p></li>
|
||
</ul>
|
||
<p>Read <a class="reference internal" href="#confval-scripts.script0"><code class="xref std std-confval docutils literal notranslate"><span class="pre">scripts.script0</span></code></a> and <a class="reference internal" href="#confval-scripts.script1"><code class="xref std std-confval docutils literal notranslate"><span class="pre">scripts.script1</span></code></a> for the
|
||
description of the parameters passed to the scripts.</p>
|
||
</li>
|
||
</ul>
|
||
</section>
|
||
<section id="custom-information-in-tabs">
|
||
<span id="sec-scolv-information"></span><h4>Custom information in tabs<a class="headerlink" href="#custom-information-in-tabs" title="Permalink to this heading">¶</a></h4>
|
||
<p>Origin parameters can be derived by external scripts.
|
||
When configured for the scolv tabs <em>Location</em>, <em>Event</em> or <em>Events</em>, scolv will call
|
||
those scripts and writes a binary serialized origin object
|
||
to its standard input. scolv reads the script output and displays this value
|
||
only if the return code of the script is 0.</p>
|
||
<p>Below you find examples for</p>
|
||
<ul class="simple">
|
||
<li><p>Example custom script</p></li>
|
||
<li><p><a class="reference internal" href="#sec-scolv-parameters-location"><span class="std std-ref">Custom information in the Location tab</span></a></p></li>
|
||
<li><p><a class="reference internal" href="#sec-scolv-parameters-event"><span class="std std-ref">Custom information in the Event tab</span></a></p></li>
|
||
<li><p><a class="reference internal" href="#sec-scolv-parameters-events"><span class="std std-ref">Custom information in the Events tab</span></a></p></li>
|
||
</ul>
|
||
<p id="sec-scolv-example-script">Example script reading origin parameters from stdin just returning the standard
|
||
error of the origin:</p>
|
||
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="ch">#!/usr/bin/env seiscomp-python</span>
|
||
<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">print_function</span>
|
||
<span class="kn">import</span> <span class="nn">sys</span>
|
||
<span class="kn">from</span> <span class="nn">seiscomp</span> <span class="kn">import</span> <span class="n">datamodel</span><span class="p">,</span> <span class="n">io</span>
|
||
|
||
<span class="k">def</span> <span class="nf">main</span><span class="p">():</span>
|
||
<span class="n">ar</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">BinaryArchive</span><span class="p">()</span>
|
||
|
||
<span class="c1"># Open standard input</span>
|
||
<span class="k">if</span> <span class="ow">not</span> <span class="n">ar</span><span class="o">.</span><span class="n">open</span><span class="p">(</span><span class="s2">"-"</span><span class="p">):</span>
|
||
<span class="c1"># Hmmm, opening stdin failed</span>
|
||
<span class="k">return</span> <span class="mi">1</span>
|
||
|
||
<span class="c1"># Read the object</span>
|
||
<span class="n">obj</span> <span class="o">=</span> <span class="n">ar</span><span class="o">.</span><span class="n">readObject</span><span class="p">()</span>
|
||
<span class="n">ar</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
|
||
|
||
<span class="c1"># Try to cast obj to an origin</span>
|
||
<span class="n">org</span> <span class="o">=</span> <span class="n">datamodel</span><span class="o">.</span><span class="n">Origin</span><span class="o">.</span><span class="n">Cast</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span>
|
||
<span class="c1"># No origin -> error</span>
|
||
<span class="k">if</span> <span class="ow">not</span> <span class="n">org</span><span class="p">:</span>
|
||
<span class="k">return</span> <span class="mi">1</span>
|
||
|
||
<span class="c1"># Try to print the standard error to stdout</span>
|
||
<span class="k">try</span><span class="p">:</span>
|
||
<span class="nb">print</span><span class="p">(</span><span class="n">org</span><span class="o">.</span><span class="n">quality</span><span class="p">()</span><span class="o">.</span><span class="n">standardError</span><span class="p">())</span>
|
||
<span class="c1"># Field not set, return error</span>
|
||
<span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
|
||
<span class="k">return</span> <span class="mi">1</span>
|
||
|
||
<span class="k">return</span> <span class="mi">0</span>
|
||
|
||
<span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s2">"__main__"</span><span class="p">:</span>
|
||
<span class="n">sys</span><span class="o">.</span><span class="n">exit</span><span class="p">(</span><span class="n">main</span><span class="p">())</span>
|
||
</pre></div>
|
||
</div>
|
||
<div class="admonition important">
|
||
<p class="admonition-title">Important</p>
|
||
<p>The script must be executable. In Linux don’t forget
|
||
to call</p>
|
||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>chmod<span class="w"> </span>+x<span class="w"> </span>/path/to/script
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
<p>As many scripts as necessary for evaluation can be created.</p>
|
||
<div class="admonition warning">
|
||
<p class="admonition-title">Warning</p>
|
||
<p>Calling external scripts causes overhead and can take some time
|
||
depending on the implementation of the script. scolv needs to access the
|
||
database to fetch additional information which it does not need normally.
|
||
The slower the database access, the longer it takes to display the results.</p>
|
||
</div>
|
||
<section id="sec-scolv-parameters-location">
|
||
<span id="id5"></span><h5>Location tab<a class="headerlink" href="#sec-scolv-parameters-location" title="Permalink to this heading">¶</a></h5>
|
||
<p>To add the output of an external custom script to the information panel of the Location tab,
|
||
configure display parameters in scolv. An example script is given
|
||
<a class="reference internal" href="#sec-scolv-example-script"><span class="std std-ref">above</span></a>. Configuration example (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define the available add-ons to be used</span>
|
||
<span class="na">display.origin.addons</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">qual, qual2</span>
|
||
|
||
<span class="c1"># Configure each add-on</span>
|
||
<span class="na">display.origin.addon.qual1.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Qual1"</span>
|
||
<span class="na">display.origin.addon.qual1.script</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"@DATADIR@/scripts/scolv/script1"</span>
|
||
|
||
<span class="na">display.origin.addon.qual2.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Qual2"</span>
|
||
<span class="na">display.origin.addon.qual2.script</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"@DATADIR@/scripts/scolv/script2"</span>
|
||
</pre></div>
|
||
</div>
|
||
</section>
|
||
<section id="sec-scolv-parameters-event">
|
||
<span id="id6"></span><h5>Event tab<a class="headerlink" href="#sec-scolv-parameters-event" title="Permalink to this heading">¶</a></h5>
|
||
<p>Provide the external script and add the output to the <strong>origin list of the Event tab</strong>,
|
||
configure the eventedit parameters in <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code> or <code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>.
|
||
An example script is given <a class="reference internal" href="#sec-scolv-example-script"><span class="std std-ref">above</span></a>.
|
||
Configuration example:</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">eventedit.scripts.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">qual1, qual2</span>
|
||
|
||
<span class="na">eventedit.scripts.column.qual1.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Qual1"</span>
|
||
<span class="na">eventedit.scripts.column.qual1.pos</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">8</span>
|
||
<span class="na">eventedit.scripts.column.qual1.script</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"@DATADIR@/scripts/scolv/script1"</span>
|
||
|
||
<span class="na">eventedit.scripts.column.qual2.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Qual2"</span>
|
||
<span class="na">eventedit.scripts.column.qual2.pos</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">9</span>
|
||
<span class="na">eventedit.scripts.column.qual2.script</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"@DATADIR@/scripts/scolv/script2"</span>
|
||
</pre></div>
|
||
</div>
|
||
</section>
|
||
<section id="sec-scolv-parameters-events">
|
||
<span id="id7"></span><h5>Events tab<a class="headerlink" href="#sec-scolv-parameters-events" title="Permalink to this heading">¶</a></h5>
|
||
<p>From the event list external scripts can be excuted with <a class="reference internal" href="../base/glossary.html#term-origin"><span class="xref std std-term">origin</span></a> or
|
||
<a class="reference internal" href="../base/glossary.html#term-event"><span class="xref std std-term">event</span></a> objects or both as input from stdin to display the output of the
|
||
script (stdout) in a custom column.</p>
|
||
<p>Provide an external script and add the output to <strong>event list of the Events tab</strong>,
|
||
configure the eventlist parameters in <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code> or <code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>.
|
||
An example script is given <a class="reference internal" href="#sec-scolv-example-script"><span class="std std-ref">above</span></a>.
|
||
Configuration example for passing origin or event objects:</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">eventlist.scripts.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">qual1, qual2</span>
|
||
|
||
<span class="na">eventlist.scripts.column.qual1.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Qual1"</span>
|
||
<span class="na">eventlist.scripts.column.qual1.pos</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">5</span>
|
||
<span class="na">eventlist.scripts.column.qual1.script</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"@DATADIR@/scripts/scolv/script1"</span>
|
||
<span class="na">eventlist.scripts.column.qual1.types</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Origin</span>
|
||
|
||
<span class="na">eventlist.scripts.column.qual2.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"Qual2"</span>
|
||
<span class="na">eventlist.scripts.column.qual2.pos</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">6</span>
|
||
<span class="na">eventlist.scripts.column.qual2.script</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">"@DATADIR@/scripts/scolv/script2"</span>
|
||
<span class="na">eventlist.scripts.column.qual2.types</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Event</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>Adding external scripts to the event list is the most expensive part. Whenever
|
||
the event list is reloaded, it will start to run the scripts on all origins
|
||
in the background. It can take a while until the complete list has been
|
||
processed. A progress indicator is plotted in the middle of the event list while
|
||
the background processes are running.</p>
|
||
</section>
|
||
</section>
|
||
</section>
|
||
</section>
|
||
<section id="settings">
|
||
<span id="scolv-settings"></span><h2>Settings<a class="headerlink" href="#settings" title="Permalink to this heading">¶</a></h2>
|
||
<p>All settings of scolv can be adjusted in its <a class="reference internal" href="#scolv-configuration"><span class="std std-ref">configuration file</span></a>.
|
||
However, some settings can be changed on-the-fly. The connection to the messaging
|
||
system and the database can be adjusted in the <em>Setup connection</em> dialog access
|
||
by pressing <kbd class="kbd docutils literal notranslate">F2</kbd>. A window for adjusting scolv settings is
|
||
available which can be opened by pressing <kbd class="kbd docutils literal notranslate">F3</kbd>.</p>
|
||
<div class="admonition warning">
|
||
<p class="admonition-title">Warning</p>
|
||
<p>When pressing the Save button in the scolv settings menu, the parameters will be written
|
||
to <code class="file docutils literal notranslate"><span class="pre">$HOME/.seiscomp/scolv.cfg</span></code> (use mode configuration) where they take
|
||
priority over configurations in <code class="file docutils literal notranslate"><span class="pre">$SEISCOMP_ROOT/etc/scolv.cfg</span></code> (system mode configuration).</p>
|
||
</div>
|
||
<section id="global">
|
||
<h3>Global<a class="headerlink" href="#global" title="Permalink to this heading">¶</a></h3>
|
||
<p>This section contains settings for all the main tabs and <em>all</em> waveform windows.</p>
|
||
<figure class="align-center" id="id25">
|
||
<img alt="../_images/settings-global.png" src="../_images/settings-global.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">Global settings</span><a class="headerlink" href="#id25" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<dl class="simple">
|
||
<dt><em>Reduction velocity</em></dt><dd><p>Sets the reduction velocity used for plot <em>MoveOut</em>.</p>
|
||
</dd>
|
||
<dt><em>Compute magnitudes after relocate</em></dt><dd><p>Automatically computes magnitudes after each relocation. This has the same
|
||
effect as pressing “Compute magnitudes” manually.</p>
|
||
</dd>
|
||
<dt><em>Compute magnitudes silently</em></dt><dd><p>Automatically closes the compute magnitudes dialog if the computation is
|
||
finished and no error occurred.</p>
|
||
</dd>
|
||
<dt><em>Draw grid lines</em></dt><dd><p>Enables dashed grid lines in all plots.</p>
|
||
</dd>
|
||
<dt><em>Data source</em></dt><dd><p>Defines the waveform data source for both, pick review and amplitude review</p>
|
||
</dd>
|
||
<dt><em>Default distance for “add station”</em></dt><dd><p>The default value to add stations (traces) that have not been picked or
|
||
associated is 15 degrees. A lower value can be defined, e.g. if mainly local events are analyzed.</p>
|
||
</dd>
|
||
<dt><em>Hide station traces without data and arrivals</em></dt><dd><p>If new stations are added during pick review or amplitude review and if no
|
||
data is available for some of those stations, they will be hidden and not
|
||
shown. Once data arrives the trace becomes visible.</p>
|
||
</dd>
|
||
</dl>
|
||
</section>
|
||
<section id="picker">
|
||
<h3>Picker<a class="headerlink" href="#picker" title="Permalink to this heading">¶</a></h3>
|
||
<p>This section contains settings for the picker window.</p>
|
||
<figure class="align-center" id="id26">
|
||
<img alt="../_images/settings-picker.png" src="../_images/settings-picker.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">Waveform picker settings</span><a class="headerlink" href="#id26" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<dl class="simple">
|
||
<dt><em>Show cross hair cursor</em></dt><dd><p>Enables the cross hair cursor which shows the currently selected uncertainty
|
||
ranges.</p>
|
||
</dd>
|
||
<dt><em>Uncertainties</em></dt><dd><p>Select the current uncertainty set to be used (<a class="reference internal" href="#confval-picker.uncertainties.preferred"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.uncertainties.preferred</span></code></a>).</p>
|
||
</dd>
|
||
<dt><em>Remove automatic station picks</em></dt><dd><p>If checked all automatic picks of a station with manual picks are removed once
|
||
the manual review is confirmed.</p>
|
||
</dd>
|
||
<dt><em>Remove all automatic picks</em></dt><dd><p>If checked all automatic picks are removed once the manual review is confirmed.</p>
|
||
</dd>
|
||
</dl>
|
||
</section>
|
||
<section id="magnitude-review">
|
||
<h3>Magnitude review<a class="headerlink" href="#magnitude-review" title="Permalink to this heading">¶</a></h3>
|
||
<p>This section contains settings for the magnitude waveform review window.</p>
|
||
<figure class="align-center" id="id27">
|
||
<img alt="../_images/settings-amplitude.png" src="../_images/settings-amplitude.png" />
|
||
<figcaption>
|
||
<p><span class="caption-text">Amplitude/magnitude review settings</span><a class="headerlink" href="#id27" title="Permalink to this image">¶</a></p>
|
||
</figcaption>
|
||
</figure>
|
||
<dl>
|
||
<dt><em>Waveform time window pre offset</em></dt><dd><p>Sets an offset before the used amplitude time window that is used when
|
||
collecting data.</p>
|
||
</dd>
|
||
<dt><em>Waveform time window post offset</em></dt><dd><p>Sets an offset after the used amplitude time window that is used when
|
||
collecting data.</p>
|
||
<p>The greater the offset the more the amplitude time window can be extended or
|
||
shifted.</p>
|
||
</dd>
|
||
</dl>
|
||
</section>
|
||
<section id="units-and-precisions">
|
||
<h3>Units and precisions<a class="headerlink" href="#units-and-precisions" title="Permalink to this heading">¶</a></h3>
|
||
<p>Local network users prefer the distance unit in kilometers while others prefer degrees.
|
||
scolv (as any other GUI) can be configured to show either the one or the other.</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># If true, show distances in km. Use degree otherwise.</span>
|
||
<span class="na">scheme.unit.distanceInKM</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">true</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>Furthermore the precision of various values can be configured:</p>
|
||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># Precision of depth values.</span>
|
||
<span class="na">scheme.precision.depth</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">0</span>
|
||
<span class="c1"># Precision of latitude/longitude values.</span>
|
||
<span class="na">scheme.precision.location</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">2</span>
|
||
<span class="c1"># Precision of magnitude values.</span>
|
||
<span class="na">scheme.precision.magnitude</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">2</span>
|
||
<span class="c1"># Precision of pick times (fractions of seconds).</span>
|
||
<span class="na">scheme.precision.pickTime</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">1</span>
|
||
</pre></div>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>Configuring units and precisions only affects the way the values are presented,
|
||
not the values themselves. These and other lock-and-feel parameters can be
|
||
adjusted in <em>scheme</em> section of the <a class="reference internal" href="global.html#global"><span class="std std-ref">global configuration</span></a>.</p>
|
||
</div>
|
||
</section>
|
||
</section>
|
||
<section id="hotkeys">
|
||
<span id="sec-scolv-hotkeys"></span><h2>Hotkeys<a class="headerlink" href="#hotkeys" title="Permalink to this heading">¶</a></h2>
|
||
<p>The following table describes the available key combinations and their triggered
|
||
actions in scolv. The hotkeys are provided for:</p>
|
||
<ul class="simple">
|
||
<li><p>Main window</p></li>
|
||
<li><p>Picker window</p>
|
||
<ul>
|
||
<li><p>all areas</p></li>
|
||
<li><p>upper area - picking trace</p></li>
|
||
<li><p>lower area - picker overview</p></li>
|
||
</ul>
|
||
</li>
|
||
<li><p>Magnitude waveform window.</p></li>
|
||
</ul>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Shortcut</p></th>
|
||
<th class="head"><p>Description</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><strong>Main window</strong></p></td>
|
||
<td></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>F2</p></td>
|
||
<td><p>Setup connection dialog</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>F3</p></td>
|
||
<td><p>Picker and amplitude settings dialog</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>F8</p></td>
|
||
<td><p>Display left event summary panel</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>F9</p></td>
|
||
<td><p>Show ray paths and associated stations</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>F10</p></td>
|
||
<td><p>Show event list (Events tab)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>F11</p></td>
|
||
<td><p>Toggle fullscreen</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+N</p></td>
|
||
<td><p>Create an unassociated artificial origin at the current map
|
||
center</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+Z</p></td>
|
||
<td><p>Go back to last origin (if available)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+Shift+Z</p></td>
|
||
<td><p>Go to next origin (if available)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+PgUp</p></td>
|
||
<td><p>Load previous event from the event list</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+PgDown</p></td>
|
||
<td><p>Load next event from the event list</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Mouse wheel</p></td>
|
||
<td><p>Zoom map in/out</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Double click</p></td>
|
||
<td><p>Center map at the clicked position</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><strong>Phase picker</strong></p></td>
|
||
<td></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>1 .. 9</p></td>
|
||
<td><p>Activate configured phase picking</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Esc</p></td>
|
||
<td><p>Leaving picking mode</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>F3</p></td>
|
||
<td><p>Add station</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>F5</p></td>
|
||
<td><p>Relocate</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>E</p></td>
|
||
<td><p>Switch to E-component</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>F</p></td>
|
||
<td><p>Toggle between current filter and unfiltered</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Shift+F</p></td>
|
||
<td><p>Toggle limiting filters to the selected trace</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>G</p></td>
|
||
<td><p>Toggle through all configured filters: descending</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>D</p></td>
|
||
<td><p>Toggle through all configured filters: ascending</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>N</p></td>
|
||
<td><p>Switch to N-component</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>S</p></td>
|
||
<td><p>Maximize visible amplitudes</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>X</p></td>
|
||
<td><p>Deactivate a trace and scroll down (through the traces)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Z</p></td>
|
||
<td><p>Switch to Z-component</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Up</p></td>
|
||
<td><p>Scroll up (through the traces)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Down</p></td>
|
||
<td><p>Scroll down (through the traces)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>></p></td>
|
||
<td><p>Increase time scale</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><</p></td>
|
||
<td><p>Decrease time scale</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+S</p></td>
|
||
<td><p>Show Fourier spectrum of selected trace</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+N</p></td>
|
||
<td><p>Default trace view</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+T</p></td>
|
||
<td><p>Toggle display of theoretical arrivals</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+P</p></td>
|
||
<td><p>Toggle display of picks (not arrivals). If picks should
|
||
be shown the first time, all picks within the time span of
|
||
interest are loaded from database. The behavior is the
|
||
same as ticking the option “Load all picks”.</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+Right</p></td>
|
||
<td><p>Time zoom in</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+Left</p></td>
|
||
<td><p>Time zoom out</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+0</p></td>
|
||
<td><p>Align by origin time</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+[1..9]</p></td>
|
||
<td><p>Align on 1st - 9th favorite phase</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+Shift+[1..9]</p></td>
|
||
<td><p>Align on theoretical onset of 1st - 9th favorite phase</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+F1</p></td>
|
||
<td><p>Align on P arrival</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+F2</p></td>
|
||
<td><p>Align on S arrival</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Alt+Right</p></td>
|
||
<td><p>Jump to next marker (picking mode)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Alt+Left</p></td>
|
||
<td><p>Jump to previous marker (picking mode)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>Picking trace</em></p></td>
|
||
<td></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>R</p></td>
|
||
<td><p>Active picker: Repick phase by the selection, e.g. AIC, BK</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>T</p></td>
|
||
<td><p>Temporarily toggle 3 component view</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Space</p></td>
|
||
<td><p>Active picker: Set pick at curser position</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Space</p></td>
|
||
<td><p>Inactive picker: Show Fourier spectrum from visible window</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Enter</p></td>
|
||
<td><p>Active picker: Set pick at curser position, load next trace</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Left</p></td>
|
||
<td><p>Move trace view to left (fine)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Right</p></td>
|
||
<td><p>Move trace view to right (fine)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Shift+Left</p></td>
|
||
<td><p>Move trace view to left (rough)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Shift+Right</p></td>
|
||
<td><p>Move trace view to left (rough)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Shift+Delete</p></td>
|
||
<td><p>Remove polarity from new pick</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Shift+Down</p></td>
|
||
<td><p>Set negative polarity on new pick</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Shift+Up</p></td>
|
||
<td><p>Set positive polarity on new pick</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Shift+X</p></td>
|
||
<td><p>Set positive polarity to undecidable on new pick</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+WheelUp</p></td>
|
||
<td><p>Amplitude zoom in</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+WheelDown</p></td>
|
||
<td><p>Amplitude zoom out</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+Up</p></td>
|
||
<td><p>Amplitude zoom in</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+Down</p></td>
|
||
<td><p>Amplitude zoom out</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Shift+S</p></td>
|
||
<td><p>Toggle spectrogram of selected trace</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Shift+WheelUp</p></td>
|
||
<td><p>Time zoom in</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Shift+WheelDown</p></td>
|
||
<td><p>Time zoom out</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>W</p></td>
|
||
<td><p>Reset zoom window to the length of the picking overview</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>Picking overview</em></p></td>
|
||
<td></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Alt+D</p></td>
|
||
<td><p>Sort by distance</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Alt+R</p></td>
|
||
<td><p>Sort by residual</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+F</p></td>
|
||
<td><p>Search for station code</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+Up</p></td>
|
||
<td><p>Time zoom in</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+Down</p></td>
|
||
<td><p>Time zoom out</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+Shift+WheelUp</p></td>
|
||
<td><p>Time and amplitude zoom in</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+Shift+WheelDown</p></td>
|
||
<td><p>Time and amplitude zoom out</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Y</p></td>
|
||
<td><p>Decrease row height</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Shift+Y</p></td>
|
||
<td><p>Increase row height</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><strong>Amplitude picker</strong></p></td>
|
||
<td></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><em>Zoom trace</em></p></td>
|
||
<td></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+Down</p></td>
|
||
<td><p>Scale amplitudes down</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+Up</p></td>
|
||
<td><p>Scale amplitudes up</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+Right</p></td>
|
||
<td><p>Decrease visible time span (zoom in)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+Left</p></td>
|
||
<td><p>Increase visible time span (zoom out)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>W</p></td>
|
||
<td><p>Reset zoom window to the length of the picking overview</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><em>Trace overview</em></p></td>
|
||
<td></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>F5</p></td>
|
||
<td><p>Compute network magnitudes and return to Magnitudes tab</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>1</p></td>
|
||
<td><p>Pick amplitudes manually</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>ESC</p></td>
|
||
<td><p>Leave picking mode</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>F</p></td>
|
||
<td><p>Toggle filter</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Shift+N</p></td>
|
||
<td><p>Default view</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Left</p></td>
|
||
<td><p>Move trace view to left (fine)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Right</p></td>
|
||
<td><p>Move trace view to right (fine)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Shift+Left</p></td>
|
||
<td><p>Move trace view to left (rough)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Shift+Right</p></td>
|
||
<td><p>Move trace view to left (rough)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>R</p></td>
|
||
<td><p>Recompute amplitude of selected station</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Shift+W</p></td>
|
||
<td><p>Reset all noise and signal time windows as configured</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>X</p></td>
|
||
<td><p>Deactivate selected pick or station</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Y</p></td>
|
||
<td><p>Decrease row height</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Shift+Y</p></td>
|
||
<td><p>Increase row height</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>></p></td>
|
||
<td><p>Increase time scale</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><</p></td>
|
||
<td><p>Decrease time scale</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Alt+A</p></td>
|
||
<td><p>Sort traces by distance</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Alt+D</p></td>
|
||
<td><p>Sort traces by station name</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Alt+D</p></td>
|
||
<td><p>Sort traces by station name</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Left</p></td>
|
||
<td><p>Move trace view to left (fine)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Right</p></td>
|
||
<td><p>Move trace view to right (fine)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Shift+Left</p></td>
|
||
<td><p>Move trace view to left (rough)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p>Ctrl+0</p></td>
|
||
<td><p>Align traces by origin time</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p>Ctrl+1</p></td>
|
||
<td><p>Align traces by trigger time</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</section>
|
||
<section id="module-configuration">
|
||
<span id="scolv-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this heading">¶</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/scolv.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/scolv.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/scolv.cfg</span></code></div>
|
||
</div>
|
||
<p>scolv inherits <a class="reference internal" href="global.html#global-configuration"><span class="std std-ref">global options</span></a>.</p>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-loadEventDB">
|
||
<span class="sig-name descname"><span class="pre">loadEventDB</span></span><a class="headerlink" href="#confval-loadEventDB" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>days</em></p>
|
||
<p>Number of days to preload events from the database when staring scolv.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-magnitudes">
|
||
<span class="sig-name descname"><span class="pre">magnitudes</span></span><a class="headerlink" href="#confval-magnitudes" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">MLv,mb,mB,Mwp</span></code></p>
|
||
<p>Type: <em>list:string</em></p>
|
||
<p>List of magnitude types to be calculated when computing
|
||
magnitudes. This list can be altered interactively so it
|
||
reflects only the default unless computeMagnitudesSilently
|
||
is set to true. The configured types should include all
|
||
types which are also computed by scmag in order to allow
|
||
their processing in scolv. Otherwise scmag may add
|
||
magnitudes to origins without interaction in scolv.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-visibleMagnitudes">
|
||
<span class="sig-name descname"><span class="pre">visibleMagnitudes</span></span><a class="headerlink" href="#confval-visibleMagnitudes" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">M,ML,MLv,mb,mB,Mwp,Mjma,Ms_20,Ms(BB)</span></code></p>
|
||
<p>Type: <em>list:string</em></p>
|
||
<p>A list of magnitude types to be displayed in the summary widget (F8).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-button0">
|
||
<span class="sig-name descname"><span class="pre">button0</span></span><a class="headerlink" href="#confval-button0" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Label of the button that triggers the script defined in
|
||
"scripts.script0".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-button1">
|
||
<span class="sig-name descname"><span class="pre">button1</span></span><a class="headerlink" href="#confval-button1" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Label of the button that triggers the script defined in
|
||
"scripts.script1".</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>scripts.*</strong>
|
||
<em>Define scripts linked to extra buttons. A button is created</em>
|
||
<em>by definition of the corresponding script.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-scripts.export">
|
||
<span class="sig-name descname"><span class="pre">scripts.export</span></span><a class="headerlink" href="#confval-scripts.export" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Full path to the script which enables a publish button in the
|
||
summary panel on the left side of scolv (activated with F8).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-scripts.script0">
|
||
<span class="sig-name descname"><span class="pre">scripts.script0</span></span><a class="headerlink" href="#confval-scripts.script0" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Full path to the script executed when hitting the button labeled with "button0".
|
||
OriginID and EventID are passed to the script as arguments.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-scripts.script1">
|
||
<span class="sig-name descname"><span class="pre">scripts.script1</span></span><a class="headerlink" href="#confval-scripts.script1" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Full path to the script executed when hitting the button labeled with "button1".
|
||
OriginID and EventID are passed to the script as arguments.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-scripts.export.silentTerminate">
|
||
<span class="sig-name descname"><span class="pre">scripts.export.silentTerminate</span></span><a class="headerlink" href="#confval-scripts.export.silentTerminate" 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>string</em></p>
|
||
<p>If the publish button is clicked while another script is
|
||
still running, a message box pops up with a warning that
|
||
a script is still running and to option to terminate it. If
|
||
this flag is true, then it will be terminated automatically
|
||
without user interaction and the warning message.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.defaultEventType">
|
||
<span class="sig-name descname"><span class="pre">olv.defaultEventType</span></span><a class="headerlink" href="#confval-olv.defaultEventType" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Sets the default event type to be used when confirming a solution. If
|
||
not set, the event type is not changed at all unless "with options"
|
||
is used. The origin or its source must be associated with an event already.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.commonEventTypes">
|
||
<span class="sig-name descname"><span class="pre">olv.commonEventTypes</span></span><a class="headerlink" href="#confval-olv.commonEventTypes" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of event types which are commonly set. This defines
|
||
a priority list which will be displayed on top of the event
|
||
type selection menu. Additionally the remaining (non-prioritized)
|
||
types are displayed with less contrast.
|
||
The order is preserved in the event editor as well as in the drop-down
|
||
list of the "Commit with additional options" dialog.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.defaultMagnitudeAggregation">
|
||
<span class="sig-name descname"><span class="pre">olv.defaultMagnitudeAggregation</span></span><a class="headerlink" href="#confval-olv.defaultMagnitudeAggregation" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Sets the default magnitude aggregation method. It can be either "mean",
|
||
"trimmed mean" or "median". If not set, the default
|
||
behavior is used which computes the mean if less than 4 stations are available,
|
||
trimmed mean otherwise.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.computeMagnitudesAfterRelocate">
|
||
<span class="sig-name descname"><span class="pre">olv.computeMagnitudesAfterRelocate</span></span><a class="headerlink" href="#confval-olv.computeMagnitudesAfterRelocate" 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>Automatically starts computation of magnitudes after relocating an
|
||
origin.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.computeMagnitudesSilently">
|
||
<span class="sig-name descname"><span class="pre">olv.computeMagnitudesSilently</span></span><a class="headerlink" href="#confval-olv.computeMagnitudesSilently" 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>Starts magnitude computation without user interaction if everything
|
||
runs without errors. In case of errors a window pops up with
|
||
the current state of processing.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.enableMagnitudeSelection">
|
||
<span class="sig-name descname"><span class="pre">olv.enableMagnitudeSelection</span></span><a class="headerlink" href="#confval-olv.enableMagnitudeSelection" 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>If enabled, a magnitude selection pop window will open
|
||
in advance to compute magnitudes. The default selection
|
||
reflects the configuration parameter "magnitudes".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.Pvel">
|
||
<span class="sig-name descname"><span class="pre">olv.Pvel</span></span><a class="headerlink" href="#confval-olv.Pvel" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">6.0</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>km/s</em></p>
|
||
<p>The velocity applied to reduce travel times in the
|
||
"MoveOut" plot of the Location tab.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.drawMapLines">
|
||
<span class="sig-name descname"><span class="pre">olv.drawMapLines</span></span><a class="headerlink" href="#confval-olv.drawMapLines" 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>Sets the drawing of lines in the map connecting the station with the event.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.drawGridLines">
|
||
<span class="sig-name descname"><span class="pre">olv.drawGridLines</span></span><a class="headerlink" href="#confval-olv.drawGridLines" 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>Sets the drawing of grid lines in the plot.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.computeMissingTakeOffAngles">
|
||
<span class="sig-name descname"><span class="pre">olv.computeMissingTakeOffAngles</span></span><a class="headerlink" href="#confval-olv.computeMissingTakeOffAngles" 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>If a locator does not populate the take off angle in its arrivals,
|
||
the first motion plot will not show picked polarities. This option
|
||
defines whether to compute take off angles that are not present
|
||
in the arrivals or not.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.defaultAddStationsDistance">
|
||
<span class="sig-name descname"><span class="pre">olv.defaultAddStationsDistance</span></span><a class="headerlink" href="#confval-olv.defaultAddStationsDistance" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">15.0</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>deg</em></p>
|
||
<p>The default value for adding unassociated stations in the picker.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.hideStationsWithoutData">
|
||
<span class="sig-name descname"><span class="pre">olv.hideStationsWithoutData</span></span><a class="headerlink" href="#confval-olv.hideStationsWithoutData" 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 enabled, all traces without data and arrivals are
|
||
hidden in the picker.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.hideDisabledStations">
|
||
<span class="sig-name descname"><span class="pre">olv.hideDisabledStations</span></span><a class="headerlink" href="#confval-olv.hideDisabledStations" 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 enabled, all traces of disabled stations without picks are hidden.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.defaultDepth">
|
||
<span class="sig-name descname"><span class="pre">olv.defaultDepth</span></span><a class="headerlink" href="#confval-olv.defaultDepth" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">10.0</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>km</em></p>
|
||
<p>When creating an artificial origin this is the default depth used.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.artificialOriginAdvanced">
|
||
<span class="sig-name descname"><span class="pre">olv.artificialOriginAdvanced</span></span><a class="headerlink" href="#confval-olv.artificialOriginAdvanced" 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>Adds advanced input parameters in artificial origin dialog.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.systemTray">
|
||
<span class="sig-name descname"><span class="pre">olv.systemTray</span></span><a class="headerlink" href="#confval-olv.systemTray" 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>Adds an icon to the system tray and displays a message
|
||
when a new event was received.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.originComments">
|
||
<span class="sig-name descname"><span class="pre">olv.originComments</span></span><a class="headerlink" href="#confval-olv.originComments" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of origin comment profiles. These profiles will be
|
||
used to populate origin comments when committing an origin.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.magnitudeComments">
|
||
<span class="sig-name descname"><span class="pre">olv.magnitudeComments</span></span><a class="headerlink" href="#confval-olv.magnitudeComments" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of magnitude comment profiles. These profiles will be
|
||
used to populate magnitude comments when committing a magnitude.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.map.stations.unassociatedMaxDist">
|
||
<span class="sig-name descname"><span class="pre">olv.map.stations.unassociatedMaxDist</span></span><a class="headerlink" href="#confval-olv.map.stations.unassociatedMaxDist" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">360.0</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>deg</em></p>
|
||
<p>Maximum distance in degrees up to which also unassociated stations are
|
||
shown in the map. 360.0 deg which will
|
||
show all unassociated stations.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.map.event.defaultRadius">
|
||
<span class="sig-name descname"><span class="pre">olv.map.event.defaultRadius</span></span><a class="headerlink" href="#confval-olv.map.event.defaultRadius" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">-1.0</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>deg</em></p>
|
||
<p>Default map radius in degrees if a new event is selected.
|
||
A negative value restores the default behavior.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.arrivalTable.visibleColumns">
|
||
<span class="sig-name descname"><span class="pre">olv.arrivalTable.visibleColumns</span></span><a class="headerlink" href="#confval-olv.arrivalTable.visibleColumns" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>Defines the visible columns in the arrival table. Valid tokens are:
|
||
Used, Status, Phase, Weight, Method, Polarity, Takeoff,
|
||
Net, Sta, Loc/Cha, Timeres, Dis, Az, Time, +/-,
|
||
Slo, Slores, Baz, Bazres, Created, Latency</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.arrivalPlot.showUncertainties">
|
||
<span class="sig-name descname"><span class="pre">olv.arrivalPlot.showUncertainties</span></span><a class="headerlink" href="#confval-olv.arrivalPlot.showUncertainties" 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>Whether the arrival plot should show uncertainties
|
||
or not by default. That flag can be toggled with ‘e’
|
||
or via the context menu during runtime.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.locator.interface">
|
||
<span class="sig-name descname"><span class="pre">olv.locator.interface</span></span><a class="headerlink" href="#confval-olv.locator.interface" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">LOCSAT</span></code></p>
|
||
<p>Type: <em>string</em></p>
|
||
<p>The default locator interface to use.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.locator.defaultProfile">
|
||
<span class="sig-name descname"><span class="pre">olv.locator.defaultProfile</span></span><a class="headerlink" href="#confval-olv.locator.defaultProfile" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>The default locator profile to use.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.locator.minimumDepth">
|
||
<span class="sig-name descname"><span class="pre">olv.locator.minimumDepth</span></span><a class="headerlink" href="#confval-olv.locator.minimumDepth" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>double</em></p>
|
||
<p>Unit: <em>km</em></p>
|
||
<p>Minimum depth which is set if the locator used supports fixing
|
||
the depth. If the depth is lower than this value, the depth is
|
||
fixed to this configured value and the origin is relocated again.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.locator.presetFromOrigin">
|
||
<span class="sig-name descname"><span class="pre">olv.locator.presetFromOrigin</span></span><a class="headerlink" href="#confval-olv.locator.presetFromOrigin" 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 preset the locator settings when an origin
|
||
is being loaded. It tries to figure the locator type
|
||
from Origin.methodID and the profile from Origin.earthModelID.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.commit.forceEventAssociation">
|
||
<span class="sig-name descname"><span class="pre">olv.commit.forceEventAssociation</span></span><a class="headerlink" href="#confval-olv.commit.forceEventAssociation" 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>Activates the button "Force association with event" when
|
||
committing with additional options. This is just the default
|
||
setting and can be changed manually when the dialog pops up.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.commit.fixOrigin">
|
||
<span class="sig-name descname"><span class="pre">olv.commit.fixOrigin</span></span><a class="headerlink" href="#confval-olv.commit.fixOrigin" 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>Activates the button "Fix this origin as preferred solution" when
|
||
committing with additional options. This is just the default
|
||
setting and can be changed manually when the dialog pops up.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.commit.returnToEventList">
|
||
<span class="sig-name descname"><span class="pre">olv.commit.returnToEventList</span></span><a class="headerlink" href="#confval-olv.commit.returnToEventList" 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 return to the event list after committing with
|
||
additional options or not.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.commit.eventCommentOptions">
|
||
<span class="sig-name descname"><span class="pre">olv.commit.eventCommentOptions</span></span><a class="headerlink" href="#confval-olv.commit.eventCommentOptions" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>Turns the event comment input field into a drop down box
|
||
allowing the user to select from a list a predefined comment
|
||
values which may be changed if required.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>olv.originComments.*</strong>
|
||
<em>The container for all origin comment profiles.</em></p>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>olv.originComments.$name.*</strong>
|
||
$name is a placeholder for the name to be used and needs to be added to <a class="reference internal" href="#confval-olv.originComments"><code class="xref std std-confval docutils literal notranslate"><span class="pre">olv.originComments</span></code></a> to become active.</p>
|
||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>olv.originComments<span class="w"> </span><span class="o">=</span><span class="w"> </span>a,b
|
||
olv.originComments.a.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
olv.originComments.b.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
<span class="c1"># c is not active because it has not been added</span>
|
||
<span class="c1"># to the list of olv.originComments</span>
|
||
olv.originComments.c.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.originComments.-name.id">
|
||
<span class="sig-name descname"><span class="pre">olv.originComments.$name.id</span></span><a class="headerlink" href="#confval-olv.originComments.-name.id" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>The id of the comment to be added, updated or removed.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.originComments.-name.label">
|
||
<span class="sig-name descname"><span class="pre">olv.originComments.$name.label</span></span><a class="headerlink" href="#confval-olv.originComments.-name.label" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>The label shown in the commit dialog.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.originComments.-name.options">
|
||
<span class="sig-name descname"><span class="pre">olv.originComments.$name.options</span></span><a class="headerlink" href="#confval-olv.originComments.-name.options" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of options to select from. Actually the values
|
||
to populate the dropdown list with.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.originComments.-name.allowFreeText">
|
||
<span class="sig-name descname"><span class="pre">olv.originComments.$name.allowFreeText</span></span><a class="headerlink" href="#confval-olv.originComments.-name.allowFreeText" 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 free text is allowed in addition to the predefined
|
||
values.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>olv.customCommits.*</strong>
|
||
<em>Configure custom commit buttons which</em>
|
||
<em>behave like shortcuts to “Commit with additional options”.</em>
|
||
<em>Pressing a custom button does not open a popup window. Instead</em>
|
||
<em>it reads the configured profile and applies the options to the event</em>
|
||
<em>and origin. Each commit button can be coloured and labeled.</em></p>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>olv.customCommits.$name.*</strong>
|
||
$name is a placeholder for the name to be used.</p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.enable">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.enable</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.enable" 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 this commit button.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.askForConfirmation">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.askForConfirmation</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.askForConfirmation" 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>Ask for confirmation by presenting the "commit with options"
|
||
dialog with the options pre-populated from this configuration.
|
||
Cancelling the dialog aborts the commit procedure.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.forceEventAssociation">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.forceEventAssociation</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.forceEventAssociation" 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>Associate a new origin to the currently active event or not.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.fixOrigin">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.fixOrigin</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.fixOrigin" 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>Fix the origin as preferred
|
||
solution in the event it is associated to.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.eventType">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.eventType</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.eventType" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>The event type to be set of the event associated with
|
||
the committed origin. If unset, the type remains unchanged.
|
||
Use quotes for event types with spaces, e.g.
|
||
"not existing".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.eventTypeCertainty">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.eventTypeCertainty</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.eventTypeCertainty" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>The event type certainty to be set of the event
|
||
associated with the committed origin. If unset,
|
||
the type certainty remains unchanged.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.originStatus">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.originStatus</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.originStatus" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>The status to be set of the origin being
|
||
committed. If unset, the status remains unchanged.
|
||
If empty, the origin status will be set to none.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.magnitudeType">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.magnitudeType</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.magnitudeType" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Sets the preferred magnitude type of the event. If
|
||
unset, no changes will be requested. If empty,
|
||
the currently fixed preferred magnitude type will
|
||
be reset.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.eventName">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.eventName</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.eventName" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Optional event name which will be set. This option
|
||
exists for completeness and does not make much
|
||
sense to be applied on any event. Use quotes for event
|
||
names with spaces, e.g. "Quarry XYZ".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.eventComment">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.eventComment</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.eventComment" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Optional event comment which will be set. Use quotes for event
|
||
comments with spaces, e.g. "Blast on Monday morning".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.returnToEventList">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.returnToEventList</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.returnToEventList" 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>Return to the event list after committing or not.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.label">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.label</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.label" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Commit+</span></code></p>
|
||
<p>Type: <em>string</em></p>
|
||
<p>The commit button label. Use quotes for labels with
|
||
spaces, e.g. "Earthquake reported".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.color">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.color</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.color" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>color</em></p>
|
||
<p>Optional primary color for the bulk commit button.
|
||
Use hexadecimal values.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.colorText">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.colorText</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.colorText" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>color</em></p>
|
||
<p>Optional text color for the bulk commit button.
|
||
Use hexadecimal values.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.customCommits.-name.tooltip">
|
||
<span class="sig-name descname"><span class="pre">olv.customCommits.$name.tooltip</span></span><a class="headerlink" href="#confval-olv.customCommits.-name.tooltip" 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>Add a summary of the actions to the button’s tooltip.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>olv.magnitudeComments.*</strong>
|
||
<em>The container for all magnitude comment profiles.</em></p>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>olv.magnitudeComments.$name.*</strong>
|
||
$name is a placeholder for the name to be used and needs to be added to <a class="reference internal" href="#confval-olv.magnitudeComments"><code class="xref std std-confval docutils literal notranslate"><span class="pre">olv.magnitudeComments</span></code></a> to become active.</p>
|
||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>olv.magnitudeComments<span class="w"> </span><span class="o">=</span><span class="w"> </span>a,b
|
||
olv.magnitudeComments.a.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
olv.magnitudeComments.b.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
<span class="c1"># c is not active because it has not been added</span>
|
||
<span class="c1"># to the list of olv.magnitudeComments</span>
|
||
olv.magnitudeComments.c.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.magnitudeComments.-name.id">
|
||
<span class="sig-name descname"><span class="pre">olv.magnitudeComments.$name.id</span></span><a class="headerlink" href="#confval-olv.magnitudeComments.-name.id" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>The id of the comment to be added, updated or removed.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.magnitudeComments.-name.label">
|
||
<span class="sig-name descname"><span class="pre">olv.magnitudeComments.$name.label</span></span><a class="headerlink" href="#confval-olv.magnitudeComments.-name.label" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>The label shown in the magnitude view.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.magnitudeComments.-name.options">
|
||
<span class="sig-name descname"><span class="pre">olv.magnitudeComments.$name.options</span></span><a class="headerlink" href="#confval-olv.magnitudeComments.-name.options" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of options to select from. Actually the values
|
||
to populate the dropdown list with.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-olv.magnitudeComments.-name.allowFreeText">
|
||
<span class="sig-name descname"><span class="pre">olv.magnitudeComments.$name.allowFreeText</span></span><a class="headerlink" href="#confval-olv.magnitudeComments.-name.allowFreeText" 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 free text is allowed in addition to the predefined
|
||
values.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>picker.*</strong>
|
||
<em>Parameters controlling the phase picker window.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.showCrossHairCursor">
|
||
<span class="sig-name descname"><span class="pre">picker.showCrossHairCursor</span></span><a class="headerlink" href="#confval-picker.showCrossHairCursor" 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>Activate a cross hair cursor showing the configured uncertainties
|
||
when in picking mode.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.loadAllPicks">
|
||
<span class="sig-name descname"><span class="pre">picker.loadAllPicks</span></span><a class="headerlink" href="#confval-picker.loadAllPicks" 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>Load all existing picks for the requested data time window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.ignoreUnconfiguredStations">
|
||
<span class="sig-name descname"><span class="pre">picker.ignoreUnconfiguredStations</span></span><a class="headerlink" href="#confval-picker.ignoreUnconfiguredStations" 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 enabled, the picker will not add stations that are not
|
||
configured with a detecStream in global bindings.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.limitStationAcquisition">
|
||
<span class="sig-name descname"><span class="pre">picker.limitStationAcquisition</span></span><a class="headerlink" href="#confval-picker.limitStationAcquisition" 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>Limit the data acquisition to the number of nearest
|
||
stations given by "picker.limitStationAcquisitionCount".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.limitStationAcquisitionCount">
|
||
<span class="sig-name descname"><span class="pre">picker.limitStationAcquisitionCount</span></span><a class="headerlink" href="#confval-picker.limitStationAcquisitionCount" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">10</span></code></p>
|
||
<p>Type: <em>int</em></p>
|
||
<p>Limit the data acquisituion to the given number of
|
||
the nearest stations. Requires to activate
|
||
"picker.limitStationAcquisition".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.loadStrongMotion">
|
||
<span class="sig-name descname"><span class="pre">picker.loadStrongMotion</span></span><a class="headerlink" href="#confval-picker.loadStrongMotion" 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 enabled, acceleration data is loaded for co-located
|
||
stations where picked on velocity data.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.loadAllComponents">
|
||
<span class="sig-name descname"><span class="pre">picker.loadAllComponents</span></span><a class="headerlink" href="#confval-picker.loadAllComponents" 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>Load all three components by default. If disabled, additional
|
||
components are fetched upon request.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.showAllComponents">
|
||
<span class="sig-name descname"><span class="pre">picker.showAllComponents</span></span><a class="headerlink" href="#confval-picker.showAllComponents" 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 enabled, all three components are shown in the picker
|
||
zoom trace. The distance is limited to what is configured
|
||
in "picker.allComponentsMaximumDistance".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.allComponentsMaximumDistance">
|
||
<span class="sig-name descname"><span class="pre">picker.allComponentsMaximumDistance</span></span><a class="headerlink" href="#confval-picker.allComponentsMaximumDistance" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">10</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>deg</em></p>
|
||
<p>The distance limit for the "picker.showAllComponents" flag.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.usePerStreamTimeWindows">
|
||
<span class="sig-name descname"><span class="pre">picker.usePerStreamTimeWindows</span></span><a class="headerlink" href="#confval-picker.usePerStreamTimeWindows" 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 enabled, data is requested around the P pick for each stations.
|
||
Otherwise origin time is used and the time window for all stations
|
||
is the same.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.removeAutomaticPicksFromStationAfterManualReview">
|
||
<span class="sig-name descname"><span class="pre">picker.removeAutomaticPicksFromStationAfterManualReview</span></span><a class="headerlink" href="#confval-picker.removeAutomaticPicksFromStationAfterManualReview" 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>After picking and pushing the solution back to scolv all automatic arrivals
|
||
are removed from a station if a manual pick exists.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.removeAllAutomaticPicksAfterManualReview">
|
||
<span class="sig-name descname"><span class="pre">picker.removeAllAutomaticPicksAfterManualReview</span></span><a class="headerlink" href="#confval-picker.removeAllAutomaticPicksAfterManualReview" 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>After picking and pushing the solution back to scolv all automatic arrivals
|
||
are removed from all stations regardless if a manual pick exists or not.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.preOffset">
|
||
<span class="sig-name descname"><span class="pre">picker.preOffset</span></span><a class="headerlink" href="#confval-picker.preOffset" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">60</span></code></p>
|
||
<p>Type: <em>int</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>The data time span added to the left of either origin time or
|
||
first arrival depending on the usePerStreamTimeWindows flag.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.postOffset">
|
||
<span class="sig-name descname"><span class="pre">picker.postOffset</span></span><a class="headerlink" href="#confval-picker.postOffset" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">120</span></code></p>
|
||
<p>Type: <em>int</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>The data time span added to the right of the requested time window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.minimumTimeWindow">
|
||
<span class="sig-name descname"><span class="pre">picker.minimumTimeWindow</span></span><a class="headerlink" href="#confval-picker.minimumTimeWindow" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1800</span></code></p>
|
||
<p>Type: <em>int</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>Minimum data time window length.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.alignmentPosition">
|
||
<span class="sig-name descname"><span class="pre">picker.alignmentPosition</span></span><a class="headerlink" href="#confval-picker.alignmentPosition" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.5</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>Defines the relative position of the alignment when traces are
|
||
aligned at a phase. This value is bound
|
||
to interval [0:1] where 0 is the left side and 1 is right
|
||
side of the trace window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.repickerStart">
|
||
<span class="sig-name descname"><span class="pre">picker.repickerStart</span></span><a class="headerlink" href="#confval-picker.repickerStart" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>double</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>Start of the re-picker time window relative the cursor position on the trace.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.repickerEnd">
|
||
<span class="sig-name descname"><span class="pre">picker.repickerEnd</span></span><a class="headerlink" href="#confval-picker.repickerEnd" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>double</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>End of the re-picker time window relative the cursor position on the trace.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.filters">
|
||
<span class="sig-name descname"><span class="pre">picker.filters</span></span><a class="headerlink" href="#confval-picker.filters" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>List of filters available in the picker. Format:
|
||
"name1;filter-definition1", "name2;filter-definition2"</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.velocityChannelCodes">
|
||
<span class="sig-name descname"><span class="pre">picker.velocityChannelCodes</span></span><a class="headerlink" href="#confval-picker.velocityChannelCodes" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of channel codes to be used when searching for
|
||
velocity channels. Usually this information is part of the
|
||
meta data. In case it is not, this list is used.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.accelerationChannelCodes">
|
||
<span class="sig-name descname"><span class="pre">picker.accelerationChannelCodes</span></span><a class="headerlink" href="#confval-picker.accelerationChannelCodes" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of channel codes to be used when searching for
|
||
acceleration channels. Usually this information is part of the
|
||
meta data. In case it is not, this list is used.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.showPhases">
|
||
<span class="sig-name descname"><span class="pre">picker.showPhases</span></span><a class="headerlink" href="#confval-picker.showPhases" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">P,Pn,Pg,pP,sP,S,Sg</span></code></p>
|
||
<p>Type: <em>list:string</em></p>
|
||
<p>Phases for which theoretical arrival times are shown.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.phases">
|
||
<span class="sig-name descname"><span class="pre">picker.phases</span></span><a class="headerlink" href="#confval-picker.phases" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of phases that is available for picking in the Picking menu.
|
||
The phases are not accessible through hot keys as for
|
||
"picker.phases.favourites".
|
||
The phases are considered if the more complex phase group definition
|
||
"picker.phases.groups" is not provided.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.uncertainties">
|
||
<span class="sig-name descname"><span class="pre">picker.uncertainties</span></span><a class="headerlink" href="#confval-picker.uncertainties" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>List of pre-defined pick uncertainties.
|
||
The format of each list item is either a double value or a pair of
|
||
double values for asymmetric uncertainties, e.g.
|
||
"val1","(val2,val3)".
|
||
This parameter is only used if "picker.uncertainties.preferred"
|
||
is undefined.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.componentFollowsMouse">
|
||
<span class="sig-name descname"><span class="pre">picker.componentFollowsMouse</span></span><a class="headerlink" href="#confval-picker.componentFollowsMouse" 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 enabled then the currently selected component for all traces
|
||
will be activated according to the mouse position in the
|
||
zoom trace (old behaviour). If disabled (default) then only
|
||
the component of the zoom trace will change but the overall
|
||
component will stay the same. It must be changed explicitely.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>picker.auxiliary.*</strong>
|
||
<em>Define the notion and behaviour of auxiliary channels.</em>
|
||
<em>They are identified through configurable patterns and if</em>
|
||
<em>identified as such they will be treated differently in</em>
|
||
<em>defined situations.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.auxiliary.channels">
|
||
<span class="sig-name descname"><span class="pre">picker.auxiliary.channels</span></span><a class="headerlink" href="#confval-picker.auxiliary.channels" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of wildcard patterns to identify auxiliary
|
||
channels. A pattern is simply checked against a stream
|
||
ID, the concatenation of NSLC separated by a period.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.auxiliary.minimumDistance">
|
||
<span class="sig-name descname"><span class="pre">picker.auxiliary.minimumDistance</span></span><a class="headerlink" href="#confval-picker.auxiliary.minimumDistance" 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>deg</em></p>
|
||
<p>The minimum distance in degrees from origin to load an
|
||
unassociated auxiliary channel. Loading a
|
||
channel / station explicitely (F3) will not respect
|
||
this setting.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.auxiliary.maximumDistance">
|
||
<span class="sig-name descname"><span class="pre">picker.auxiliary.maximumDistance</span></span><a class="headerlink" href="#confval-picker.auxiliary.maximumDistance" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1000</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>deg</em></p>
|
||
<p>The maximum distance in degrees from origin to load an
|
||
unassociated auxiliary channel. Loading a
|
||
channel / station explicitely (F3) will not respect
|
||
this setting.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>picker.phases.*</strong>
|
||
<em>Phases defined for picking. The phase phases can be selected</em>
|
||
<em>from the Picking menu of the picker window.</em>
|
||
<em>Make sure, the locator can handle all defined phases.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.phases.favourites">
|
||
<span class="sig-name descname"><span class="pre">picker.phases.favourites</span></span><a class="headerlink" href="#confval-picker.phases.favourites" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">P,Pn,Pg,pP,S,Sg,sP</span></code></p>
|
||
<p>Type: <em>list:string</em></p>
|
||
<p>Phase types available for rapid picking by hot keys and
|
||
in the Picking menu. Separate the types by comma.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.phases.groups">
|
||
<span class="sig-name descname"><span class="pre">picker.phases.groups</span></span><a class="headerlink" href="#confval-picker.phases.groups" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>List of defined phase type profiles to be considered.
|
||
Separate profiles by comma.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>picker.phases.groups.*</strong>
|
||
<em>Definiton of phase type profiles. The profiles and phase types</em>
|
||
<em>can be selected from the Picking menu of the picker window</em>
|
||
<em>but not with hot keys.</em></p>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>picker.phases.groups.$name.*</strong>
|
||
$name is a placeholder for the name to be used and needs to be added to <a class="reference internal" href="#confval-picker.phases.groups"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.phases.groups</span></code></a> to become active.</p>
|
||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>picker.phases.groups<span class="w"> </span><span class="o">=</span><span class="w"> </span>a,b
|
||
picker.phases.groups.a<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
picker.phases.groups.b<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
<span class="c1"># c is not active because it has not been added</span>
|
||
<span class="c1"># to the list of picker.phases.groups</span>
|
||
picker.phases.groups.c<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.phases.groups.-name">
|
||
<span class="sig-name descname"><span class="pre">picker.phases.groups.$name</span></span><a class="headerlink" href="#confval-picker.phases.groups.-name" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>List of phase types. Separate types by comma.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>picker.uncertainties.*</strong>
|
||
<em>Define uncertainty profiles. Once defined,</em>
|
||
<em>they can be selected in the scolv picker settings [F3].</em>
|
||
<em>The profiles override uncertainties defined in “uncertainties”.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.uncertainties.preferred">
|
||
<span class="sig-name descname"><span class="pre">picker.uncertainties.preferred</span></span><a class="headerlink" href="#confval-picker.uncertainties.preferred" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>Pick uncertainty profiles to be loaded. The first profile
|
||
will be used by default.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>picker.uncertainties.profile.$name.*</strong>
|
||
$name is a placeholder for the name to be used and needs to be added to <a class="reference internal" href="#confval-picker.uncertainties.preferred"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.uncertainties.preferred</span></code></a> to become active.</p>
|
||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>picker.uncertainties.preferred<span class="w"> </span><span class="o">=</span><span class="w"> </span>a,b
|
||
picker.uncertainties.profile.a<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
picker.uncertainties.profile.b<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
<span class="c1"># c is not active because it has not been added</span>
|
||
<span class="c1"># to the list of picker.uncertainties.preferred</span>
|
||
picker.uncertainties.profile.c<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.uncertainties.profile.-name">
|
||
<span class="sig-name descname"><span class="pre">picker.uncertainties.profile.$name</span></span><a class="headerlink" href="#confval-picker.uncertainties.profile.-name" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>List of pre-defined pick uncertainties.
|
||
The format of each list item is either a double value or a pair of
|
||
double values for asymmetric uncertainties, e.g.
|
||
"val1","(val2,val3)".</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>picker.integration.*</strong>
|
||
<em>Settings related to waveform integration which may be</em>
|
||
<em>required if the desired waveform unit is changed and the</em>
|
||
<em>sensor data must be integrated once or multiple times.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.integration.preFilter">
|
||
<span class="sig-name descname"><span class="pre">picker.integration.preFilter</span></span><a class="headerlink" href="#confval-picker.integration.preFilter" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>An optional pre-filter which is applied prior to the
|
||
numerical integration to stabilize the result. This
|
||
filter is applied for each integration step or just
|
||
once depending on the parameter "applyOnce".
|
||
Multiple integrations are necessary if acceleration
|
||
data should be converted to displacement.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-picker.integration.applyOnce">
|
||
<span class="sig-name descname"><span class="pre">picker.integration.applyOnce</span></span><a class="headerlink" href="#confval-picker.integration.applyOnce" 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>Whether to apply the pre-filter only prior the first
|
||
integration step or prior to each step.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>amplitudePicker.*</strong>
|
||
<em>Parameters controlling the amplitude picker window for computing station magnitudes.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-amplitudePicker.preOffset">
|
||
<span class="sig-name descname"><span class="pre">amplitudePicker.preOffset</span></span><a class="headerlink" href="#confval-amplitudePicker.preOffset" 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>Time span in seconds to be added to the left of the used
|
||
amplitude time window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-amplitudePicker.postOffset">
|
||
<span class="sig-name descname"><span class="pre">amplitudePicker.postOffset</span></span><a class="headerlink" href="#confval-amplitudePicker.postOffset" 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>Time span in seconds to be added to the right of the used
|
||
amplitude time window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-amplitudePicker.filters">
|
||
<span class="sig-name descname"><span class="pre">amplitudePicker.filters</span></span><a class="headerlink" href="#confval-amplitudePicker.filters" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>A list of filters used for the amplitude picker. Format:
|
||
"name1;filter-definition1", "name2;filter-definition2"</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>display.*</strong>
|
||
<em>Display custom information in the Location tab.</em></p>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>display.origin.*</strong>
|
||
<em>Origin information to show. Event comments can be</em>
|
||
<em>processed by addons or shown in the event list as</em>
|
||
<em>configured by global parameters.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-display.origin.addons">
|
||
<span class="sig-name descname"><span class="pre">display.origin.addons</span></span><a class="headerlink" href="#confval-display.origin.addons" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>Name(s) of quality addon profile(s) to be considered.
|
||
The profiles provide values through a script which are
|
||
shown in the location tab. The scolv documentation
|
||
provides an example script.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>display.origin.comment.*</strong>
|
||
<em>Origin comment value to be shown based on its comment ID.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-display.origin.comment.id">
|
||
<span class="sig-name descname"><span class="pre">display.origin.comment.id</span></span><a class="headerlink" href="#confval-display.origin.comment.id" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>ID of the origin comment to be considered.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-display.origin.comment.default">
|
||
<span class="sig-name descname"><span class="pre">display.origin.comment.default</span></span><a class="headerlink" href="#confval-display.origin.comment.default" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Value to be shown in case no valid origin comment is found.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-display.origin.comment.label">
|
||
<span class="sig-name descname"><span class="pre">display.origin.comment.label</span></span><a class="headerlink" href="#confval-display.origin.comment.label" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Label of the value to be shown.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>display.origin.addon.$name.*</strong>
|
||
$name is a placeholder for the name to be used and needs to be added to <a class="reference internal" href="#confval-display.origin.addons"><code class="xref std std-confval docutils literal notranslate"><span class="pre">display.origin.addons</span></code></a> to become active.</p>
|
||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>display.origin.addons<span class="w"> </span><span class="o">=</span><span class="w"> </span>a,b
|
||
display.origin.addon.a.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
display.origin.addon.b.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
<span class="c1"># c is not active because it has not been added</span>
|
||
<span class="c1"># to the list of display.origin.addons</span>
|
||
display.origin.addon.c.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-display.origin.addon.-name.label">
|
||
<span class="sig-name descname"><span class="pre">display.origin.addon.$name.label</span></span><a class="headerlink" href="#confval-display.origin.addon.-name.label" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Defines the label text of the information panel in the
|
||
Location tab of the parameter evaluated by this addon.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-display.origin.addon.-name.script">
|
||
<span class="sig-name descname"><span class="pre">display.origin.addon.$name.script</span></span><a class="headerlink" href="#confval-display.origin.addon.-name.script" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>string</em></p>
|
||
<p>Path to script to execute.</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="command-line-options">
|
||
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading">¶</a></h2>
|
||
<p><strong class="program">scolv [options]</strong></p>
|
||
<section id="generic">
|
||
<h3>Generic<a class="headerlink" href="#generic" title="Permalink to this heading">¶</a></h3>
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-h">
|
||
<span id="cmdoption-scolv-help"></span><span class="sig-name descname"><span class="pre">-h</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--help</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-h" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Show help message.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-V">
|
||
<span id="cmdoption-scolv-version"></span><span class="sig-name descname"><span class="pre">-V</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--version</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-V" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Show version information.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-config-file">
|
||
<span class="sig-name descname"><span class="pre">--config-file</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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 -> scautopick2.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-plugins">
|
||
<span class="sig-name descname"><span class="pre">--plugins</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-plugins" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Load given plugins.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-auto-shutdown">
|
||
<span class="sig-name descname"><span class="pre">--auto-shutdown</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-shutdown-master-module">
|
||
<span class="sig-name descname"><span class="pre">--shutdown-master-module</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-shutdown-master-username">
|
||
<span class="sig-name descname"><span class="pre">--shutdown-master-username</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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>
|
||
|
||
</section>
|
||
<section id="verbosity">
|
||
<h3>Verbosity<a class="headerlink" href="#verbosity" title="Permalink to this heading">¶</a></h3>
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-verbosity">
|
||
<span class="sig-name descname"><span class="pre">--verbosity</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-v">
|
||
<span id="cmdoption-scolv-v"></span><span class="sig-name descname"><span class="pre">-v</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--v</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-v" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Increase verbosity level (may be repeated, eg. -vv).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-q">
|
||
<span id="cmdoption-scolv-quiet"></span><span class="sig-name descname"><span class="pre">-q</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--quiet</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-q" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Quiet mode: no logging output.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-component">
|
||
<span class="sig-name descname"><span class="pre">--component</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-s">
|
||
<span id="cmdoption-scolv-syslog"></span><span class="sig-name descname"><span class="pre">-s</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--syslog</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-l">
|
||
<span id="cmdoption-scolv-lockfile"></span><span class="sig-name descname"><span class="pre">-l</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--lockfile</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-l" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Path to lock file.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-console">
|
||
<span class="sig-name descname"><span class="pre">--console</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-console" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Send log output to stdout.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-debug">
|
||
<span class="sig-name descname"><span class="pre">--debug</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-log-file">
|
||
<span class="sig-name descname"><span class="pre">--log-file</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-log-file" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Use alternative log file.</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="messaging">
|
||
<h3>Messaging<a class="headerlink" href="#messaging" title="Permalink to this heading">¶</a></h3>
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-u">
|
||
<span id="cmdoption-scolv-user"></span><span class="sig-name descname"><span class="pre">-u</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--user</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-H">
|
||
<span id="cmdoption-scolv-host"></span><span class="sig-name descname"><span class="pre">-H</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--host</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-H" 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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-t">
|
||
<span id="cmdoption-scolv-timeout"></span><span class="sig-name descname"><span class="pre">-t</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--timeout</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-g">
|
||
<span id="cmdoption-scolv-primary-group"></span><span class="sig-name descname"><span class="pre">-g</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--primary-group</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-S">
|
||
<span id="cmdoption-scolv-subscribe-group"></span><span class="sig-name descname"><span class="pre">-S</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--subscribe-group</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-S" 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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-content-type">
|
||
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-start-stop-msg">
|
||
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-start-stop-msg" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Set sending of a start and a stop message.</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="database">
|
||
<h3>Database<a class="headerlink" href="#database" title="Permalink to this heading">¶</a></h3>
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-db-driver-list">
|
||
<span class="sig-name descname"><span class="pre">--db-driver-list</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-db-driver-list" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>List all supported database drivers.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-d">
|
||
<span id="cmdoption-scolv-database"></span><span class="sig-name descname"><span class="pre">-d</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--database</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-d" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>The database connection string, format:
|
||
<a class="reference external" href="service://user:pwd@host/database">service://user:pwd@host/database</a>.
|
||
"service" is the name of the database driver which
|
||
can be queried with "--db-driver-list".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-config-module">
|
||
<span class="sig-name descname"><span class="pre">--config-module</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-config-module" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>The config module to use.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-inventory-db">
|
||
<span class="sig-name descname"><span class="pre">--inventory-db</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-db-disable">
|
||
<span class="sig-name descname"><span class="pre">--db-disable</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-db-disable" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Do not use the database at all</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="records">
|
||
<h3>Records<a class="headerlink" href="#records" title="Permalink to this heading">¶</a></h3>
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-record-driver-list">
|
||
<span class="sig-name descname"><span class="pre">--record-driver-list</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-record-driver-list" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>List all supported record stream drivers.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-I">
|
||
<span id="cmdoption-scolv-record-url"></span><span class="sig-name descname"><span class="pre">-I</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-record-file">
|
||
<span class="sig-name descname"><span class="pre">--record-file</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-record-file" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Specify a file as record source.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-record-type">
|
||
<span class="sig-name descname"><span class="pre">--record-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-record-type" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Specify a type for the records being read.</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="cities">
|
||
<h3>Cities<a class="headerlink" href="#cities" title="Permalink to this heading">¶</a></h3>
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-city-xml">
|
||
<span class="sig-name descname"><span class="pre">--city-xml</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-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>
|
||
|
||
</section>
|
||
<section id="user-interface">
|
||
<h3>User interface<a class="headerlink" href="#user-interface" title="Permalink to this heading">¶</a></h3>
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-F">
|
||
<span id="cmdoption-scolv-full-screen"></span><span class="sig-name descname"><span class="pre">-F</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--full-screen</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-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="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-N">
|
||
<span id="cmdoption-scolv-non-interactive"></span><span class="sig-name descname"><span class="pre">-N</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--non-interactive</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-N" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Use non-interactive presentation mode. This only works with
|
||
GUI applications.</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="options">
|
||
<h3>Options<a class="headerlink" href="#options" title="Permalink to this heading">¶</a></h3>
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-O">
|
||
<span id="cmdoption-scolv-origin"></span><span class="sig-name descname"><span class="pre">-O</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--origin</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-O" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Preload origin with given origin ID</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-E">
|
||
<span id="cmdoption-scolv-event"></span><span class="sig-name descname"><span class="pre">-E</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--event</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-E" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Preload event with given event ID</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-offline">
|
||
<span class="sig-name descname"><span class="pre">--offline</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scolv-offline" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Switch to offline mode</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-i">
|
||
<span id="cmdoption-scolv-input-file"></span><span class="sig-name descname"><span class="pre">-i</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--input-file</span></span><span class="sig-prename descclassname"> <span class="pre">xml</span></span><a class="headerlink" href="#cmdoption-scolv-i" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Load events in given XML file during startup and switch to offline mode</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std option">
|
||
<dt class="sig sig-object std" id="cmdoption-scolv-load-event-db">
|
||
<span class="sig-name descname"><span class="pre">--load-event-db</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-load-event-db" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Number of days to load from database</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
</section>
|
||
</section>
|
||
|
||
|
||
<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" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
|
||
<input type="submit" value="Go" />
|
||
</form>
|
||
</div>
|
||
</div>
|
||
<script>document.getElementById('searchbox').style.display = "block"</script>
|
||
<div>
|
||
<h3><a href="../index.html">Table of Contents</a></h3>
|
||
<ul>
|
||
<li><a class="reference internal" href="#">scolv</a><ul>
|
||
<li><a class="reference internal" href="#description">Description</a></li>
|
||
<li><a class="reference internal" href="#modes-of-operation">Modes of Operation</a></li>
|
||
<li><a class="reference internal" href="#location-tab">Location Tab</a><ul>
|
||
<li><a class="reference internal" href="#summary-widget">Summary widget</a></li>
|
||
<li><a class="reference internal" href="#diagrams">Diagrams</a></li>
|
||
<li><a class="reference internal" href="#arrival-table">Arrival table</a></li>
|
||
<li><a class="reference internal" href="#phase-picker-review-waveforms">Phase picker: review waveforms</a><ul>
|
||
<li><a class="reference internal" href="#request-waveforms">Request waveforms</a></li>
|
||
<li><a class="reference internal" href="#c-3c-data">1C / 3C data</a></li>
|
||
<li><a class="reference internal" href="#data-filtering">Data filtering</a></li>
|
||
<li><a class="reference internal" href="#waveform-rotation">Waveform rotation</a></li>
|
||
<li><a class="reference internal" href="#phase-picks">Phase picks</a><ul>
|
||
<li><a class="reference internal" href="#phase-picking">Phase picking</a></li>
|
||
<li><a class="reference internal" href="#pick-uncertainties">Pick uncertainties</a></li>
|
||
<li><a class="reference internal" href="#phase-polarities">Phase polarities</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#relocate-events">Relocate events</a></li>
|
||
<li><a class="reference internal" href="#compute-magnitudes">Compute magnitudes</a></li>
|
||
<li><a class="reference internal" href="#commit-a-solution">Commit a solution</a><ul>
|
||
<li><a class="reference internal" href="#additional-options">Additional options</a></li>
|
||
<li><a class="reference internal" href="#custom-commits">Custom commits</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#magnitudes-tab">Magnitudes Tab</a><ul>
|
||
<li><a class="reference internal" href="#station-magnitudes">Station magnitudes</a></li>
|
||
<li><a class="reference internal" href="#network-magnitudes">Network magnitudes</a></li>
|
||
<li><a class="reference internal" href="#summary-magnitude">Summary magnitude</a></li>
|
||
<li><a class="reference internal" href="#waveform-review">Waveform review</a><ul>
|
||
<li><a class="reference internal" href="#filtered-and-raw-data">Filtered and raw data</a></li>
|
||
<li><a class="reference internal" href="#processing-settings">Processing settings</a></li>
|
||
<li><a class="reference internal" href="#secondary-filters">Secondary filters</a></li>
|
||
<li><a class="reference internal" href="#calculate-amplitudes">Calculate amplitudes</a></li>
|
||
<li><a class="reference internal" href="#pick-amplitudes">Pick amplitudes</a></li>
|
||
<li><a class="reference internal" href="#add-stations-in-range">Add stations in range</a></li>
|
||
<li><a class="reference internal" href="#remove-bad-stations">Remove bad stations</a></li>
|
||
<li><a class="reference internal" href="#confirm-the-amplitudes">Confirm the amplitudes</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#event-tab">Event Tab</a><ul>
|
||
<li><a class="reference internal" href="#origin-list">Origin list</a></li>
|
||
<li><a class="reference internal" href="#magnitude-list">Magnitude list</a></li>
|
||
<li><a class="reference internal" href="#focal-mechanism-list">Focal Mechanism list</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#events-tab">Events Tab</a><ul>
|
||
<li><a class="reference internal" href="#events-table">Events table</a></li>
|
||
<li><a class="reference internal" href="#event-filtering">Event filtering</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#custom-actions">Custom Actions</a><ul>
|
||
<li><a class="reference internal" href="#origin-comments">Origin comments</a><ul>
|
||
<li><a class="reference internal" href="#id2">Location tab</a></li>
|
||
<li><a class="reference internal" href="#id3">Event tab</a></li>
|
||
<li><a class="reference internal" href="#id4">Events tab</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#external-scripts">External scripts</a><ul>
|
||
<li><a class="reference internal" href="#custom-buttons">Custom buttons</a></li>
|
||
<li><a class="reference internal" href="#custom-information-in-tabs">Custom information in tabs</a><ul>
|
||
<li><a class="reference internal" href="#sec-scolv-parameters-location">Location tab</a></li>
|
||
<li><a class="reference internal" href="#sec-scolv-parameters-event">Event tab</a></li>
|
||
<li><a class="reference internal" href="#sec-scolv-parameters-events">Events tab</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#settings">Settings</a><ul>
|
||
<li><a class="reference internal" href="#global">Global</a></li>
|
||
<li><a class="reference internal" href="#picker">Picker</a></li>
|
||
<li><a class="reference internal" href="#magnitude-review">Magnitude review</a></li>
|
||
<li><a class="reference internal" href="#units-and-precisions">Units and precisions</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#hotkeys">Hotkeys</a></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="#options">Options</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
</div>
|
||
<div>
|
||
<h4>Previous topic</h4>
|
||
<p class="topless"><a href="scmv.html"
|
||
title="previous chapter">scmv</a></p>
|
||
</div>
|
||
<div>
|
||
<h4>Next topic</h4>
|
||
<p class="topless"><a href="scqcv.html"
|
||
title="next chapter">scqcv</a></p>
|
||
</div>
|
||
<div role="note" aria-label="source link">
|
||
<h3>This Page</h3>
|
||
<ul class="this-page-menu">
|
||
<li><a href="../_sources/apps/scolv.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>6.9.0</b> Release
|
||
</div>
|
||
<div class="copyright">
|
||
Copyright © 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> |