|
|
<!DOCTYPE html>
|
|
|
|
|
|
<html >
|
|
|
<head>
|
|
|
<meta charset="utf-8" />
|
|
|
<title>NonLinLoc — SeisComP Release documentation</title>
|
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
|
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
|
|
|
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
|
|
|
<script type="text/javascript" src="../_static/seiscomp.js"></script>
|
|
|
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
|
|
<script src="../_static/jquery.js"></script>
|
|
|
<script src="../_static/underscore.js"></script>
|
|
|
<script src="../_static/doctools.js"></script>
|
|
|
<script src="../_static/language_data.js"></script>
|
|
|
<link rel="shortcut icon" href="../_static/favicon.ico"/>
|
|
|
<link rel="index" title="Index" href="../genindex.html" />
|
|
|
<link rel="search" title="Search" href="../search.html" />
|
|
|
<link rel="next" title="MLh" href="global_mlh.html" />
|
|
|
<link rel="prev" title="global" href="../toc/extensions/global.html" />
|
|
|
</head>
|
|
|
<body>
|
|
|
<div class="header">
|
|
|
<div class="container">
|
|
|
<div class="brand">
|
|
|
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
|
|
|
<!-- span class="title">SeisComP Release</span -->
|
|
|
<span class="version">5.3.0</span>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="nav">
|
|
|
<div class="container">
|
|
|
<div class="content"><a class="pull-right" id="sidebar-toggle">TOC</a>
|
|
|
|
|
|
<div class="related" role="navigation" aria-label="related navigation">
|
|
|
<ul>
|
|
|
<li class="right">
|
|
|
<a href="../genindex.html" title="General Index"
|
|
|
accesskey="I">
|
|
|
index
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="global_mlh.html" title="MLh"
|
|
|
accesskey="N">
|
|
|
next
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="../toc/extensions/global.html" title="global"
|
|
|
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="../toc/extensions.html" >Extensions</a>
|
|
|
</li>
|
|
|
<li class="nav-item nav-item-2">
|
|
|
<a href="../toc/extensions/global.html" accesskey="U">global</a>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="container">
|
|
|
<div class="fitted content" id="anchors-container">
|
|
|
<div class="body" role="main">
|
|
|
|
|
|
<div class="section" id="nonlinloc">
|
|
|
<span id="global-nonlinloc"></span><h1>NonLinLoc<a class="headerlink" href="#nonlinloc" title="Permalink to this headline">¶</a></h1>
|
|
|
<p>NonLinLoc locator wrapper plugin for SeisComP.
|
|
|
NonLinLoc was written by Anthony Lomax (<a class="reference external" href="http://alomax.free.fr/nlloc">http://alomax.free.fr/nlloc</a>).</p>
|
|
|
<div class="section" id="description">
|
|
|
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>Funded by <a class="reference external" href="http://www.seismo.ethz.ch/">SED/ETH Zurich</a>, developed by <a class="reference external" href="http://www.gempa.de">gempa GmbH</a>.
|
|
|
This plugin is available from SeisComP version Release Potsdam 2010 and later.</p>
|
|
|
<p>The <a class="reference external" href="http://alomax.free.fr/nlloc">NonLinLoc (NLL)</a> locator algorithm has been
|
|
|
implemented into SeisComP through the plugin mechanism. A new plugin locnll
|
|
|
contains the LocatorInterface implementation for NonLinLoc.</p>
|
|
|
<p>The implementation bundles the NonLinLoc source files required to use the library
|
|
|
function calls. The following source files are included:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>GridLib.c
|
|
|
GridLib.h
|
|
|
GridMemLib.c
|
|
|
GridMemLib.h
|
|
|
NLLocLib.h
|
|
|
NLLoc1.c
|
|
|
NLLocLib.c
|
|
|
calc_crust_corr.c
|
|
|
calc_crust_corr.h
|
|
|
crust_corr_model.h
|
|
|
crust_type_key.h
|
|
|
crust_type.h
|
|
|
loclist.c
|
|
|
octtree.h
|
|
|
octtree.c
|
|
|
phaseloclist.h
|
|
|
phaselist.c
|
|
|
geo.c
|
|
|
geo.h
|
|
|
geometry.h
|
|
|
map_project.c
|
|
|
map_project.h
|
|
|
otime_limit.c
|
|
|
otime_limit.h
|
|
|
ran1.c
|
|
|
ran1.h
|
|
|
velmod.c
|
|
|
velmod.h
|
|
|
util.h
|
|
|
util.c
|
|
|
alomax_matrix/alomax_matrix.c
|
|
|
alomax_matrix/alomax_matrix.h
|
|
|
alomax_matrix/alomax_matrix_svd.c
|
|
|
alomax_matrix/alomax_matrix_svd.h
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="error-measures">
|
|
|
<h2>Error measures<a class="headerlink" href="#error-measures" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>After running NonLinLoc the output is converted into a SeisComP (QuakeML) origin
|
|
|
object including all available error measures. The following table shows how
|
|
|
the NLL error measures are mapped to the SeisComP data model:</p>
|
|
|
<table class="docutils align-default">
|
|
|
<colgroup>
|
|
|
<col style="width: 52%" />
|
|
|
<col style="width: 48%" />
|
|
|
</colgroup>
|
|
|
<thead>
|
|
|
<tr class="row-odd"><th class="head"><p>SeisComP</p></th>
|
|
|
<th class="head"><p>NLL</p></th>
|
|
|
</tr>
|
|
|
</thead>
|
|
|
<tbody>
|
|
|
<tr class="row-even"><td><p>Origin.latitude.uncertainty</p></td>
|
|
|
<td><p>sqrt(phypo->cov.yy)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.longitude.uncertainty</p></td>
|
|
|
<td><p>sqrt(phypo->cov.xx)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.depth.uncertainty</p></td>
|
|
|
<td><p>sqrt(phypo->cov.zz)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.standardError</p></td>
|
|
|
<td><p>phypo->rms</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.secondaryAzimuthalGap</p></td>
|
|
|
<td><p>phypo->gap_secondary</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.usedStationCount</p></td>
|
|
|
<td><p>phypo->usedStationCount</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.associatedStationCount</p></td>
|
|
|
<td><p>phypo->associatedStationCount</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.associatedPhaseCount</p></td>
|
|
|
<td><p>phypo->associatedPhaseCount</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.usedPhaseCount</p></td>
|
|
|
<td><p>phypo->nreadings</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.depthPhaseCount</p></td>
|
|
|
<td><p>phypo->depthPhaseCount</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.minimumDistance</p></td>
|
|
|
<td><p>km2deg(phypo->minimumDistance)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.maximumDistance</p></td>
|
|
|
<td><p>km2deg(phypo->maximumDistance)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.medianDistance</p></td>
|
|
|
<td><p>km2deg(phypo->medianDistance)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.groundTruthLevel</p></td>
|
|
|
<td><p>phypo->groundTruthLevel</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originUncertainty.horizontalUncertainty</p></td>
|
|
|
<td><p>phypo->ellipse.len2</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originUncertainty.minHorizontalUncertainty</p></td>
|
|
|
<td><p>phypo->ellipse.len1</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originUncertainty.maxHorizontalUncertainty</p></td>
|
|
|
<td><p>phypo->ellipse.len2</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originUncertainty.azimuthMaxHorizontalUncertainty</p></td>
|
|
|
<td><p>phypo->ellipse.az1 + 90</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>ConfidenceEllipsoid.semiMajorAxisLength</p></td>
|
|
|
<td><p>phypo->ellipsoid.len3</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>ConfidenceEllipsoid.semiMinorAxisLength</p></td>
|
|
|
<td><p>phypo->ellipsoid.len1</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>ConfidenceEllipsoid.semiIntermediateAxisLength</p></td>
|
|
|
<td><p>phypo->ellipsoid.len2</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>ConfidenceEllipsoid.majorAxisPlunge</p></td>
|
|
|
<td><p>(phypo->ellipsoid.axis1 x phypo->ellipsoid.axis2).dip</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>ConfidenceEllipsoid.majorAxisAzimuth</p></td>
|
|
|
<td><p>(phypo->ellipsoid.axis1 x phypo->ellipsoid.axis2).az</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>ConfidenceEllipsoid.majorAxisRotation</p></td>
|
|
|
<td><p>T.B.D.</p></td>
|
|
|
</tr>
|
|
|
</tbody>
|
|
|
</table>
|
|
|
</div>
|
|
|
<div class="section" id="plugin">
|
|
|
<h2>Plugin<a class="headerlink" href="#plugin" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>The NonLinLoc plugin is installed under <code class="file docutils literal notranslate"><span class="pre">share/plugins/locnll.so</span></code>.
|
|
|
It provides a new implementation of the LocatorInterface with the name NonLinLoc.</p>
|
|
|
<p>To add the plugin to a module add it to the modules configuration, either
|
|
|
<code class="file docutils literal notranslate"><span class="pre">modulename.cfg</span></code> or <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">plugins</span> <span class="o">=</span> <span class="si">${</span><span class="nv">plugins</span><span class="si">}</span>, locnll
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Basically it can be used by two modules: <a class="reference internal" href="screloc.html#screloc"><span class="std std-ref">screloc</span></a> and <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a>.</p>
|
|
|
</div>
|
|
|
<div class="section" id="output">
|
|
|
<h2>Output<a class="headerlink" href="#output" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>All output is stored in the configured <a class="reference internal" href="#confval-NonLinLoc.outputPath"><code class="xref std std-confval docutils literal notranslate"><span class="pre">NonLinLoc.outputPath</span></code></a>.
|
|
|
The file prefix for a location is the originID (<a class="reference internal" href="#confval-NonLinLoc.publicID"><code class="xref std std-confval docutils literal notranslate"><span class="pre">NonLinLoc.publicID</span></code></a>).</p>
|
|
|
<p>The following file are stored:</p>
|
|
|
<ul class="simple">
|
|
|
<li><p>Input observations (.obs)</p></li>
|
|
|
<li><p>Input configuration (.conf)</p></li>
|
|
|
<li><p>NLL location (.loc.hyp)</p></li>
|
|
|
<li><p>NLL 3D grid header (.loc.hdr)</p></li>
|
|
|
<li><p>NLL octree (.loc.octree)</p></li>
|
|
|
<li><p>NLL scatter file (.loc.scat)</p></li>
|
|
|
</ul>
|
|
|
<p>In addition to the native NLL output a SeisComP origin object is created and
|
|
|
returned to the calling instance. Usually this object is then sent via messaging.</p>
|
|
|
</div>
|
|
|
<div class="section" id="configuration-example">
|
|
|
<h2>Configuration example<a class="headerlink" href="#configuration-example" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>To add the plugin to an application such as scolv or screloc, add the plugin
|
|
|
name to the list of plugins that are loaded (e.g. <code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">plugins</span> <span class="o">=</span> <span class="si">${</span><span class="nv">plugins</span><span class="si">}</span>, locnll
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Futhermore add the plugin configuration (e.g. <code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>):</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1">########################################################</span>
|
|
|
<span class="c1">################ NonLinLoc configuration################</span>
|
|
|
<span class="c1">########################################################</span>
|
|
|
<span class="nv">NLLROOT</span> <span class="o">=</span> <span class="si">${</span><span class="nv">HOME</span><span class="si">}</span>/nll/data
|
|
|
|
|
|
NonLinLoc.outputPath <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/output/
|
|
|
|
|
|
<span class="c1"># Define the default control file if no profile specific</span>
|
|
|
<span class="c1"># control file is defined.</span>
|
|
|
NonLinLoc.controlFile <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/NLL.default.conf
|
|
|
|
|
|
<span class="c1"># Set the default pick error in seconds passed to NonLinLoc</span>
|
|
|
<span class="c1"># if no SeisComP pick uncertainty is available.</span>
|
|
|
NonLinLoc.defaultPickError <span class="o">=</span> <span class="m">0</span>.1
|
|
|
|
|
|
<span class="c1"># Define the available NonLinLoc location profiles. The order</span>
|
|
|
<span class="c1"># implicitly defines the priority for overlapping regions</span>
|
|
|
<span class="c1">#NonLinLoc.profiles = swiss_3d, swiss_1d, global</span>
|
|
|
NonLinLoc.profiles <span class="o">=</span> swiss_3d, global
|
|
|
|
|
|
<span class="c1"># The earthModelID is copied to earthModelID attribute of the</span>
|
|
|
<span class="c1"># resulting origin</span>
|
|
|
NonLinLoc.profile.swiss_1d.earthModelID <span class="o">=</span> <span class="s2">"swiss regional 1D"</span>
|
|
|
|
|
|
<span class="c1"># Specify the velocity model table path as used by NonLinLoc</span>
|
|
|
NonLinLoc.profile.swiss_1d.tablePath <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/time_1d_regio/regio
|
|
|
|
|
|
<span class="c1"># Specify the region valid for this profile</span>
|
|
|
<span class="c1"># Without this parameter the plugin will add an additional</span>
|
|
|
<span class="c1"># TRANS GLOBAL statement in the NLL control file</span>
|
|
|
NonLinLoc.profile.swiss_1d.region <span class="o">=</span> <span class="m">41</span>.2, <span class="m">3</span>.8, <span class="m">50</span>.1, <span class="m">16</span>.8
|
|
|
|
|
|
<span class="c1"># The NonLinLoc control file to use for this profile</span>
|
|
|
NonLinLoc.profile.swiss_1d.controlFile <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/NLL.swiss_1d.conf
|
|
|
|
|
|
<span class="c1"># Configure the swiss_3d profile</span>
|
|
|
NonLinLoc.profile.swiss_3d.earthModelID <span class="o">=</span> <span class="s2">"swiss regional 3D"</span>
|
|
|
NonLinLoc.profile.swiss_3d.tablePath <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/time_3d/ch
|
|
|
NonLinLoc.profile.swiss_3d.region <span class="o">=</span> <span class="m">45</span>.15, <span class="m">5</span>.7, <span class="m">48</span>.3, <span class="m">11</span>.0
|
|
|
NonLinLoc.profile.swiss_3d.controlFile <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/NLL.swiss_3d.conf
|
|
|
|
|
|
<span class="c1"># And the global profile</span>
|
|
|
NonLinLoc.profile.global.earthModelID <span class="o">=</span> iaspei91
|
|
|
NonLinLoc.profile.global.tablePath <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/iasp91/iasp91
|
|
|
NonLinLoc.profile.global.controlFile <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/NLL.global.conf
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>An example of a NonLinLoc control file configuration that contains all the
|
|
|
required statements, but it must be adapted to the specific use case. The
|
|
|
missing statements are generated by the plugin (LOCFILES, LOCHYPOUT, LOCSRCE):</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># -1 = no logs, useful for playback with screloc --ep option</span>
|
|
|
CONTROL -1 <span class="m">123456</span>
|
|
|
<span class="c1"># This must be the same TRANS used for generating the grid files</span>
|
|
|
TRANS SDC <span class="m">46</span>.51036987 <span class="m">8</span>.47575546 <span class="m">0</span>.0
|
|
|
LOCSIG Swiss Seismological Service, ETHZ
|
|
|
LOCCOM location using my <span class="nb">local</span> velocity model
|
|
|
LOCSEARCH OCT <span class="m">20</span> <span class="m">20</span> <span class="m">20</span> <span class="m">0</span>.001 <span class="m">10000</span> <span class="m">1000</span>
|
|
|
<span class="c1"># This grid origin is relative to the TRANS statement. The grid</span>
|
|
|
<span class="c1"># must be wholly contained in the grid files</span>
|
|
|
LOCGRID <span class="m">101</span> <span class="m">101</span> <span class="m">101</span> -0.5 -0.5 -1.8 <span class="m">0</span>.01 <span class="m">0</span>.01 <span class="m">0</span>.01 PROB_DENSITY SAVE
|
|
|
LOCMETH EDT_OT_WT <span class="m">9999</span>.0 <span class="m">4</span> -1 -1 -1 <span class="m">0</span> -1 <span class="m">1</span>
|
|
|
LOCGAU <span class="m">0</span>.001 <span class="m">0</span>.0
|
|
|
LOCPHASEID P P p G Pn Pg P1
|
|
|
LOCPHASEID S S s G Sn Sg S1
|
|
|
LOCQUAL2ERR <span class="m">0</span>.025 <span class="m">0</span>.050 <span class="m">0</span>.100 <span class="m">0</span>.200 <span class="m">0</span>.400 <span class="m">99999</span>.9
|
|
|
LOCANGLES ANGLES_YES <span class="m">5</span>
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="stations-names">
|
|
|
<h2>Stations names<a class="headerlink" href="#stations-names" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>When generating the grid files the station names used in the GTSRCE statement
|
|
|
must match the rule set in the plugin configuration. E.g.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Format of the station name used to select the right travel time table (grid)</span>
|
|
|
<span class="c1"># file for a station. By default only the station code is used (e.g.</span>
|
|
|
<span class="c1"># tablePath.P.@STA@.time.*), but that doesn't allow to distinguish between</span>
|
|
|
<span class="c1"># multiple network codes or location codes that use the same station code. To</span>
|
|
|
<span class="c1"># overcome this limitation this parameter could be set in a more general way,</span>
|
|
|
<span class="c1"># for example @NET@_@STA@_@LOC@. In this way NonLinLoc will look for travel</span>
|
|
|
<span class="c1"># time table (grid) files of the form: tablePath.P.@NET@_@STA@_@LOC@.time.*</span>
|
|
|
<span class="c1"># Where @NET@ @STA@ @LOC@ are just placeholder for the actual codes</span>
|
|
|
NonLinLoc.profile.MYPROFILE.stationNameFormat <span class="o">=</span> @NET@_@STA@_@LOC@
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Given the above plugin configuration, the GTSRCE statement should be something
|
|
|
like this:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>GTSRCE CH_STA01_ LATLON <span class="m">46</span>.519 <span class="m">8</span>.474 <span class="m">0</span>.0 <span class="m">1</span>.295
|
|
|
GTSRCE CH_STA02_01 LATLON <span class="m">46</span>.456 <span class="m">8</span>.474 <span class="m">0</span>.0 <span class="m">1</span>.323
|
|
|
GTSRCE CH_STA03_AA LATLON <span class="m">46</span>.784 <span class="m">8</span>.474 <span class="m">0</span>.0 <span class="m">1</span>.292
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Alternatively the names could just contain the station code:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>NonLinLoc.profile.MYPROFILE.stationNameFormat <span class="o">=</span> @STA@
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>GTSRCE STA01 LATLON <span class="m">46</span>.519 <span class="m">8</span>.474 <span class="m">0</span>.0 <span class="m">1</span>.295
|
|
|
GTSRCE STA02 LATLON <span class="m">46</span>.456 <span class="m">8</span>.474 <span class="m">0</span>.0 <span class="m">1</span>.323
|
|
|
GTSRCE STA03 LATLON <span class="m">46</span>.784 <span class="m">8</span>.474 <span class="m">0</span>.0 <span class="m">1</span>.292
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="usage">
|
|
|
<h2>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
|
|
|
<div class="section" id="locator">
|
|
|
<h3>Locator<a class="headerlink" href="#locator" title="Permalink to this headline">¶</a></h3>
|
|
|
<p>The usage of the new NLL plugin is straight forward. Once loaded successfully the
|
|
|
new locator shows up in the lower left corners combo box.</p>
|
|
|
<div class="figure align-default">
|
|
|
<img alt="../_images/locator_selection_small1.png" src="../_images/locator_selection_small1.png" />
|
|
|
</div>
|
|
|
<p>Select the new NonLinLoc locator and the configured profiles will be loaded into
|
|
|
the combo box right of it.</p>
|
|
|
<div class="figure align-default">
|
|
|
<img alt="../_images/locator_profile_selection_small1.png" src="../_images/locator_profile_selection_small1.png" />
|
|
|
</div>
|
|
|
<p>The NonLinLoc implementation provides a virtual profile automatic. This emulates
|
|
|
the complete automatic case and selects the best matching configured profiles
|
|
|
based on the initial location.</p>
|
|
|
<p>If an origin has been relocated the method should be set to “NonLinLoc” and
|
|
|
the earth model contains the string NonLinLoc.profile.[name].earthModelID
|
|
|
configured for the selected profile.</p>
|
|
|
<div class="figure align-default">
|
|
|
<img alt="../_images/origin_information1.png" src="../_images/origin_information1.png" />
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="settings">
|
|
|
<h3>Settings<a class="headerlink" href="#settings" title="Permalink to this headline">¶</a></h3>
|
|
|
<p>The NLL locator implementation supports to override configured settings or
|
|
|
control parameters for a session. Those changes are not persistent and lost if
|
|
|
the locator is changed to another one or the profile has been changed.</p>
|
|
|
<p>To open the settings dialog press the button right to the locator selection
|
|
|
combo box.</p>
|
|
|
<div class="figure align-default">
|
|
|
<img alt="../_images/locator_settings1.png" src="../_images/locator_settings1.png" />
|
|
|
</div>
|
|
|
<p>Then the NLL specific parameters show up.</p>
|
|
|
<div class="figure align-default">
|
|
|
<img alt="../_images/NLL_settings.png" src="../_images/NLL_settings.png" />
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="seismicity-viewer">
|
|
|
<h3>Seismicity Viewer<a class="headerlink" href="#seismicity-viewer" title="Permalink to this headline">¶</a></h3>
|
|
|
<p>scolv provides two additional configurable buttons. To bind
|
|
|
<a class="reference external" href="http://alomax.free.fr/seismicity">Seismicity Viewer</a> to the first one the
|
|
|
following configuration can be used:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">button0</span> <span class="o">=</span> <span class="s2">"Seismicity Viewer"</span>
|
|
|
scripts.script0 <span class="o">=</span> @CONFIGDIR@/scripts/sv
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>A small wrapper script sv has been created that calls Seismicity Viewer based
|
|
|
on the origin ID passed to the script.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="ch">#!/bin/sh</span>
|
|
|
<span class="nv">FILE</span><span class="o">=</span><span class="nv">$HOME</span>/nll/data/output/<span class="nv">$1</span>.loc.hyp
|
|
|
java -classpath <span class="nv">$HOME</span>/nll/bin/SeismicityViewer50.jar <span class="se">\</span>
|
|
|
net.alomax.seismicity.Seismicity <span class="nv">$FILE</span>
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>This examples assumes that Seismicity Viewer has been installed in $HOME/nll/bin.</p>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="module-configuration">
|
|
|
<span id="global-nonlinloc-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this headline">¶</a></h2>
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.publicID">
|
|
|
<code class="sig-name descname">NonLinLoc.publicID</code><a class="headerlink" href="#confval-NonLinLoc.publicID" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">NLL.@time/%Y%m%d%H%M%S.%f@.@id@</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>PublicID creation pattern for an origin created by NonLinLoc.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.outputPath">
|
|
|
<code class="sig-name descname">NonLinLoc.outputPath</code><a class="headerlink" href="#confval-NonLinLoc.outputPath" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">/tmp/sc3.nll</span></code></p>
|
|
|
<p>Type: <em>path</em></p>
|
|
|
<p>Defines the output path for all native NonLinLoc input and output files.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.saveInput">
|
|
|
<code class="sig-name descname">NonLinLoc.saveInput</code><a class="headerlink" href="#confval-NonLinLoc.saveInput" 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>Save input files *.obs in outputPath for later processing.
|
|
|
Setting to false reduces file i/o and saves disk space.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.saveIntermediateOutput">
|
|
|
<code class="sig-name descname">NonLinLoc.saveIntermediateOutput</code><a class="headerlink" href="#confval-NonLinLoc.saveIntermediateOutput" 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>Save output files in outputPath for later processing or
|
|
|
for viewing by the Seismicity Viewer.
|
|
|
Setting to false reduces file i/o and saves disk space.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.controlFile">
|
|
|
<code class="sig-name descname">NonLinLoc.controlFile</code><a class="headerlink" href="#confval-NonLinLoc.controlFile" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>path</em></p>
|
|
|
<p>The default NonLinLoc control file to use.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.defaultPickError">
|
|
|
<code class="sig-name descname">NonLinLoc.defaultPickError</code><a class="headerlink" href="#confval-NonLinLoc.defaultPickError" 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>The default pick error in seconds passed to NonLinLoc if a SeisComP pick
|
|
|
object does not provide pick time uncertainties.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.fixedDepthGridSpacing">
|
|
|
<code class="sig-name descname">NonLinLoc.fixedDepthGridSpacing</code><a class="headerlink" href="#confval-NonLinLoc.fixedDepthGridSpacing" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.1</span></code></p>
|
|
|
<p>Type: <em>double</em></p>
|
|
|
<p>Unit: <em>km</em></p>
|
|
|
<p>Since NLL does not support fixing the depth natively so this
|
|
|
feature is emulated by settings the Z grid very tight around
|
|
|
the depth to be fixed. This value sets the Z grid spacing.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.allowMissingStations">
|
|
|
<code class="sig-name descname">NonLinLoc.allowMissingStations</code><a class="headerlink" href="#confval-NonLinLoc.allowMissingStations" 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>Picks from stations with missing configuration will be
|
|
|
ignored. The origin will be relocated without that pick
|
|
|
if possible.</p>
|
|
|
<p>If set to false, the plug-in throws
|
|
|
an excepection without locating.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profiles">
|
|
|
<code class="sig-name descname">NonLinLoc.profiles</code><a class="headerlink" href="#confval-NonLinLoc.profiles" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>list:string</em></p>
|
|
|
<p>Defines a list of active profiles to be used by the plugin.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p><strong>NonLinLoc.profile.$name.*</strong>
|
|
|
<em>Defines a regional profile that is used if a prelocation falls</em>
|
|
|
<em>inside the configured region.</em>
|
|
|
$name is a placeholder for the name to be used and needs to be added to <a class="reference internal" href="#confval-NonLinLoc.profiles"><code class="xref std std-confval docutils literal notranslate"><span class="pre">NonLinLoc.profiles</span></code></a> to become active.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>NonLinLoc.profiles <span class="o">=</span> a,b
|
|
|
NonLinLoc.profile.a.value1 <span class="o">=</span> ...
|
|
|
NonLinLoc.profile.b.value1 <span class="o">=</span> ...
|
|
|
<span class="c1"># c is not active because it has not been added</span>
|
|
|
<span class="c1"># to the list of NonLinLoc.profiles</span>
|
|
|
NonLinLoc.profile.c.value1 <span class="o">=</span> ...
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profile.$name.earthModelID">
|
|
|
<code class="sig-name descname">NonLinLoc.profile.$name.earthModelID</code><a class="headerlink" href="#confval-NonLinLoc.profile.$name.earthModelID" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>string</em></p>
|
|
|
<p>earthModelID that is stored in the created origin.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profile.$name.methodID">
|
|
|
<code class="sig-name descname">NonLinLoc.profile.$name.methodID</code><a class="headerlink" href="#confval-NonLinLoc.profile.$name.methodID" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">NonLinLoc</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>methodID that is stored in the created origin.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profile.$name.tablePath">
|
|
|
<code class="sig-name descname">NonLinLoc.profile.$name.tablePath</code><a class="headerlink" href="#confval-NonLinLoc.profile.$name.tablePath" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>path</em></p>
|
|
|
<p>Path to travel time tables (grids).</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profile.$name.stationNameFormat">
|
|
|
<code class="sig-name descname">NonLinLoc.profile.$name.stationNameFormat</code><a class="headerlink" href="#confval-NonLinLoc.profile.$name.stationNameFormat" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">@STA@</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>Format of the station name used to select the right travel time table (grid) file
|
|
|
for a station.
|
|
|
By default only the station code is used (e.g. tablePath.P.@STA@.time.*), but
|
|
|
that doesn’t allow to distinguish between multiple network codes or location codes
|
|
|
that use the same station code.
|
|
|
To overcome this limitation this parameter could be set in a more general way, for
|
|
|
example @NET@_@STA@_@LOC@. In this way NonLinLoc will look for
|
|
|
travel time table (grid) files of the form: tablePath.P.@NET@_@STA@_@LOC@.time.*
|
|
|
Where @NET@ @STA@ @LOC@ are just placeholder for the actual codes</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profile.$name.controlFile">
|
|
|
<code class="sig-name descname">NonLinLoc.profile.$name.controlFile</code><a class="headerlink" href="#confval-NonLinLoc.profile.$name.controlFile" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>path</em></p>
|
|
|
<p>Control file of the current profile. If not set, the default
|
|
|
control file will be used instead.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profile.$name.transform">
|
|
|
<code class="sig-name descname">NonLinLoc.profile.$name.transform</code><a class="headerlink" href="#confval-NonLinLoc.profile.$name.transform" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">GLOBAL</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>Transformation type of the configured region. Supported are
|
|
|
SIMPLE and GLOBAL.</p>
|
|
|
<p>Default: GLOBAL is assumed.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profile.$name.region">
|
|
|
<code class="sig-name descname">NonLinLoc.profile.$name.region</code><a class="headerlink" href="#confval-NonLinLoc.profile.$name.region" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>list:double</em></p>
|
|
|
<p>Defines the 4 corner values of the epicentral region for selecting the profile.
|
|
|
The original epicentre must be within the region.</p>
|
|
|
<p>If transform is GLOBAL: min_lat, min_lon, max_lat, max_lon.
|
|
|
The values define the geographic corner coordinates. Unit is degree.</p>
|
|
|
<p>If transform is SIMPLE: xmin, ymin, xmax, ymax.
|
|
|
The values define the region relative to the configured origin.
|
|
|
Unit is km.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profile.$name.origin">
|
|
|
<code class="sig-name descname">NonLinLoc.profile.$name.origin</code><a class="headerlink" href="#confval-NonLinLoc.profile.$name.origin" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>list:double</em></p>
|
|
|
<p>Unit: <em>deg</em></p>
|
|
|
<p>Only used for transformation SIMPLE. Expects 2 values: latitude, longitude.
|
|
|
The value define the geographic origin of the area spanned by region.
|
|
|
Unit is degree.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-NonLinLoc.profile.$name.rotation">
|
|
|
<code class="sig-name descname">NonLinLoc.profile.$name.rotation</code><a class="headerlink" href="#confval-NonLinLoc.profile.$name.rotation" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>double</em></p>
|
|
|
<p>Unit: <em>deg</em></p>
|
|
|
<p>Only used for transformation SIMPLE. Defines the rotation around the
|
|
|
origin of the defined region.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
|
|
|
<div id="anchors-bottom"></div>
|
|
|
</div>
|
|
|
|
|
|
<div class="sidebar" role="navigation" aria-label="main navigation">
|
|
|
<div id="anchors-top"></div>
|
|
|
<div id="anchors" class="content">
|
|
|
<div id="searchbox" style="display: none" role="search">
|
|
|
<h3 id="searchlabel">Quick search</h3>
|
|
|
<div class="searchformwrapper">
|
|
|
<form class="search" action="../search.html" method="get">
|
|
|
<input type="text" name="q" aria-labelledby="searchlabel" />
|
|
|
<input type="submit" value="Go" />
|
|
|
</form>
|
|
|
</div>
|
|
|
</div>
|
|
|
<script>$('#searchbox').show(0);</script>
|
|
|
<h3><a href="../index.html">Table of Contents</a></h3>
|
|
|
<ul>
|
|
|
<li><a class="reference internal" href="#">NonLinLoc</a><ul>
|
|
|
<li><a class="reference internal" href="#description">Description</a></li>
|
|
|
<li><a class="reference internal" href="#error-measures">Error measures</a></li>
|
|
|
<li><a class="reference internal" href="#plugin">Plugin</a></li>
|
|
|
<li><a class="reference internal" href="#output">Output</a></li>
|
|
|
<li><a class="reference internal" href="#configuration-example">Configuration example</a></li>
|
|
|
<li><a class="reference internal" href="#stations-names">Stations names</a></li>
|
|
|
<li><a class="reference internal" href="#usage">Usage</a><ul>
|
|
|
<li><a class="reference internal" href="#locator">Locator</a></li>
|
|
|
<li><a class="reference internal" href="#settings">Settings</a></li>
|
|
|
<li><a class="reference internal" href="#seismicity-viewer">Seismicity Viewer</a></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
|
|
|
<h4>Previous topic</h4>
|
|
|
<p class="topless"><a href="../toc/extensions/global.html"
|
|
|
title="previous chapter">global</a></p>
|
|
|
<h4>Next topic</h4>
|
|
|
<p class="topless"><a href="global_mlh.html"
|
|
|
title="next chapter">MLh</a></p>
|
|
|
<div role="note" aria-label="source link">
|
|
|
<h3>This Page</h3>
|
|
|
<ul class="this-page-menu">
|
|
|
<li><a href="../_sources/apps/global_nonlinloc.rst.txt"
|
|
|
rel="nofollow">Show Source</a></li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="footer">
|
|
|
<div class="container">
|
|
|
<div class="horizontal layout content">
|
|
|
<a class="fade-in" href="https://www.gempa.de" target="_blank">
|
|
|
<img class="brand" src="../_static/brands/gempa.svg"/>
|
|
|
</a>
|
|
|
<div class="stretched align-center fitted content">
|
|
|
<div>
|
|
|
Version <b>5.3.0</b> Release
|
|
|
</div>
|
|
|
<div class="copyright">
|
|
|
Copyright © 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> |