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

337 lines
16 KiB
HTML

<!DOCTYPE html>
<html >
<head>
<meta charset="utf-8" />
<title>scxmlmerge &#8212; SeisComP Release documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script src="../_static/jquery.js"></script>
<script src="../_static/underscore.js"></script>
<script src="../_static/doctools.js"></script>
<script src="../_static/language_data.js"></script>
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="sczip" href="sczip.html" />
<link rel="prev" title="scxmldump" href="scxmldump.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="sczip.html" title="sczip"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="scxmldump.html" title="scxmldump"
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="../modules.html" >Modules</a>
</li>
<li class="nav-item nav-item-2">
<a href="../toc/utilities.html" accesskey="U">Utilities</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="scxmlmerge">
<span id="id1"></span><h1>scxmlmerge<a class="headerlink" href="#scxmlmerge" title="Permalink to this headline"></a></h1>
<p><strong>Merge the content of multiple XML files in SCML format.</strong></p>
<div class="section" id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>scxmlmerge reads all <cite>SeisComP</cite> elements from one or more XML files in <a class="reference internal" href="../base/glossary.html#term-scml"><span class="xref std std-term">SCML</span></a>
format. It merges the content and prints the result to standard output. The
input can contain and <a class="reference internal" href="../base/api-python.html#api-datamodel-python"><span class="std std-ref">SeisComP element</span></a> and the
content can be filtered to print only some elements such as EventParameters.
The output can be redirected into one single file and used by other applications.</p>
<p>The supported <a class="reference internal" href="../base/api-python.html#api-datamodel-python"><span class="std std-ref">SeisComP elements</span></a> are:</p>
<ul class="simple">
<li><p>Config</p></li>
<li><p>DataAvailability</p></li>
<li><p>EventParameters</p></li>
<li><p>Inventory</p></li>
<li><p>QualityControl</p></li>
<li><p>Routing</p></li>
</ul>
<p>By default all supported elements will be parsed and merged. Duplicates are removed.
Use options to restrict the element types.</p>
<p>There are alternative modules for processing inventory XML files:</p>
<ul class="simple">
<li><p><a class="reference internal" href="scinv.html#scinv"><span class="std std-ref">scinv</span></a>: Merge inventory XML files, extract inventory information.</p></li>
<li><p><a class="reference internal" href="invextr.html#invextr"><span class="std std-ref">invextr</span></a>: Extract and filter inventory information.</p></li>
</ul>
</div>
<div class="section" id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<ol class="arabic">
<li><p>Merge the all SeisComP elements from 2 XML files into a single XML file:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmlmerge file1.xml file2.xml &gt; file.xml
</pre></div>
</div>
</li>
<li><p>Merge the all EventParameters and all Config elements from 2 XML files into a
single XML file. Other element types will be ignored:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmlmerge -E -C file1.xml file2.xml &gt; file.xml
</pre></div>
</div>
</li>
</ol>
</div>
<div class="section" id="module-configuration">
<span id="scxmlmerge-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this headline"></a></h2>
<div class="line-block">
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/scxmlmerge.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/scxmlmerge.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/scxmlmerge.cfg</span></code></div>
</div>
<p>scxmlmerge inherits <a class="reference internal" href="global.html#global-configuration"><span class="std std-ref">global options</span></a>.</p>
</div>
<div class="section" id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this headline"></a></h2>
<p><strong class="program">scxmlmerge [options] inputFiles</strong></p>
<div class="section" id="generic">
<h3>Generic<a class="headerlink" href="#generic" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scxmlmerge-h">
<code class="sig-name descname">-h</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--help</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-h" title="Permalink to this definition"></a></dt>
<dd><p>Show help message.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-v">
<code class="sig-name descname">-V</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--version</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-v" title="Permalink to this definition"></a></dt>
<dd><p>Show version information.</p>
</dd></dl>
</div>
<div class="section" id="verbosity">
<h3>Verbosity<a class="headerlink" href="#verbosity" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scxmlmerge-verbosity">
<code class="sig-name descname">--verbosity</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scxmlmerge-verbosity" title="Permalink to this definition"></a></dt>
<dd><p>Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info,
4:debug.</p>
</dd></dl>
<dl class="option">
<dt id="id2">
<code class="sig-name descname">-v</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--v</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#id2" title="Permalink to this definition"></a></dt>
<dd><p>Increase verbosity level (may be repeated, eg. -vv).</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-q">
<code class="sig-name descname">-q</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--quiet</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-q" title="Permalink to this definition"></a></dt>
<dd><p>Quiet mode: no logging output.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-print-component">
<code class="sig-name descname">--print-component</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scxmlmerge-print-component" title="Permalink to this definition"></a></dt>
<dd><p>For each log entry print the component right after the
log level. By default the component output is enabled
for file output but disabled for console output.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-component">
<code class="sig-name descname">--component</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scxmlmerge-component" title="Permalink to this definition"></a></dt>
<dd><p>Limit the logging to a certain component. This option can
be given more than once.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-s">
<code class="sig-name descname">-s</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--syslog</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-s" title="Permalink to this definition"></a></dt>
<dd><p>Use syslog logging backend. The output usually goes to
/var/lib/messages.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-l">
<code class="sig-name descname">-l</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--lockfile</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scxmlmerge-l" title="Permalink to this definition"></a></dt>
<dd><p>Path to lock file.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-console">
<code class="sig-name descname">--console</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scxmlmerge-console" title="Permalink to this definition"></a></dt>
<dd><p>Send log output to stdout.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-debug">
<code class="sig-name descname">--debug</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-debug" title="Permalink to this definition"></a></dt>
<dd><p>Execute in debug mode.
Equivalent to verbosity=4 console=1 .</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-trace">
<code class="sig-name descname">--trace</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-trace" title="Permalink to this definition"></a></dt>
<dd><p>Execute in trace mode.
Equivalent to verbosity=4 console=1 print-component=1
print-context=1 .</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-log-file">
<code class="sig-name descname">--log-file</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-scxmlmerge-log-file" title="Permalink to this definition"></a></dt>
<dd><p>Use alternative log file.</p>
</dd></dl>
</div>
<div class="section" id="options">
<h3>Options<a class="headerlink" href="#options" title="Permalink to this headline"></a></h3>
<dl class="option">
<dt id="cmdoption-scxmlmerge-event">
<code class="sig-name descname">--event</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-event" title="Permalink to this definition"></a></dt>
<dd><p>Include Event Parameters.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-inventory">
<code class="sig-name descname">--inventory</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-inventory" title="Permalink to this definition"></a></dt>
<dd><p>Include Inventory.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-config">
<code class="sig-name descname">--config</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-config" title="Permalink to this definition"></a></dt>
<dd><p>Include Config.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-routing">
<code class="sig-name descname">--routing</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-routing" title="Permalink to this definition"></a></dt>
<dd><p>Include Routing.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-quality">
<code class="sig-name descname">--quality</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-quality" title="Permalink to this definition"></a></dt>
<dd><p>Include QualityControl.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-scxmlmerge-availability">
<code class="sig-name descname">--availability</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scxmlmerge-availability" title="Permalink to this definition"></a></dt>
<dd><p>Include DataAvailability.</p>
</dd></dl>
</div>
</div>
</div>
<div id="anchors-bottom"></div>
</div>
<div class="sidebar" role="navigation" aria-label="main navigation">
<div id="anchors-top"></div>
<div id="anchors" class="content">
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" />
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>$('#searchbox').show(0);</script>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">scxmlmerge</a><ul>
<li><a class="reference internal" href="#description">Description</a></li>
<li><a class="reference internal" href="#examples">Examples</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="#options">Options</a></li>
</ul>
</li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="scxmldump.html"
title="previous chapter">scxmldump</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="sczip.html"
title="next chapter">sczip</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/scxmlmerge.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="horizontal layout content">
<a class="fade-in" href="https://www.gempa.de" target="_blank">
<img class="brand" src="../_static/brands/gempa.svg"/>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>5.3.0</b> Release
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.
</div>
</div>
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
<img class="brand" src="../_static/brands/gfz.svg"/>
</a>
</div>
</div>
</div>
</body>
</html>