.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OEScrambleMolecule

.. oe:function:: OEScrambleMolecule

   .. oe:language:: c++ java csharp

      .. oe:api::

         bool OEScrambleMolecule(OEMolBase &)

   .. oe:language:: python

      .. oe:api:: python

         OEScrambleMolecule(arg1: Union[OEGraphMol,OEMol,OEQMol]) -> bool

   Randomly reorders the atoms and bonds of a molecule.  Like
   :oe:meth:`OEChem::OEMolBase::OrderAtoms` and
   :oe:meth:`OEChem::OEMolBase::OrderBonds`, this function modifies the
   order in which atoms and bonds are visited by the iterator returned by
   :oe:meth:`OEChem::OEMolBase::GetAtoms` and
   :oe:meth:`OEChem::OEMolBase::GetBonds` respectively.  This function
   does not affect the atom or bond indices of any of the atoms or bonds
   of the molecule.

.. seealso::

  .. oe:language:: c++

      * Example program :ref:`randomizeatoms.cpp<section_example_oechem_randomizeatoms>`

  .. oe:language:: python

      * Example program :ref:`randomizeatoms.py<section_example_oechem_randomizeatoms>`

  .. oe:language:: java

      * Example program :ref:`RandomizeAtoms.java<section_example_oechem_randomizeatoms>`

  .. oe:language:: csharp

      * Example program :ref:`RandomizeAtoms.cs<section_example_oechem_randomizeatoms>`

