SCRUG-NA/2025
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a7dd0d6c6595686693bb8f04f34471b99efb3c11
2025/share/doc/seiscomp/html/apps/sccnv.html

384 lines
19 KiB
HTML
Raw Blame History

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>sccnv &#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/pygments.css?v=72bcf2f2" />
<link rel="stylesheet" type="text/css" href="../_static/seiscomp.css?v=c6da7ce6" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=4825356b"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="scdb" href="scdb.html" />
<link rel="prev" title="scchkcfg" href="scchkcfg.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.1</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="scdb.html" title="scdb"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="scchkcfg.html" title="scchkcfg"
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">
<section id="sccnv">
<span id="id1"></span><h1>sccnv<a class="headerlink" href="#sccnv" title="Permalink to this heading"></a></h1>
<p><strong>Converts data in different formats.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>sccnv reads input given in a supported format, converts the content to another
format and writes the output. Use the command-line option <code class="xref std std-confval docutils literal notranslate"><span class="pre">format-list</span></code>
for a list of supported formats.</p>
</section>
<section id="formats">
<h2>Formats<a class="headerlink" href="#formats" title="Permalink to this heading"></a></h2>
<p>Different formats are supported for input and output files.</p>
<table class="docutils align-left">
<colgroup>
<col style="width: 11.1%" />
<col style="width: 66.7%" />
<col style="width: 11.1%" />
<col style="width: 11.1%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Name</p></th>
<th class="head"><p>Description</p></th>
<th class="head"><p>Input</p></th>
<th class="head"><p>Output</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>arclink</p></td>
<td><p><a class="reference external" href="https://www.seiscomp.de/seiscomp3/doc/applications/arclink-status-xml.html">Arclink XML</a></p></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>bson</p></td>
<td></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>bson-json</p></td>
<td></td>
<td></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>csv</p></td>
<td><p>comma-separated values</p></td>
<td></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>hyp71sum2k</p></td>
<td><p>Hypo71 format</p></td>
<td></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>ims10</p></td>
<td></td>
<td></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>json</p></td>
<td><p><a class="reference external" href="https://www.json.org/">JSON</a> format</p></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>qml1.2</p></td>
<td><p><a class="reference internal" href="../base/glossary.html#term-QuakeML"><span class="xref std std-term">QuakeML</span></a> format</p></td>
<td><p>*</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>qml1.2rt</p></td>
<td><p><a class="reference internal" href="../base/glossary.html#term-QuakeML"><span class="xref std std-term">QuakeML</span></a> real time (RT) format</p></td>
<td><p>*</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>scdm0.51</p></td>
<td></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>trunk</p></td>
<td><p>SeisComP XML (<a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a>) - <a class="reference internal" href="../base/api-python.html#api-datamodel-python"><span class="std std-ref">SCML API</span></a></p></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
</tbody>
</table>
<p><strong>*</strong>: The conversion from files in QuakeML format is not supported by sccnv
but can be realized by system tools. Read section <a class="reference internal" href="#sec-sccnv-quakeml"><span class="std std-ref">QuakeML</span></a> for
details and instructions.</p>
<section id="quakeml">
<span id="sec-sccnv-quakeml"></span><h3>QuakeML<a class="headerlink" href="#quakeml" title="Permalink to this heading"></a></h3>
<p><a class="reference internal" href="../base/glossary.html#term-QuakeML"><span class="xref std std-term">QuakeML</span></a> is used in a variety of flavors involving, e.g.,</p>
<ul class="simple">
<li><p>Using non-standard objects,</p></li>
<li><p>PublicID references which are not globally unique,</p></li>
<li><p>Missing references to parent objects,</p></li>
<li><p>Missing creationInfo parameters.</p></li>
</ul>
<p>The ability to convert from QuakeML to <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> is thus limited and it
depends on the parameters provided with the input QuakeML file.</p>
<p>However, XSLT stylesheets are provided for mapping the parameters. The files
are located in <code class="file docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/xml/[version]/</span></code> for different <cite>SeisComP</cite> data schema
versions. The stylesheet files provide information on the mapping and on
limitations as well as examples on their application.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>You may find out about the <cite>SeisComP</cite> data schema version using modules along
with the command-line option <cite>-V</cite>, e.g.,</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sccnv<span class="w"> </span>-V
</pre></div>
</div>
</div>
<p>The style sheets can be used along with other stylesheet converter tools provided
by your system, e.g., <strong class="program">xalan</strong> or <strong class="program">xsltproc</strong>. Examples are given
in section <a class="reference internal" href="#sec-sccnv-examples"><span class="std std-ref">Examples</span></a>.</p>
</section>
</section>
<section id="examples">
<span id="sec-sccnv-examples"></span><h2>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h2>
<ul>
<li><p>Print the list of supported formats:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sccnv<span class="w"> </span>--format-list
</pre></div>
</div>
</li>
<li><p>Convert an event parameter file in <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> format to <a class="reference internal" href="../base/glossary.html#term-QuakeML"><span class="xref std std-term">QuakeML</span></a> and
store the content in a file:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sccnv<span class="w"> </span>-i<span class="w"> </span>seiscomp.xml<span class="w"> </span>-o<span class="w"> </span>qml1.2:quakeml.xml
</pre></div>
</div>
</li>
<li><p>Convert an inventory file in Arclink XML format to <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> and store the
content in a file:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sccnv<span class="w"> </span>-i<span class="w"> </span>arclink:Package_inventory.xml<span class="w"> </span>-o<span class="w"> </span>inventory.sc.xml
</pre></div>
</div>
</li>
<li><p>Convert an event parameter file in <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> format to ims1.0 and store the
content in a file:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sccnv<span class="w"> </span>-i<span class="w"> </span>trunk:event.xml<span class="w"> </span>-o<span class="w"> </span>ims10:event.ims
</pre></div>
</div>
</li>
<li><p>Convert QuakeML in version 1.2 to SCML in data schema version 0.12:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>xsltproc<span class="w"> </span><span class="nv">$SEISCOMP_ROOT</span>/share/xml/0.12/quakeml_1.2__sc3ml_0.12.xsl<span class="w"> </span>file.quakeml<span class="w"> </span>&gt;<span class="w"> </span>file_sc.xml
</pre></div>
</div>
</li>
</ul>
</section>
<section id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h2>
<p><strong class="program">sccnv -i format:file -o format:file</strong></p>
<p>sccnv reads the input given in a supported format, converts the content
and writes the output in another format. Use the option <cite>format-list</cite>
for a list of supported formats.</p>
<section id="generic">
<h3>Generic<a class="headerlink" href="#generic" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-h">
<span id="cmdoption-sccnv-help"></span><span class="sig-name descname"><span class="pre">-h</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--help</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-sccnv-h" title="Permalink to this definition"></a></dt>
<dd><p>Show help message.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-V">
<span id="cmdoption-sccnv-version"></span><span class="sig-name descname"><span class="pre">-V</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--version</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-sccnv-V" title="Permalink to this definition"></a></dt>
<dd><p>Show version information.</p>
</dd></dl>
</section>
<section id="verbosity">
<h3>Verbosity<a class="headerlink" href="#verbosity" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-v">
<span id="cmdoption-sccnv-v"></span><span class="sig-name descname"><span class="pre">-v</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--v</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-sccnv-v" title="Permalink to this definition"></a></dt>
<dd><p>Increase verbosity level (may be repeated, eg. -vv).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-debug">
<span class="sig-name descname"><span class="pre">--debug</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-sccnv-debug" title="Permalink to this definition"></a></dt>
<dd><p>Execute in debug mode.
Equivalent to --verbosity=4 --console=1 .</p>
</dd></dl>
</section>
<section id="id2">
<h3>Formats<a class="headerlink" href="#id2" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-format-list">
<span class="sig-name descname"><span class="pre">--format-list</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-sccnv-format-list" title="Permalink to this definition"></a></dt>
<dd><p>List all supported formats</p>
</dd></dl>
</section>
<section id="input">
<h3>Input<a class="headerlink" href="#input" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-i">
<span id="cmdoption-sccnv-input"></span><span class="sig-name descname"><span class="pre">-i</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--input</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-sccnv-i" title="Permalink to this definition"></a></dt>
<dd><p>Input stream [format:][file], default: trunk:-</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-o">
<span id="cmdoption-sccnv-output"></span><span class="sig-name descname"><span class="pre">-o</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--output</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-sccnv-o" title="Permalink to this definition"></a></dt>
<dd><p>Output stream [format:][file], default trunk:-</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-f">
<span id="cmdoption-sccnv-formatted"></span><span class="sig-name descname"><span class="pre">-f</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--formatted</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-sccnv-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted output</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-indent">
<span class="sig-name descname"><span class="pre">--indent</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-sccnv-indent" title="Permalink to this definition"></a></dt>
<dd><p>Formatted line indent. Default: 2</p>
</dd></dl>
</section>
</section>
</section>
<div id="anchors-bottom"></div>
</div>
<div class="sidebar" role="navigation" aria-label="main navigation">
<div id="anchors-top"></div>
<div id="anchors" class="content">
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
<div>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">sccnv</a><ul>
<li><a class="reference internal" href="#description">Description</a></li>
<li><a class="reference internal" href="#formats">Formats</a><ul>
<li><a class="reference internal" href="#quakeml">QuakeML</a></li>
</ul>
</li>
<li><a class="reference internal" href="#examples">Examples</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="#id2">Formats</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="scchkcfg.html"
title="previous chapter">scchkcfg</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="scdb.html"
title="next chapter">scdb</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/sccnv.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="horizontal layout content">
<a class="fade-in" href="https://www.gempa.de" target="_blank">
<img class="brand" src="../_static/brands/gempa.svg"/>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.1</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>
Reference in New Issue View Git Blame Copy Permalink