[installation] Change to nightly

share/doc/seiscomp/html/_sources/apps/scevtstreams.rst.txt

@@ -6,21 +6,26 @@
 scevtstreams
 ############
 
-**Extract stream information with time windows from picks of an event.**
+**Extract stream information and time windows from picks of an event or
+solitary picks.**
 
 
 Description
 ===========
 
-scevtstreams reads all picks of an event and determines the time window between
-the first pick and the last pick. In addition a symmetric or an asymmetric time
-margin is added to this
-time window. It writes the streams that are picked including the determined
+scevtstreams reads all picks of an event or solitary picks determining the time
+window between the first pick and the last pick.
+In addition symmetric asymmetric time margins are added to this time window.
+It writes the streams that are picked including the determined
 time window for the event to stdout. This tool gives appropriate input
 information for :ref:`scart`, :ref:`fdsnws` and :cite:t:`capstool` for
 :cite:t:`caps` server (Common Acquisition Protocol Server by gempa GmbH) to dump
 waveforms from archives based on event data.
 
+Events with origins and picks can be read from database or XML file. Solitary
+picks can only be read from XML file. The XML files can be generated using
+:ref:`scxmldump`.
+
 
 Output Format
 =============
@@ -49,30 +54,43 @@ Examples
 
       scevtstreams -E gfz2012abcd -d mysql://sysop:sysop@localhost/seiscomp
 
-#. Get the asymmetric time windows for an event in an XML file. The time window
-   starts 120 s before the first pick and ends 500 s after the last pick:
+#. Get the time windows for one specific event or all events in a XML file.
+   The time windows start 120 s before the first pick and ends 500 s after the
+   last pick:
 
    .. code-block:: sh
 
-      scevtstreams -E gfz2012abcd -i event.xml -m 120,500
+      scevtstreams -i event.xml -E gfz2012abcd
+      scevtstreams -i event.xml
 
-#. Create a playback of an event with a time window of 5 minutes data and
-   sort the records by end time:
+#. Get the time windows from all picks in a XML file which does not contain
+   events or origins:
+
+   .. code-block:: sh
+
+      scevtstreams -i picks.xml
+
+#. Combine with :ref:`scart` for creating a :term:`miniSEED` data file from one
+   event. The time window starts and ends 5 minutes before the first and after
+   the last pick, respectively.
+   The data is read from :term:`SDS` archive and sorted by end time:
 
    .. code-block:: sh
 
       scevtstreams -E gfz2012abcd -d mysql://sysop:sysop@localhost/seiscomp -m 300 |\
       scart -dsvE --list - ~/seiscomp/acquisition/archive > gfz2012abcd-sorted.mseed
 
-#. Download waveforms from Arclink and import into local archive. Include
+#. Download waveforms from FDSN and import into local archive. Include
    all stations from the contributing networks:
 
    .. code-block:: sh
 
       scevtstreams -E gfz2012abcd -d mysql://sysop:sysop@localhost/seiscomp -m 300 -R --all-stations |\
-      scart --list - ./my-archive
+      scart --list - -I fdsnws://geofon.gfz.de ./my-archive
 
-#. Create lists compatible with :ref:`fdsnws` or `caps <https://docs.gempa.de/caps/current/apps/capstool.html>`_: ::
+#. Create lists compatible with :ref:`fdsnws` POST format or :cite:t:`capstool`:
+
+   .. code-block:: sh
 
       scevtstreams -E gfz2012abcd -i event.xml -m 120,500 --fdsnws
       scevtstreams -E gfz2012abcd -i event.xml -m 120,500 --caps
@@ -230,8 +248,8 @@ Input
 
 .. option:: -i, --input arg
 
-   Input XML file name. Reads event from the XML file instead of
-   database. Use '\-' to read from stdin.
+   Input XML file name. Reads event and picks from the XML file
+   instead of database. Use '\-' to read from stdin.
 
 .. option:: -f, --format arg
 
@@ -249,7 +267,7 @@ Dump
 .. option:: --net-sta arg
 
    Filter read picks by network code or network and station
-   code. Format: NET or NET.STA
+   code. Format: NET or NET.STA .
 
 .. option:: --nslc arg