.. _szmap_tutorial_gameplan:
.. include:: ../substitutions
.. include:: ../../apps-substitutions

======================
Running Gameplan
======================

The application :ref:`chapter_gameplan` uses :ref:`chapter_szmap` to analyze ways
to modify ligand chemistry based on water structure and energetics in the immediate
environment of the ligand. By testing a limited number of coordinates based on
the structure of the ligand and the binding site, :ref:`chapter_gameplan` quickly
generates: a description of how compatible the ligand is with the binding site,
a series of hypotheses for ligand variants, and stabilizing or destabilizing waters.

Again, assuming the input protein and ligand structures have been prepared as described above,
a :ref:`chapter_gameplan` calculation can be performed as follows:
::

   > gameplan -szmap_mpi_np 4 -prefix 4std_gameplan -p 4STD_ABC__DU__BFS_A-173.oedu

   or

   > gameplan -szmap_mpi_np 4 -prefix 4std_gameplan -p 4STD_A__DU__BFS_A-173_target.oeb.gz -l 4STD_A__DU__BFS_A-173_ligand.oeb.gz

The protein and ligand in the OEDesignUnit are analyzed and the most informative
sample points are identified. :ref:`chapter_szmap` is then run on those points,
and the results are transformed into a set of potential ligand modifications.
All of this takes about 4 minutes on four 2.8GHz processors and
the output is placed in the file "4std_gameplan.oeb.gz", which can be analyzed in *VIDA*
using the :ref:`chapter_watercolor`. The file "4std_gameplan.log" documents the results,
including the energy values for each attachment hypothesis.

The command line option ``-szmap_mpi_np #`` controls how :ref:`chapter_gameplan`
runs :ref:`chapter_szmap` to compute the results. More information on
options can be found in chapter :ref:`chapter_gameplan`.

Analyzing Gameplan Results
-------------------------------

Results from :ref:`chapter_gameplan` contain ideas for ligand modifications and points where water is
stabilizing or destabilizing the protein/ligand complex.

::

   > vida 4std_gameplan.oeb.gz

.. _figure_gameplan_4std_polar_attachment:

.. figure:: ../images/4std_polar_attachment.png
   :width: 1000
   :align:  center

   **Gameplan Hypothesis for a Polar Attachment**

In :ref:`Gameplan Hypothesis for a Polar Attachment<figure_gameplan_4std_polar_attachment>`,
the :ref:`chapter_watercolor` has been used to configure the display of
the :ref:`chapter_gameplan` results by highlighting any part of the gameplan results in the list window
and running :ref:`chapter_watercolor`. Using the up-arrow and down-arrow keys,
you can browse through the different components of the results in the list window. Shown
in pink is a suggestion for a site where a hydrogen-bond acceptor might interact favorably
with nearby tyrosine residues. The yellow ball indicates that water makes a strong polar interaction
at this site in the *apo*-protein. For a complete description,
see chapter :ref:`chapter_gameplan`.
