|
|
<!DOCTYPE html>
|
|
|
|
|
|
<html >
|
|
|
<head>
|
|
|
<meta charset="utf-8" />
|
|
|
<title>Hypo71 — 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="Md" href="global_md.html" />
|
|
|
<link rel="prev" title="MLh" href="global_mlh.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_md.html" title="Md"
|
|
|
accesskey="N">
|
|
|
next
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="global_mlh.html" title="MLh"
|
|
|
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="hypo71">
|
|
|
<span id="global-hypo71"></span><h1>Hypo71<a class="headerlink" href="#hypo71" title="Permalink to this headline">¶</a></h1>
|
|
|
<p>The traditional Hypo71PC locator with SeisComP.</p>
|
|
|
<div class="section" id="description">
|
|
|
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>The Hypo71 locator algorithm by Fred Klein locator (<span id="id1">Lee and Lahr [<a class="reference internal" href="../base/references.html#id51" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">48</a>]</span>) has
|
|
|
been implemented into <cite>SeisComP</cite> through the plugin mechanism. The plugin <em>hypo71</em>
|
|
|
contains the LocatorInterface implementation for Hypo71.
|
|
|
This plugin uses a slightly modified Hypo71 version from Alexandre Nercessian (IPGP)
|
|
|
which allows negative earthquake depth (above sea level) and negative stations
|
|
|
altitude (below sea level - OBS).</p>
|
|
|
<p>The development of this plugin was co-financed by the European Union and
|
|
|
<a class="reference external" href="http://www.developpement-durable.gouv.fr">le Ministère de l’Ecologie, du Développement Durable, des Transports et du Logement</a>
|
|
|
and developed by <span id="id2"><em>OVSM, Interreg Caraibes</em> [<a class="reference internal" href="../base/references.html#id168" title="OVSM, Interreg Caraibes. URL: https://www.interreg-caraibes.com.">17</a>]</span> / <span id="id3"><em>IPGP</em> [<a class="reference internal" href="../base/references.html#id133" title="IPGP. URL: http://www.ipgp.fr.">11</a>]</span>.</p>
|
|
|
</div>
|
|
|
<div class="section" id="how-it-works">
|
|
|
<h2>How it works<a class="headerlink" href="#how-it-works" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>When receiving a list of arrivals to locate, the plugin builds a Hypo71 input
|
|
|
file with informations from the station inventory and configured profile.
|
|
|
It then runs Hypo71, reads the output file and sends the results (location,
|
|
|
uncertainties, RMS, pick residuals …) to <cite>SeisComP</cite>.</p>
|
|
|
<p>If several trial depths are configured, the plugin will run as many Hypo71
|
|
|
rushes as configured depths.
|
|
|
Then all the results are read, and a decision is made on the best one, based on
|
|
|
location RMS and uncertainty.
|
|
|
A final run is then made with the best result depth as trial depth.</p>
|
|
|
</div>
|
|
|
<div class="section" id="profiles">
|
|
|
<h2>Profiles<a class="headerlink" href="#profiles" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>The plugin allows the user to set up as many profiles as needed.
|
|
|
A profile contains all the information relative to the velocity model and
|
|
|
Hypo71 iteration parameters.</p>
|
|
|
<p>This allows the user to tune the behaviour of Hypo71 to what he needs.
|
|
|
If no profiles are set-up, the plugin will use default Hypo71 profile, according
|
|
|
to example shown in Hypo71 first publication.
|
|
|
Some of this default Hypo71 parameters have been altered to allow more and finer
|
|
|
iteration, since computer power is now far above what was available in the 1970’s.</p>
|
|
|
</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 Hypo71, the output is converted into a <cite>SeisComP</cite> origin (<a class="reference internal" href="../base/glossary.html#term-scml"><span class="xref std std-term">SCML</span></a>)
|
|
|
object including some error measures. The following table shows how
|
|
|
the Hypo71 error measures are mapped to the <cite>SeisComP</cite> 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><cite>SeisComP</cite></p></th>
|
|
|
<th class="head"><p>Hypo71</p></th>
|
|
|
</tr>
|
|
|
</thead>
|
|
|
<tbody>
|
|
|
<tr class="row-even"><td><p>Origin.latitude.uncertainty</p></td>
|
|
|
<td><p>ERH/sqrt(2)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.longitude.uncertainty</p></td>
|
|
|
<td><p>ERH/sqrt(2)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.depth.uncertainty</p></td>
|
|
|
<td><p>ERZ</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.standardError</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.secondaryAzimuthalGap</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.usedStationCount</p></td>
|
|
|
<td><p>usedStationCount</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.associatedStationCount</p></td>
|
|
|
<td><p>associatedStationCount</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.associatedPhaseCount</p></td>
|
|
|
<td><p>associatedPhaseCount</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.usedPhaseCount</p></td>
|
|
|
<td><p>associatedPhaseCount</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.depthPhaseCount</p></td>
|
|
|
<td><p>depthPhaseCount</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.minimumDistance</p></td>
|
|
|
<td><p>km2deg(Tdist.front)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.maximumDistance</p></td>
|
|
|
<td><p>km2deg(Tdist.back)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originQuality.medianDistance</p></td>
|
|
|
<td><p>km2deg(~Tdist)</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originQuality.groundTruthLevel</p></td>
|
|
|
<td><p>QUALITY</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originUncertainty.horizontalUncertainty</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originUncertainty.minHorizontalUncertainty</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>Origin.originUncertainty.maxHorizontalUncertainty</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>Origin.originUncertainty.azimuthMaxHorizontalUncertainty</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>ConfidenceEllipsoid.semiMajorAxisLength</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>ConfidenceEllipsoid.semiMinorAxisLength</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>ConfidenceEllipsoid.semiIntermediateAxisLength</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>ConfidenceEllipsoid.majorAxisPlunge</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>ConfidenceEllipsoid.majorAxisAzimuth</p></td>
|
|
|
<td><p>_</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>ConfidenceEllipsoid.majorAxisRotation</p></td>
|
|
|
<td><p>_</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 <em>hypo71</em> plugin is installed under <code class="file docutils literal notranslate"><span class="pre">share/plugins/hypo71.so</span></code>.
|
|
|
It provides a new implementation of the LocatorInterface with the name Hypo71.</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>, hypo71
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Basically it can be used by two <cite>SeisComP</cite> 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 <code class="xref std std-confval docutils literal notranslate"><span class="pre">HYPO71ROOT</span></code>.</p>
|
|
|
<p>The following file are stored:</p>
|
|
|
<ul class="simple">
|
|
|
<li><p>Input file (input)</p></li>
|
|
|
<li><p>Input configuration (.INP)</p></li>
|
|
|
<li><p>Hypo71 location header (.OUT)</p></li>
|
|
|
<li><p>Hypo71 location results (.PRT)</p></li>
|
|
|
<li><p>Hypo71 ZTR evalutation log (.LOG)</p></li>
|
|
|
</ul>
|
|
|
<p>In addition to the native Hypo71 outp ut a <cite>SeisComP</cite> origin object is created and
|
|
|
returned to the calling instance. Usually this object is then sent via messaging.</p>
|
|
|
<p>In addition, the stdout output of the locator is redirected to <cite>SeisComP</cite> output at
|
|
|
INFO level. Each line is identified by leading “Hypo71PC:”, e.g.:</p>
|
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="mi">12</span><span class="p">:</span><span class="mi">02</span><span class="p">:</span><span class="mi">25</span> <span class="p">[</span><span class="n">info</span><span class="p">]</span> <span class="n">Hypo71PC</span><span class="p">:</span> <span class="n">Date</span> <span class="n">Heure</span> <span class="n">Minute</span> <span class="n">Seconde</span>
|
|
|
<span class="mi">12</span><span class="p">:</span><span class="mi">02</span><span class="p">:</span><span class="mi">25</span> <span class="p">[</span><span class="n">info</span><span class="p">]</span> <span class="n">Hypo71PC</span><span class="p">:</span> <span class="mi">90113</span> <span class="mi">22</span> <span class="mi">48</span> <span class="mf">3.78</span> <span class="n">Nb</span> <span class="n">Iterations</span> <span class="p">:</span> <span class="mi">3</span>
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>To view this output on the command line add <em>–debug</em> to your application when executing on
|
|
|
the command line. Increasing logging level of the module which executes the plugin
|
|
|
allows to read the output in the log file:</p>
|
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">loggging</span><span class="o">.</span><span class="n">level</span> <span class="o">=</span> <span class="mi">3</span>
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</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>, hypo71
|
|
|
</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">############# Hypo71 plugin configuration ##############</span>
|
|
|
<span class="c1">########################################################</span>
|
|
|
|
|
|
<span class="c1"># Hypo71 input file to process (generated by plugin)</span>
|
|
|
hypo71.inputFile <span class="o">=</span> @DATADIR@/hypo71/HYPO71.INP
|
|
|
|
|
|
<span class="c1"># Hypo71 log file to store ZTR calculation and final results</span>
|
|
|
hypo71.logFile <span class="o">=</span> @LOGDIR@/HYPO71.LOG
|
|
|
|
|
|
<span class="c1"># Hypo71 output file to read results from (generated by binary)</span>
|
|
|
hypo71.outputFile <span class="o">=</span> @DATADIR@/hypo71/HYPO71.PRT
|
|
|
|
|
|
<span class="c1"># Hypo71 script called by plugin</span>
|
|
|
hypo71.hypo71ScriptFile <span class="o">=</span> @DATADIR@/hypo71/run.sh
|
|
|
|
|
|
<span class="c1"># Hypo71 default profile</span>
|
|
|
hypo71.defaultControlFile <span class="o">=</span> @DATADIR@/hypo71/profiles/default.hypo71.conf
|
|
|
|
|
|
<span class="c1"># Hypo71 origin patternID</span>
|
|
|
hypo71.publicID <span class="o">=</span> Hypo71.@time/%Y%m%d%H%M%S.%f@.@id@
|
|
|
|
|
|
<span class="c1"># Should we use the custom patternID ?</span>
|
|
|
hypo71.useHypo71PatternID <span class="o">=</span> <span class="nb">false</span>
|
|
|
|
|
|
<span class="c1"># Hypo71 custom profiles examples</span>
|
|
|
hypo71.profiles <span class="o">=</span> ModelA
|
|
|
hypo71.profile.ModelA.earthModelID <span class="o">=</span> <span class="s2">"My Velocity Model A"</span>
|
|
|
hypo71.profile.ModelA.methodID <span class="o">=</span> Hypo71PC
|
|
|
hypo71.profile.ModelA.controlFile <span class="o">=</span> @DATADIR@/hypo71/profiles/profile.a.conf
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Verify that everything is properly set up in the script <code class="file docutils literal notranslate"><span class="pre">@DATADIR@/hypo71/run.sh</span></code></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="ch">#!/bin/bash</span>
|
|
|
<span class="nv">HYPO71PC_BINARY</span><span class="o">=</span>Hypo71PC
|
|
|
<span class="nv">HYPO71PC_HOME</span><span class="o">=</span><span class="sb">`</span>dirname <span class="nv">$0</span><span class="sb">`</span>
|
|
|
|
|
|
<span class="c1"># Jumping into the right directory</span>
|
|
|
<span class="nb">cd</span> <span class="si">${</span><span class="nv">HYPO71PC_HOME</span><span class="si">}</span>/
|
|
|
|
|
|
<span class="c1"># Executing binary with input file as argument</span>
|
|
|
<span class="si">${</span><span class="nv">SEISCOMP_ROOT</span><span class="si">}</span>/bin/<span class="nv">$HYPO71PC_BINARY</span> < input
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Verify that everything is properly set up in the file <code class="file docutils literal notranslate"><span class="pre">$</span><em><span class="pre">SEISCOMP_ROOT</span></em><span class="pre">/share/hypo71/input</span></code></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>HYPO71.INP
|
|
|
HYPO71.PRT
|
|
|
HYPO71.OUT
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<div class="admonition important">
|
|
|
<p class="admonition-title">Important</p>
|
|
|
<p>There must be 3 blank lines at the end of the <code class="file docutils literal notranslate"><span class="pre">input</span></code> file, those are not to be removed.</p>
|
|
|
</div>
|
|
|
<p>Finally set-up your Hypo71 profile (e.g. <code class="file docutils literal notranslate"><span class="pre">$</span><em><span class="pre">SEISCOMP_ROOT</span></em><span class="pre">/share/hypo71/profiles/profile.a.conf</span></code>)</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1">############################################################</span>
|
|
|
<span class="c1">## HYPO71 SeisComP Plugin ##</span>
|
|
|
<span class="c1">## @OVSM-IPGP ##</span>
|
|
|
<span class="c1">## ##</span>
|
|
|
<span class="c1">############################################################</span>
|
|
|
|
|
|
<span class="c1">## This profile is based on Dorel velocity model for French Antilles</span>
|
|
|
<span class="c1">## It allows several iterations at different starting depth for deep and crustal earthquakes</span>
|
|
|
|
|
|
<span class="c1">##############</span>
|
|
|
<span class="c1"># Reset List #</span>
|
|
|
<span class="c1">##############</span>
|
|
|
TEST<span class="o">(</span><span class="m">01</span><span class="o">)</span> <span class="o">=</span> .1 <span class="c1"># sec # cutoff RMS value under which Jeffrey's weghting of residuals is not used</span>
|
|
|
TEST<span class="o">(</span><span class="m">02</span><span class="o">)</span> <span class="o">=</span> <span class="m">50</span>. <span class="c1"># km #</span>
|
|
|
TEST<span class="o">(</span><span class="m">03</span><span class="o">)</span> <span class="o">=</span> <span class="m">0</span>.2 <span class="c1"># critical F-value for the stepwise multiple regression</span>
|
|
|
TEST<span class="o">(</span><span class="m">04</span><span class="o">)</span> <span class="o">=</span> .01 <span class="c1"># km # adjustment value under which Geiger's iteration is terminated</span>
|
|
|
TEST<span class="o">(</span><span class="m">05</span><span class="o">)</span> <span class="o">=</span> <span class="m">5</span>. <span class="c1"># km # focal-depth value above which DZ is rest to DZ / (K+1)</span>
|
|
|
TEST<span class="o">(</span><span class="m">06</span><span class="o">)</span> <span class="o">=</span> <span class="m">4</span>. <span class="c1"># regression TEST(03)/TEST(06) coefficient value if no significant variable is found in the stepwise multiple regression</span>
|
|
|
TEST<span class="o">(</span><span class="m">10</span><span class="o">)</span> <span class="o">=</span> <span class="m">2</span>. <span class="c1"># km # coefficient value J = D/TEST(10) used for resetting DX and DY</span>
|
|
|
TEST<span class="o">(</span><span class="m">11</span><span class="o">)</span> <span class="o">=</span> <span class="m">999</span>. <span class="c1"># maximum number of iterations in the hypocentral adjustment</span>
|
|
|
TEST<span class="o">(</span><span class="m">12</span><span class="o">)</span> <span class="o">=</span> .5 <span class="c1"># coefficient value DZ = -Z*TEST(12) used for resetting DZ when hypocenter is placed in the air</span>
|
|
|
TEST<span class="o">(</span><span class="m">13</span><span class="o">)</span> <span class="o">=</span> <span class="m">1</span>. <span class="c1"># km # standard error value of hypocentral optionally calculated RMS</span>
|
|
|
|
|
|
<span class="c1">## The following values are only available with the Hypo71PC version modified by Alexandre Nercessian (IPGP) which is included with this plugin</span>
|
|
|
TEST<span class="o">(</span><span class="m">15</span><span class="o">)</span> <span class="o">=</span> -2. <span class="c1"># km # maximum altitude of earthquake in km (down is positive)</span>
|
|
|
TEST<span class="o">(</span><span class="m">20</span><span class="o">)</span> <span class="o">=</span> <span class="m">1</span>. <span class="c1"># used altitude = read altitude * TEST(20) - for example, -2500 = -250 * 10</span>
|
|
|
|
|
|
|
|
|
<span class="c1">######################</span>
|
|
|
<span class="c1"># Crustal Model List #</span>
|
|
|
<span class="c1">######################</span>
|
|
|
<span class="nv">CRUSTAL_VELOCITY_MODEL</span> <span class="o">=</span> <span class="m">3</span>.50, <span class="m">6</span>.00, <span class="m">7</span>.00, <span class="m">8</span>.00
|
|
|
<span class="nv">CRUSTAL_DEPTH_MODEL</span> <span class="o">=</span> <span class="m">0</span>.00, <span class="m">3</span>.00, <span class="m">15</span>.00, <span class="m">30</span>.00
|
|
|
|
|
|
|
|
|
<span class="c1">################</span>
|
|
|
<span class="c1"># Control Card #</span>
|
|
|
<span class="c1">################</span>
|
|
|
<span class="c1"># MANDATORY</span>
|
|
|
<span class="nv">ZTR</span> <span class="o">=</span> <span class="m">5</span>, <span class="m">20</span>, <span class="m">40</span>, <span class="m">60</span>, <span class="m">80</span>, <span class="m">100</span>, <span class="m">150</span>, <span class="m">200</span> <span class="c1"># km # trial focus depth, at least two</span>
|
|
|
<span class="c1"># MANDATORY</span>
|
|
|
<span class="nv">XNEAR</span> <span class="o">=</span> <span class="m">200</span>. <span class="c1"># km # distance from epicenter up to which the distance weighting is 1</span>
|
|
|
<span class="c1"># MANDATORY</span>
|
|
|
<span class="nv">XFAR</span> <span class="o">=</span> <span class="m">450</span>. <span class="c1"># km # distance from epicenter beyond which the distance weighting is 0</span>
|
|
|
<span class="c1"># MANDATORY</span>
|
|
|
<span class="nv">POS</span> <span class="o">=</span> <span class="m">1</span>.76 <span class="c1"># ratio of P-velocity to S-velocity</span>
|
|
|
|
|
|
<span class="nv">KAZ</span> <span class="o">=</span> <span class="m">1</span> <span class="c1"># 1 or blank # apply azimuthal weighting of stations ?</span>
|
|
|
<span class="nv">KSORT</span> <span class="o">=</span> <span class="m">1</span> <span class="c1"># 1 or blank # sort stations by distance in the output ?</span>
|
|
|
|
|
|
<span class="c1"># Use the position obtained from the best ZTR value ?</span>
|
|
|
<span class="nv">USE_TRIAL_POSITION</span> <span class="o">=</span> <span class="nb">false</span>
|
|
|
|
|
|
|
|
|
<span class="c1">####################</span>
|
|
|
<span class="c1"># Instruction Card #</span>
|
|
|
<span class="c1">####################</span>
|
|
|
<span class="nv">KNST</span> <span class="o">=</span> <span class="m">1</span> <span class="c1"># use S data ?</span>
|
|
|
<span class="nv">INST</span> <span class="o">=</span> <span class="m">0</span> <span class="c1"># fix depth ?</span>
|
|
|
|
|
|
<span class="c1">#####################################</span>
|
|
|
<span class="c1"># Optionnal Weighting Look-Up Table #</span>
|
|
|
<span class="c1">#####################################</span>
|
|
|
<span class="c1"># Uncomment if you want to disable dynamic weighting and use those uncertainties as</span>
|
|
|
<span class="c1"># boundaries for weighting (e.g. a pick with +-0.02 will have a weight of 0)</span>
|
|
|
<span class="c1">#WEIGHT_UNCERTAINTY_BOUNDARIES = 0.1, 0.2, 0.5, 1.0</span>
|
|
|
</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 Hypo71 plugin is straight forward. Once loaded successfully
|
|
|
the new locator shows up in the lower left corners combo box.</p>
|
|
|
<div class="figure align-center">
|
|
|
<img alt="../_images/locator_selection_small.png" src="../_images/locator_selection_small.png" />
|
|
|
</div>
|
|
|
<p>Select the new Hypo71 locator and a profile from the pre-configured list.</p>
|
|
|
<div class="figure align-center">
|
|
|
<img alt="../_images/locator_profile_selection_small.png" src="../_images/locator_profile_selection_small.png" />
|
|
|
</div>
|
|
|
<p>The Hypo71 implementation doesn’t provide a virtual profile automatically but the
|
|
|
plugins ships with some example profiles.</p>
|
|
|
<p>If an origin has been relocated the method should be set to “Hypo71” and
|
|
|
the earth model contains the name of the profile used to perform this localization.</p>
|
|
|
<div class="figure align-center">
|
|
|
<img alt="../_images/origin_information.png" src="../_images/origin_information.png" />
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="settings">
|
|
|
<h3>Settings<a class="headerlink" href="#settings" title="Permalink to this headline">¶</a></h3>
|
|
|
<p>The Hypo71 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-center">
|
|
|
<img alt="../_images/locator_settings.png" src="../_images/locator_settings.png" />
|
|
|
</div>
|
|
|
<p>Then the Hypo71 selected profile parameters show up.</p>
|
|
|
<div class="figure align-center">
|
|
|
<img alt="../_images/hypo71_settings.png" src="../_images/hypo71_settings.png" />
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="more">
|
|
|
<h2>More<a class="headerlink" href="#more" title="Permalink to this headline">¶</a></h2>
|
|
|
<ul class="simple">
|
|
|
<li><p>Take a look at Fred Klein HYPOINVERSE Earthquake Location software (<span id="id4">Klein [<a class="reference internal" href="../base/references.html#id47" title="F.W. Klein. User’s guide to HYPOINVERSE-2000, a Fortran program to solve for earthquake locations and magnitudes. US Geological Survey, 2002-171:, 2002. URL: https://www.usgs.gov/node/279394, doi:10.3133/ofr02171.">47</a>]</span>),</p></li>
|
|
|
<li><p>Hypo71PC original manual and binary are available on USGS website (<span id="id5">Lee and Lahr [<a class="reference internal" href="../base/references.html#id51" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">48</a>]</span>).</p></li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
<div class="section" id="module-configuration">
|
|
|
<span id="global-hypo71-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this headline">¶</a></h2>
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p><strong>hypo71.*</strong>
|
|
|
<em>General Hypo71 configuration parameters.</em></p>
|
|
|
</div>
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.logFile">
|
|
|
<code class="sig-name descname">hypo71.logFile</code><a class="headerlink" href="#confval-hypo71.logFile" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">@LOGDIR@/HYPO71.LOG</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>Temporary file used by Hypo71 to store calculation logs.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.inputFile">
|
|
|
<code class="sig-name descname">hypo71.inputFile</code><a class="headerlink" href="#confval-hypo71.inputFile" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">@DATADIR@/hypo71/HYPO71.INP</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>Temporary file to write Hypo71 input data to.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.outputFile">
|
|
|
<code class="sig-name descname">hypo71.outputFile</code><a class="headerlink" href="#confval-hypo71.outputFile" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">@DATADIR@/hypo71/HYPO71.PRT</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>Temporary output file to read Hypo71 location data from.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.defaultControlFile">
|
|
|
<code class="sig-name descname">hypo71.defaultControlFile</code><a class="headerlink" href="#confval-hypo71.defaultControlFile" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">@DATADIR@/hypo71/profiles/default.hypo71.conf</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>Hypo71 default profile.
|
|
|
If no custom profile is specified, this profile will be used by the plugin when proceeding to a localization.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.hypo71ScriptFile">
|
|
|
<code class="sig-name descname">hypo71.hypo71ScriptFile</code><a class="headerlink" href="#confval-hypo71.hypo71ScriptFile" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">@DATADIR@/hypo71/run.sh</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>Bash script executed when calling the Hypo71 locator plugin for locating the earthquake.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.profiles">
|
|
|
<code class="sig-name descname">hypo71.profiles</code><a class="headerlink" href="#confval-hypo71.profiles" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>list:string</em></p>
|
|
|
<p>Hypo71 profile name.
|
|
|
Multiples names may be set. They must be separated by comma.
|
|
|
Each profile can have different velocity or parameters.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.publicID">
|
|
|
<code class="sig-name descname">hypo71.publicID</code><a class="headerlink" href="#confval-hypo71.publicID" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>string</em></p>
|
|
|
<p>Custom patternID to use when generating origin publicID</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.useHypo71PatternID">
|
|
|
<code class="sig-name descname">hypo71.useHypo71PatternID</code><a class="headerlink" href="#confval-hypo71.useHypo71PatternID" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>boolean</em></p>
|
|
|
<p>Specifies if the given publicD should be used for generating origin publicID</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p><strong>hypo71.profile.*</strong>
|
|
|
<em>Profiles containing the profile-specific velocity model and the Hypo71 parameters.</em></p>
|
|
|
</div>
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p><strong>hypo71.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-hypo71.profiles"><code class="xref std std-confval docutils literal notranslate"><span class="pre">hypo71.profiles</span></code></a> to become active.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>hypo71.profiles <span class="o">=</span> a,b
|
|
|
hypo71.profile.a.value1 <span class="o">=</span> ...
|
|
|
hypo71.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 hypo71.profiles</span>
|
|
|
hypo71.profile.c.value1 <span class="o">=</span> ...
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.profile.$name.earthModelID">
|
|
|
<code class="sig-name descname">hypo71.profile.$name.earthModelID</code><a class="headerlink" href="#confval-hypo71.profile.$name.earthModelID" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>string</em></p>
|
|
|
<p>Profile’s velocity model name.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.profile.$name.methodID">
|
|
|
<code class="sig-name descname">hypo71.profile.$name.methodID</code><a class="headerlink" href="#confval-hypo71.profile.$name.methodID" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Hypo71</span></code></p>
|
|
|
<p>Type: <em>string</em></p>
|
|
|
<p>Profile’s method.
|
|
|
It is generally the locator’s name (Hypo71).</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.profile.$name.controlFile">
|
|
|
<code class="sig-name descname">hypo71.profile.$name.controlFile</code><a class="headerlink" href="#confval-hypo71.profile.$name.controlFile" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>string</em></p>
|
|
|
<p>File containing the profile parameters.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-hypo71.profile.$name.fixStartDepthOnly">
|
|
|
<code class="sig-name descname">hypo71.profile.$name.fixStartDepthOnly</code><a class="headerlink" href="#confval-hypo71.profile.$name.fixStartDepthOnly" 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 the depth is requested to be fixed (e.g. by ticking the option
|
|
|
in scolv) the plugin performs only one location starting at
|
|
|
specified depth but with free depth evaluation. This option
|
|
|
defines whether it should really fix the depth (false) or
|
|
|
use this fixed depth only as starting point (true).</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="#">Hypo71</a><ul>
|
|
|
<li><a class="reference internal" href="#description">Description</a></li>
|
|
|
<li><a class="reference internal" href="#how-it-works">How it works</a></li>
|
|
|
<li><a class="reference internal" href="#profiles">Profiles</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="#usage">Usage</a><ul>
|
|
|
<li><a class="reference internal" href="#locator">Locator</a></li>
|
|
|
<li><a class="reference internal" href="#settings">Settings</a></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
<li><a class="reference internal" href="#more">More</a></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="global_mlh.html"
|
|
|
title="previous chapter">MLh</a></p>
|
|
|
<h4>Next topic</h4>
|
|
|
<p class="topless"><a href="global_md.html"
|
|
|
title="next chapter">Md</a></p>
|
|
|
<div role="note" aria-label="source link">
|
|
|
<h3>This Page</h3>
|
|
|
<ul class="this-page-menu">
|
|
|
<li><a href="../_sources/apps/global_hypo71.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> |