.. _section_example_oechem_randomsample:

Extract random molecule subset
================================================================================

A program that extracts a randomized subset of molecules from a
molecule file. The program has two flags, ``-p``, extract a percentage
of the database, or ``-n``, extract a specific number from the
database. If neither flag is set then the whole database will be
randomized.

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

.. oe:language:: c++

   .. code-block:: console

      prompt> randomsample -n 1000 dbase.oeb.gz output.oeb.gz
      prompt> randomsample -p 10 -i dbase.oeb.gz -o output.oeb.gz

.. oe:language:: python

   .. code-block:: console

      prompt> randomsample.py -n 1000 dbase.oeb.gz output.oeb.gz
      prompt> randomsample.py -p 10 -i dbase.oeb.gz -o output.oeb.gz

.. oe:language:: java

   .. code-block:: console

      prompt> RandomSample -n 1000 dbase.oeb.gz output.oeb.gz
      prompt> RandomSample -p 10 -i dbase.oeb.gz -o output.oeb.gz

.. oe:language:: csharp

   .. code-block:: console

      prompt> RandomSample -n 1000 dbase.oeb.gz output.oeb.gz
      prompt> RandomSample -p 10 -i dbase.oeb.gz -o output.oeb.gz

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

.. oe:language:: c++

   .. only:: oehtml

      .. admonition:: Download code

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

   .. only:: oepdf

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

.. oe:language:: python

   .. only:: oehtml


      .. admonition:: Download code

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

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


   .. only:: oepdf

      .. oe:source:: randomsample.py
         :language: python

.. oe:language:: java

   .. only:: oehtml

      .. admonition:: Download code

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

   .. only:: oepdf

      .. oe:source:: RandomSample.java
         :language: java

.. oe:language:: csharp

   .. only:: oehtml

      .. admonition:: Download code

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

   .. only:: oepdf

      .. oe:source:: RandomSample.cs
         :language: csharp

.. seealso::

   * :oe:meth:`OEChem::OEMolBase::Compress` method
   * :oe:meth:`OEChem::OEMolBase::UnCompress` method
   * `Manipulating Large Molecule Files <https://docs.eyesopen.com/toolkits/cookbook/python/cheminfo/moldb.html>`_ recipe in Python cookbook.
