.. _section_example_oechem_sdfmodprops:

Modifying SD tags
================================================================================

A program that can modify the SD tags on an SD molecule. The flags
are: ``-remove``, a list of property tags to be removed (non-matching
tags are kept), ``-keep```, a list of property tags to be kept
(non-matching tags are removed), ``-clearAll``, all SD tags are
removed. The program formats are limited to those that can have SD
data ``i.e.`` SDF, OEB, and CSV.

Example
--------------------------------------------------------------------------------

.. oe:language:: c++

   .. code-block:: console

      prompt > sdfmodprops -keep NAME ID_NUM -i dbase.sdf -o output.sdf
      prompt > sdfmodprops -clearAll -i dbase.sdf -o output.oeb.gz

.. oe:language:: python

   .. code-block:: console

      prompt > sdfmodprops.py -keep NAME ID_NUM -i dbase.sdf -o output.sdf
      prompt > sdfmodprops.py -clearAll -i dbase.sdf -o output.oeb.gz

.. oe:language:: java

   .. code-block:: console

      prompt > SDFModProps -keep NAME ID_NUM -i dbase.sdf -o output.sdf
      prompt > SDFModProps -clearAll -i dbase.sdf -o output.oeb.gz

.. oe:language:: csharp

   .. code-block:: console

      prompt > SDFModProps -keep NAME ID_NUM -i dbase.sdf -o output.sdf
      prompt > SDFModProps -clearAll -i dbase.sdf -o output.oeb.gz

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

.. oe:language:: c++

   .. only:: oehtml

      .. admonition:: Download code

         :download:`sdfmodprops.cpp <../../../../../sublibs/tklibs/oechem/examples/sdfmodprops.cpp>`

   .. only:: oepdf

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

.. oe:language:: python

   .. only:: oehtml

      .. admonition:: Download code

         :download:`sdfmodprops.py <../../../../../wrappers/python/examples/oechem/sdfmodprops.py>`

      .. literalinclude:: ../../../../../wrappers/python/examples/oechem/sdfmodprops.py


   .. only:: oepdf

      .. oe:source:: sdfmodprops.py
         :language: python

.. oe:language:: java

   .. only:: oehtml

      .. admonition:: Download code

         :download:`SDFModProps.java <../../../../../wrappers/java/examples/openeye/examples/oechem/SDFModProps.java>`

   .. only:: oepdf

      .. oe:source:: SDFModProps.java
         :language: java

.. oe:language:: csharp

   .. only:: oehtml

      .. admonition:: Download code

         :download:`SDFModProps.cs <../../../../../wrappers/csharp/Csharp-Examples/OEChem/SDFModProps.cs>`

   .. only:: oepdf

      .. oe:source:: SDFModProps.cs
         :language: csharp

.. seealso::

   * :oe:func:`OEChem::OEDeleteSDData` function
   * :oe:func:`OEChem::OEClearSDData` function
