[installation] Change to nightly
This commit is contained in:
@ -4,7 +4,7 @@
|
||||
<head>
|
||||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<title>Time Formats — SeisComP Release documentation</title>
|
||||
<title>Time Formats — SeisComP Development 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" />
|
||||
@ -12,21 +12,21 @@
|
||||
<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 data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="Software Development Kit" href="sdk.html" />
|
||||
<link rel="prev" title="Filter Grammar" href="filter-grammar.html" />
|
||||
<link rel="next" title="Filter Grammar" href="filter-grammar.html" />
|
||||
<link rel="prev" title="ncurses" href="../apps/scm_ncurses.html" />
|
||||
</head>
|
||||
<body>
|
||||
<div class="header">
|
||||
<div class="container">
|
||||
<div class="brand">
|
||||
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
|
||||
<!-- span class="title">SeisComP Release</span -->
|
||||
<span class="version">6.9.0</span>
|
||||
<!-- span class="title">SeisComP Development</span -->
|
||||
<span class="version">7.0.0</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@ -43,13 +43,13 @@
|
||||
</a>
|
||||
</li>
|
||||
<li class="right">
|
||||
<a href="sdk.html" title="Software Development Kit"
|
||||
<a href="filter-grammar.html" title="Filter Grammar"
|
||||
accesskey="N">
|
||||
next
|
||||
</a>
|
||||
</li>
|
||||
<li class="right">
|
||||
<a href="filter-grammar.html" title="Filter Grammar"
|
||||
<a href="../apps/scm_ncurses.html" title="ncurses"
|
||||
accesskey="P">
|
||||
previous
|
||||
</a>
|
||||
@ -73,12 +73,17 @@
|
||||
etc. are natively given and assumed in UTC. For reading and writing absolute
|
||||
times a range of formats are supported.</p>
|
||||
<p>Historically, the only time format native to <cite>SeisComP</cite> would be</p>
|
||||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">YYYY-MM-DD</span><span class="w"> </span><span class="s">hh:mm:ss.ssssss</span>
|
||||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">'%F</span><span class="w"> </span><span class="s">%T.%f'</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>As a consequence of the space between <em>DD</em> and <em>hh</em> this time string needs
|
||||
to be enclosed by quotes or double quotes. Otherwise, the time string meant to
|
||||
be a single string only would be interpreted as two strings. Example:</p>
|
||||
<p>like</p>
|
||||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">'2025-01-01</span><span class="w"> </span><span class="s">00:00:00.000000'</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>As a consequence of the space character between <em>DD</em> and <em>HH</em> this time string
|
||||
needs to be enclosed by quotes or double quotes. Otherwise, the time string
|
||||
meant to be a single string only would be interpreted as two strings. Example
|
||||
application:</p>
|
||||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scevtls<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--begin<span class="w"> </span><span class="s1">'2024-01-01 12:00:00'</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
@ -94,7 +99,7 @@ new C++ and Python function:</p>
|
||||
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">seiscomp</span><span class="o">.</span><span class="n">core</span><span class="p">()</span><span class="o">.</span><span class="n">time</span><span class="p">()</span><span class="o">.</span><span class="n">fromString</span><span class="p">()</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>In adaptation to the norm <span id="id2"></span> a subset of strings is now
|
||||
<p>In adaptation to the norm <span id="id2"><em>ISO 8601</em> [<a class="reference internal" href="references.html#id159" title="ISO 8601. Wikepedia. URL: https://en.wikipedia.org/wiki/ISO_8601.">14</a>]</span> a subset of strings is now
|
||||
available. Supported formats are</p>
|
||||
<ul class="simple">
|
||||
<li><p>Calender dates,</p></li>
|
||||
@ -109,135 +114,78 @@ available. Supported formats are</p>
|
||||
<li><p>Local times.</p></li>
|
||||
</ul>
|
||||
<table class="docutils align-left" id="id4">
|
||||
<caption><span class="caption-text">List and examples of supported time string formats</span><a class="headerlink" href="#id4" title="Permalink to this table">¶</a></caption>
|
||||
<caption><span class="caption-text">Table: List and examples of supported time string formats</span><a class="headerlink" href="#id4" title="Permalink to this table">¶</a></caption>
|
||||
<colgroup>
|
||||
<col style="width: 30.0%" />
|
||||
<col style="width: 30.0%" />
|
||||
<col style="width: 40.0%" />
|
||||
<col style="width: 60.0%" />
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr class="row-odd"><th class="head"><p>Implementation</p></th>
|
||||
<th class="head"><p>Time string format</p></th>
|
||||
<th class="head"><p>Examples: all actual times are identical</p></th>
|
||||
<tr class="row-odd"><th class="head"><p>Implementation (+)</p></th>
|
||||
<th class="head"><p>Examples: all given times are identical</p></th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr class="row-even"><td><p>%FT%T.%fZ</p></td>
|
||||
<td><p>YYYY-MM-DDThh:mm:ss.ssssssZ</p></td>
|
||||
<td><p>2025-01-01T00:00:00.000000Z</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>%FT%T.%f</p></td>
|
||||
<td><p>YYYY-MM-DDThh:mm:ss.ssssss</p></td>
|
||||
<td><p>2025-01-01T00:00:00.000000</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>%FT%TZ</p></td>
|
||||
<td><p>YYYY-MM-DDThh:mm:ssZ</p></td>
|
||||
<td><p>2025-01-01T00:00:00Z</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>%FT%T</p></td>
|
||||
<td><p>YYYY-MM-DDThh:mm:ss</p></td>
|
||||
<td><p>2025-01-01T00:00:00</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>%FT%R</p></td>
|
||||
<td><p>YYYY-MM-DDThh:mm</p></td>
|
||||
<td><p>2025-01-01T00:00</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>%FT%H</p></td>
|
||||
<td><p>YYYY-MM-DDThh</p></td>
|
||||
<td><p>2025-01-01T00</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>%Y-%jT%T.%f</p></td>
|
||||
<td><p>YYYY-DDDThh:mm:ss.ssssss</p></td>
|
||||
<td><p>2025-001T00:00:00.000000</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>%Y-%jT%T</p></td>
|
||||
<td><p>YYYY-DDDThh:mm:ss</p></td>
|
||||
<td><p>2025-001T00:00:00</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>%Y-%jT%R</p></td>
|
||||
<td><p>YYYY-DDDThh:mm</p></td>
|
||||
<td><p>2025-001T00:00</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>%Y-%jT%H</p></td>
|
||||
<td><p>YYYY-DDDThh</p></td>
|
||||
<td><p>2025-001T00</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>%F %T.%f (*)</p></td>
|
||||
<td><p>YYYY-MM-DD hh:mm:ss.ssssss</p></td>
|
||||
<td><p>‘2025-01-01 00:00:00.000000’</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>%F %T (*)</p></td>
|
||||
<td><p>YYYY-MM-DD hh:mm:ss</p></td>
|
||||
<td><p>‘2025-01-01 00:00:00’</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>%F %R (*)</p></td>
|
||||
<td><p>YYYY-MM-DD hh:mm</p></td>
|
||||
<td><p>‘2025-01-01 00:00’</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>%F %H (*)</p></td>
|
||||
<td><p>YYYY-MM-DD hh</p></td>
|
||||
<td><p>‘2025-01-01 00’</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>%F</p></td>
|
||||
<td><p>YYYY-MM-DD</p></td>
|
||||
<td><p>2025-01-01</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>%Y-%j</p></td>
|
||||
<td><p>YYYY-DDD</p></td>
|
||||
<td><p>2025-001</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>%Y</p></td>
|
||||
<td><p>YYYY</p></td>
|
||||
<td><p>2025</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>(+): Compare the formats with those of the <strong class="program">date</strong> command:
|
||||
<strong class="program">man date</strong>.</p>
|
||||
<p>(*): Time strings with spaces must be enclosed by quotes or double quotes for
|
||||
protecting the space.</p>
|
||||
<table class="docutils align-left" id="id5">
|
||||
<caption><span class="caption-text">List of format symbols used in table of time string formats</span><a class="headerlink" href="#id5" title="Permalink to this table">¶</a></caption>
|
||||
<colgroup>
|
||||
<col style="width: 10.0%" />
|
||||
<col style="width: 90.0%" />
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr class="row-odd"><th class="head"><p>Symbol</p></th>
|
||||
<th class="head"><p>Description</p></th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr class="row-even"><td><p>YYYY</p></td>
|
||||
<td><p>4-digit year</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>MM</p></td>
|
||||
<td><p>2-digit month starting with 01</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>DD</p></td>
|
||||
<td><p>1- or 2-digit day of the month starting with 01</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>DDD</p></td>
|
||||
<td><p>1-, 2- or 3-digit day of year starting with 001</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>hh</p></td>
|
||||
<td><p>1- or 2-digit hour of the day starting with 00</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>mm</p></td>
|
||||
<td><p>1- or 2-digit minute of the hour starting with 00</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>ss</p></td>
|
||||
<td><p>1- or 2-digit second of the minute starting with 00</p></td>
|
||||
</tr>
|
||||
<tr class="row-odd"><td><p>ssssss</p></td>
|
||||
<td><p>1-6 digits decimal fraction of a second with 0</p></td>
|
||||
</tr>
|
||||
<tr class="row-even"><td><p>Z</p></td>
|
||||
<td><p>Zone designator for the zero UTC offset</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>Durations can be formed from start and end dates and times combined by tilde(~).
|
||||
Example:</p>
|
||||
protecting the space character.</p>
|
||||
<p>Time spans can be formed from start and end dates and times combined by tilde
|
||||
(~). Examples:</p>
|
||||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scart<span class="w"> </span>-dsEv<span class="w"> </span>-t<span class="w"> </span><span class="m">2024</span>-01-01T12~2024-01-01T12:15:30.2Z
|
||||
scart<span class="w"> </span>-dsEv<span class="w"> </span>-t<span class="w"> </span><span class="s1">'2024-01-01 12:00:00~2024-01-01 12:15:30.2'</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</section>
|
||||
@ -246,7 +194,7 @@ Example:</p>
|
||||
<p>Amplitudes are measured on waveforms by modules such as <a class="reference internal" href="../apps/scautopick.html#scautopick"><span class="std std-ref">scautopick</span></a>,
|
||||
<a class="reference internal" href="../apps/scamp.html#scamp"><span class="std std-ref">scamp</span></a> or <a class="reference internal" href="../apps/scolv.html#scolv"><span class="std std-ref">scolv</span></a> for computing magnitudes, e.g., by <a class="reference internal" href="../apps/scmag.html#scmag"><span class="std std-ref">scmag</span></a> or
|
||||
<a class="reference internal" href="../apps/scolv.html#scolv"><span class="std std-ref">scolv</span></a>. The principles are outlined in the concepts section
|
||||
<a class="reference internal" href="concepts/magnitudes.html#concepts-magnitudes"><span class="std std-ref">Magnitudes</span></a>.</p>
|
||||
<a class="reference internal" href="concepts/magnitudes.html#concepts-magnitudes"><span class="std std-ref">Amplitudes and Magnitudes</span></a>.</p>
|
||||
<p>The time windows for measuring noise and signal amplitudes are given by their
|
||||
respective begin and end values. These window parameters are configured as
|
||||
global binding parameters specifically for a particular amplitude type, let’s
|
||||
@ -262,7 +210,7 @@ corresponds to the arrival of P waves for most applications. <em>triggerTime</em
|
||||
hence the sum of <em>originTime</em> and <em>relativeTriggerTime</em>.</p>
|
||||
<p>Example:</p>
|
||||
<div class="math">
|
||||
<p><img src="../_images/math/83409ac8b2479e6d7ceba99bfd8c19a5491e32ca.png" alt="absoluteSignalEnd =\ &originTime + relativeTriggerTime + amplitudes.ML.signalEnd \\
|
||||
<p><img src="../_images/math/83409ac8b2479e6d7ceba99bfd8c19a5491e32ca.svg" alt="absoluteSignalEnd =\ &originTime + relativeTriggerTime + amplitudes.ML.signalEnd \\
|
||||
=\ &originTime - relativeOriginTime + amplitudes.ML.signalEnd \\
|
||||
=\ &triggerTime + amplitudes.ML.signalEnd"/></p>
|
||||
</div><div class="admonition important">
|
||||
@ -373,7 +321,7 @@ value is returned. If both values are unset then the result is unset, too.</p>
|
||||
<dt class="sig sig-object py" id="tt">
|
||||
<span class="sig-name descname"><span class="pre">tt</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">phase</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tt" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Calculates the travel-time of the given phase <strong>w.r.t. relative origin
|
||||
time, :py:envvar:`OT`</strong>. The result is unset if the travel time cannot be
|
||||
time</strong>, <span class="target" id="index-7"></span><a class="reference internal" href="#envvar-OT"><code class="xref std std-envvar docutils literal notranslate"><span class="pre">OT</span></code></a>. The result is unset if the travel time cannot be
|
||||
computed. The travel times are computed based on the travel-time interface
|
||||
and model defined in <a class="reference internal" href="../apps/global.html#confval-0"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.ttt.interface</span></code></a> and
|
||||
<a class="reference internal" href="../apps/global.html#confval-1"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.ttt.model</span></code></a>, respectively.</p>
|
||||
@ -397,9 +345,9 @@ time</strong>. The arrivals with the given phase code must exist.</p>
|
||||
sensor location of the associated pick must match the sensor
|
||||
location of the target object.</p></li>
|
||||
<li><p><strong>acceptAll</strong> – Whether to accept all arrivals or only manually
|
||||
revised arrivals. The default is ‘true’ if not
|
||||
revised arrivals. The default is ‘false’ if not
|
||||
given. Allowed is either ‘true’ or ‘false’. If
|
||||
‘true’ is given, then either the evaluation mode
|
||||
‘false’ is given, then either the evaluation mode
|
||||
of the origin or the evaluation mode of the pick
|
||||
must be ‘manual’.</p></li>
|
||||
</ul>
|
||||
@ -518,13 +466,13 @@ trigger is the measured or the predicted arrival time of the P phase.</p>
|
||||
</div>
|
||||
<div>
|
||||
<h4>Previous topic</h4>
|
||||
<p class="topless"><a href="filter-grammar.html"
|
||||
title="previous chapter">Filter Grammar</a></p>
|
||||
<p class="topless"><a href="../apps/scm_ncurses.html"
|
||||
title="previous chapter">ncurses</a></p>
|
||||
</div>
|
||||
<div>
|
||||
<h4>Next topic</h4>
|
||||
<p class="topless"><a href="sdk.html"
|
||||
title="next chapter">Software Development Kit</a></p>
|
||||
<p class="topless"><a href="filter-grammar.html"
|
||||
title="next chapter">Filter Grammar</a></p>
|
||||
</div>
|
||||
<div role="note" aria-label="source link">
|
||||
<h3>This Page</h3>
|
||||
@ -545,7 +493,7 @@ trigger is the measured or the predicted arrival time of the P phase.</p>
|
||||
</a>
|
||||
<div class="stretched align-center fitted content">
|
||||
<div>
|
||||
Version <b>6.9.0</b> Release
|
||||
Version <b>7.0.0</b> Development
|
||||
</div>
|
||||
<div class="copyright">
|
||||
Copyright © gempa GmbH, GFZ Potsdam.
|
||||
|
||||
Reference in New Issue
Block a user