.. include:: ../../toolkit-substitutions

Grapheme\ :sup:`TM` TK 1.3.3
================================================================================

New features
--------------------------------------------------------------------------------

* A new function, :oe:func:`OEGrapheme::OERenderContactMap`, has been added
  that generates interactive SVG images. Clicking on any residue circle will
  highlight those ligand atoms that interact with the given residue.

.. only:: oehtml

   .. raw:: html

      <p align="center">
      <b>click on any residue</b>
      </p>

      <p align="center">
      <object data="../../_images/RenderContactMap-4HWR.svg" type="image/svg+xml"  width = "500" ></object>
      <p>

      <p align="center">
      <b>Example of interactive SVG image generated by OERenderContactMap (PDB: 4HWR)</b>
      <p>

   .. image:: ../../graphemetk/images/releasenotes-1.3.3/RenderContactMap-4HWR.svg
      :width: 1pt

   .. only:: oepdf

      |NOPDFIMAGE|

Preliminary API
--------------------------------------------------------------------------------

* A new :term:`Preliminary API` has been added to mark up the
  residue circles in SVG images generated by the
  :oe:func:`OEGrapheme::OERenderActiveSite` function:

  * :oe:meth:`OEGrapheme::OE2DActiveSiteDisplayOptions::SetResidueSVGMarkupFunctor` and
    :oe:meth:`OEGrapheme::OE2DActiveSiteDisplayOptions::GetResidueSVGMarkupFunctor` methods

  * :ref:`OEResidueSVGMarkupBase <OEGrapheme_OEResidueSVGMarkupBase>` base class and
    :ref:`OEResidueSVGNoMarkup <OEGrapheme_OEResidueSVGNoMarkup>` and
    :ref:`OEResidueSVGStandardMarkup <OEGrapheme_OEResidueSVGStandardMarkup>` concrete classes

Major bug fixes
--------------------------------------------------------------------------------

* Several problems in the :oe:func:`OEGrapheme::OERenderActiveSite` function
  have been fixed:

  * When depicting protein-ligand interactions, grey lines represent the shape
    of the binding pocket.  The absence of lines indicates solvent-accessible
    regions.  In order visualize the solvent-accessible areas more
    realistically, waters are now ignored when calculating the molecule
    surfaces that determine the 2D representation (compare images below).

  * The rare case where the ligand is completely surrounded by water is
    now handled correctly.

  * The following heuristics are now used to improve the positioning of
    residue glyphs around the ligand:

    * Waters are more likely to be positioned in solvent-exposed regions.
    * Other residues are only positioned in solvent-exposed regions if it
      results in a more visually pleasing layout.

  .. list-table:: **Example of visualizing solvent-accessible regions and water positioning (PDB: 3E3D)**
     :header-rows: 1
     :widths: 200 200

     * - 2017.Feb
       - 2017.Jun

     * - .. image:: ../../graphemetk/images/releasenotes-1.3.3/pocket-2017-Feb.*
            :width: 300
       - .. image:: ../../graphemetk/images/releasenotes-1.3.3/pocket-2017-Jun.*
            :width: 300

Minor bug fixes
--------------------------------------------------------------------------------

* :oe:func:`OEGrapheme::OEDrawPeptide` has been fixed and now allows
  only amide and disulfide bonds when identifying standard amino
  acids. No alpha-carbon substitutions are allowed.

  .. list-table:: **Example of visualizing peptides with OEDrawPeptide**
     :header-rows: 1
     :widths: 220 250

     * - 2017.Feb
       - 2017.Jun

     * - .. image:: ../../graphemetk/images/releasenotes-1.3.3/ceruletide-2017-Feb.*
       - .. image:: ../../graphemetk/images/releasenotes-1.3.3/ceruletide-2017-Jun.*

Documentation changes
--------------------------------------------------------------------------------

* A new :ref:`oegrapheme_chapter_cookbook_examples` section has been added.
