.. _filter_overview:
.. include:: ../substitutions
.. include:: ../../apps-substitutions

.. program:: filter

======================
Overview
======================

Filtering based on graph and physical properties should
always be carried out prior to generating multiconformer databases
using **OMEGA**.  Eliminating undesirable compounds prior to generating
conformers saves execution time of both **OMEGA** and downstream
applications, as well as storage space.  Large polypeptides or proteins, very
flexible molecules, or molecules that would never be considered
useful for the ultimate modeling application are best eliminated from
a dataset as soon as possible.

The most important graph filter to apply is rotatable bond count.
Although **OMEGA** may be able to generate conformers for molecules with
more than 20 rotatable bonds, the results of such an exercise would be
dubious at best for any conformer generation method. The number of rings,
especially flexible rings, should also be used to exclude irrelevant
molecules. **OMEGA** will handle molecules that have many thousands of
possible ring combinations, although the time expenditure may be
prohibitive and the results equally questionable to molecules with an
unreasonably large number of rotatable bonds.  Simple element filters
may be useful as well, although **OMEGA** will discard compounds for which
no force field parameters exist.  Using element filters beforehand may
aid in tracking the rationale for discarding compounds instead
of searching through **OMEGA** log files for failure modes.

The **FILTER** program from OpenEye, Cadence Molecular Sciences provides
all of the functionality outlined above, and additional physical
property filters.  **FILTER** should be used for input file preparation of
large datasets.
