.. highlight:: rst

.. _inv2dlsv:

########
inv2dlsv
########

**Converts SC3 inventory XML to dataless SEED.**


Description
===========

inv2dlsv is a simple filter that converts inventory in |scname| XML (:term:`SCML`)
format from stdin (or a file) to dataless SEED on stdout (or a file). It does
not support processing of input XML such as extraction of networks or channels.
To accomplish this task, combine :program:`inv2dlsv` with :ref:`invextr`.

.. note::

   Conversion of dataless SEED to |scname| XML is provided by :ref:`dlsv2inv`.


Examples
========

.. note::

   "-" can always be used as filename to refer to the standard input/output channel.

#. Convert an inventory XML file to a dataless SEED file

   .. code-block:: sh

      inv2dlsv inv.xml inv.seed


#. Convert an inventory XML file to a compressed dataless SEED file

   .. code-block:: sh

      inv2dlsv inv.xml | gzip > inv.seed.gz


#. Convert a subset of an inventory XML using :ref:`invextr`.

   .. code-block:: sh

      invextr --chans "*MORC*" inv.xml | inv2dlsv - inv.seed



Command-Line Options
====================

.. program:: inv2dlsv

:program:`inv2dlsv [in_xml [out_dataless]]`

If in_xml is not given, stdin is used. If out_dataless is not given,
stdout is used.

