.. _molprop_examples_quietfilter:

Quiet Filtering
===============

Log output can be superfluous when using the :ref:`OEFilter <OEMolProp_OEFilter>`
object in a more complex program. Since all the log output is written to
the :oe:constns:`OESystem::OEThrow` object, the verbosity level can be lowered
by using the :oe:meth:`OEThrow.SetLevel<OESystem::OEErrorHandler::SetLevel>`
method.  This example demonstrates setting the :oe:constns:`OESystem::OEThrow`
error level to :oe:const:`OESystem::OEErrorLevel::Warning`. This will only allow
messages at the level of ``Warning`` or above to be emitted, thereby
silencing the :ref:`OEFilter <OEMolProp_OEFilter>` object's logging output. The
``-verbose`` option can be used to change the :oe:constns:`OESystem::OEThrow`
error level.

Command Line Interface
----------------------

A description of the command line interface can be obtained by
executing the program with the --help argument.

.. oe:language:: c++

   .. code-block:: console

      prompt> quietfilter --help

.. oe:language:: python

   .. code-block:: console

      prompt> python quietfilter.py --help

.. oe:language:: java

   .. code-block:: console

      prompt> java QuietFilter --help

.. oe:language:: csharp

   .. code-block:: console

      prompt> QuietFilter --help


will generate the following output:

.. code-block:: console

   Simple parameter list
    filter options :
      -filtertype : filter type

    input/output options :
      -in : Input filename
      -out : Output filename

    other options :
      -verbose : Error level of messages


Code
----------------------

.. oe:language:: python

   .. only:: oehtml

      .. admonition:: Download code

         :download:`quietfilter.py <../../../../wrappers/python/examples/molprop/quietfilter.py>`

      ..    literalinclude:: ../../../../wrappers/python/examples/molprop/quietfilter.py

   .. only:: oepdf

      .. oe:source:: quietfilter.py
         :language: python


.. oe:language:: c++

   .. only:: oehtml

      .. admonition:: Download code

         :download:`quietfilter.cpp <../../../../sublibs/tklibs/molprop/examples/quietfilter.cpp>`

   .. only:: oepdf

      .. oe:source:: quietfilter.cpp
         :language: c++

.. oe:language:: java

   .. only:: oehtml

      .. admonition:: Download code

         :download:`QuietFilter.java <../../../../wrappers/java/examples/openeye/examples/oemolprop/QuietFilter.java>`

   .. only:: oepdf

      .. oe:source:: QuietFilter.java
         :language: java

.. oe:language:: csharp

   .. only:: oehtml

      .. admonition:: Download code

         :download:`QuietFilter.cs <../../../../wrappers/csharp/Csharp-Examples/OEMolProp/QuietFilter.cs>`

   .. only:: oepdf

      .. oe:source:: QuietFilter.cs
         :language: csharp

.. seealso::

   * :oe:func:`OEMolProp::OEFilter` class
   * :oe:func:`OEMolProp::OEConfigureFilterParams` and :oe:func:`OEMolProp::OEConfigureFilterType` functions
   * :oe:func:`OEMolProp::OEGetFilterType` function
   * :ref:`OEErrorHandler <OESystem_OEErrorHandler>` class

Examples
----------------------

.. oe:language:: c++

   .. code-block:: console

      prompt> quietfilter -in mcss.smi.gz -out .smi -filtertype Lead

.. oe:language:: python

   .. code-block:: console

      prompt> python quietfilter.py -in mcss.smi.gz -out .smi -filtertype Lead

.. oe:language:: java

   .. code-block:: console

      prompt> java QuietFilter -in mcss.smi.gz -out .smi -filtertype Lead

.. oe:language:: csharp

   .. code-block:: console

      prompt> QuietFilter -in mcss.smi.gz -out .smi -filtertype Lead
