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.
213 lines
4.3 KiB
ReStructuredText
213 lines
4.3 KiB
ReStructuredText
.. highlight:: rst
|
|
|
|
.. _dlsv2inv:
|
|
|
|
########
|
|
dlsv2inv
|
|
########
|
|
|
|
**Convert dataless SEED to SeisComP inventory XML.**
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
dlsv2inv converts dataless `SEED <http://www.iris.edu/data/dataless.htm>`_ to
|
|
SeisComP XML (:term:`SCML`). Due to the limitations of dataless SEED dlsv2inv allows to set
|
|
attributes which are not available in dataless such as network type, network
|
|
description and so on.
|
|
|
|
It takes basically two important parameters:
|
|
|
|
#. input file
|
|
#. output file
|
|
|
|
whereas the output file defaults to stdout if not given.
|
|
|
|
The SeisComP inventory network and station objects have the attribute archive
|
|
which should contain the local datacenter where the information comes from.
|
|
|
|
While importing the attribute :confval:`datacenterID` is read and written into
|
|
the archive attribute of all networks and stations available in the dataless.
|
|
The datacenterID can be overridden with the ``--dcid`` command-line option.
|
|
|
|
.. note::
|
|
|
|
Conversion of inventory in |scname| XML to dataless SEED is provided by :ref:`inv2dlsv`.
|
|
|
|
|
|
Examples
|
|
========
|
|
|
|
#. Convert a given dataless SEED file to SeisComP XML.
|
|
|
|
.. code-block:: sh
|
|
|
|
dlsv2inv GE.dataless GE.xml
|
|
|
|
#. Override the datacenterID and leave it blank in the output.
|
|
|
|
.. code-block:: sh
|
|
|
|
dlsv2inv --dcid "" GE.dataless GE.xml
|
|
|
|
|
|
.. _dlsv2inv_configuration:
|
|
|
|
Module Configuration
|
|
====================
|
|
|
|
| :file:`etc/defaults/global.cfg`
|
|
| :file:`etc/defaults/dlsv2inv.cfg`
|
|
| :file:`etc/global.cfg`
|
|
| :file:`etc/dlsv2inv.cfg`
|
|
| :file:`~/.seiscomp/global.cfg`
|
|
| :file:`~/.seiscomp/dlsv2inv.cfg`
|
|
|
|
dlsv2inv inherits :ref:`global options<global-configuration>`.
|
|
|
|
|
|
|
|
|
|
Command-Line Options
|
|
====================
|
|
|
|
.. program:: dlsv2inv
|
|
|
|
:program:`dlsv2inv [OPTIONS] input [output=stdout]`
|
|
|
|
|
|
Generic
|
|
-------
|
|
|
|
.. option:: -h, --help
|
|
|
|
Show help message.
|
|
|
|
.. option:: -V, --version
|
|
|
|
Show version information.
|
|
|
|
.. option:: --config-file arg
|
|
|
|
Use alternative configuration file. When this option is
|
|
used the loading of all stages is disabled. Only the
|
|
given configuration file is parsed and used. To use
|
|
another name for the configuration create a symbolic
|
|
link of the application or copy it. Example:
|
|
scautopick \-> scautopick2.
|
|
|
|
.. option:: --plugins arg
|
|
|
|
Load given plugins.
|
|
|
|
.. option:: -D, --daemon
|
|
|
|
Run as daemon. This means the application will fork itself
|
|
and doesn't need to be started with \&.
|
|
|
|
|
|
Verbosity
|
|
---------
|
|
|
|
.. option:: --verbosity arg
|
|
|
|
Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info,
|
|
4:debug.
|
|
|
|
.. option:: -v, --v
|
|
|
|
Increase verbosity level \(may be repeated, eg. \-vv\).
|
|
|
|
.. option:: -q, --quiet
|
|
|
|
Quiet mode: no logging output.
|
|
|
|
.. option:: --component arg
|
|
|
|
Limit the logging to a certain component. This option can
|
|
be given more than once.
|
|
|
|
.. option:: -s, --syslog
|
|
|
|
Use syslog logging backend. The output usually goes to
|
|
\/var\/lib\/messages.
|
|
|
|
.. option:: -l, --lockfile arg
|
|
|
|
Path to lock file.
|
|
|
|
.. option:: --console arg
|
|
|
|
Send log output to stdout.
|
|
|
|
.. option:: --debug
|
|
|
|
Execute in debug mode.
|
|
Equivalent to \-\-verbosity\=4 \-\-console\=1 .
|
|
|
|
.. option:: --log-file arg
|
|
|
|
Use alternative log file.
|
|
|
|
.. option:: --print-component arg
|
|
|
|
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.
|
|
|
|
.. option:: --trace
|
|
|
|
Execute in trace mode.
|
|
Equivalent to \-\-verbosity\=4 \-\-console\=1 \-\-print\-component\=1
|
|
\-\-print\-context\=1 .
|
|
|
|
|
|
ArcLink
|
|
-------
|
|
|
|
.. option:: --dcid arg
|
|
|
|
Override the datacenter ID which is read from the
|
|
datacenterID configuration parameter and written to the
|
|
network and station archive attribute.
|
|
|
|
.. option:: --net-description arg
|
|
|
|
Set the network description. It supports the following
|
|
placeholders: \${code}, \${start}, \${end}, \${class} and
|
|
\${archive}.
|
|
|
|
.. option:: --net-start arg
|
|
|
|
Set network start time. Format is %Y\-%m\-%d.
|
|
|
|
.. option:: --net-end arg
|
|
|
|
Set network end time. Format is %Y\-%m\-%d.
|
|
|
|
.. option:: --net-type arg
|
|
|
|
Set the network type \(VBB, SM, etc.\).
|
|
|
|
.. option:: --temporary
|
|
|
|
Set the network temporary flag to true.
|
|
|
|
.. option:: --restricted
|
|
|
|
Set the network restricted flag to true.
|
|
|
|
.. option:: --private
|
|
|
|
Set the network private flag to true.
|
|
|
|
|
|
Convert
|
|
-------
|
|
|
|
.. option:: -f, --formatted
|
|
|
|
Enable formatted XML output.
|
|
|