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

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

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

* New :oe:func:`OEGrapheme::OERenderBFactorMap` and
  :oe:func:`OEGrapheme::OEDrawBFactorMapLegend` functions have been added to visualize the
  B-factor of a ligand and its protein environment.

  .. only:: oehtml

      .. raw:: html

         <p align="center">
         <b>hover mouse over any residue circles</b>
         </p>

         <p align="center">
         <object data="../../_images/bfactor-map-1br6.svg" type="image/svg+xml"  width = "500" ></object>
         <p>

         <p align="center">
         <b>Example of depicting the B-factor map (PDB: 1br6)</b>
         <p>

      .. image:: ../../graphemetk/images/releasenotes-1.3.6/bfactor-map-1br6.svg
         :width: 1pt

   .. only:: oepdf

      |NOPDFIMAGE|

* A new :oe:func:`OEGrapheme::OEDrawUnpairedInteractionMapLegend` function has been added to depict the
  legend of the interactions depicted in an unpaired map.
  (See also the :oe:func:`OEGrapheme::OERenderUnpairedInteractionMap` function).

  .. only:: oehtml

      .. raw:: html

         <p align="center">
         <b>hover mouse over the Legend button</b>
         </p>

         <p align="center">
         <object data="../../_images/unpaired-map-1br6.svg" type="image/svg+xml"  width = "500" ></object>
         <p>

         <p align="center">
         <b>Example of depicting the unpaired interaction map with interactive legend (PDB: 1br6)</b>
         <p>

      .. image:: ../../graphemetk/images/releasenotes-1.3.6/unpaired-map-1br6.svg
         :width: 1pt

   .. only:: oepdf

      |NOPDFIMAGE|

* The :oe:meth:`OEGrapheme::OE2DActiveSiteDisplay::GetDisplayedResidues` function now takes
  a parameter from the new :oe:const:`OEGrapheme::OEActiveSiteRenderStyle`
  namespace.

* Two new methods, :oe:meth:`OEGrapheme::OEColorGradientDisplayOptions::GetColorStopVisibility` and
  :oe:meth:`OEGrapheme::OEColorGradientDisplayOptions::SetColorStopVisibility`, have been added to
  customize color gradient depiction.

New features (Preliminary API)
--------------------------------------------------------------------------------

* A new :oe:func:`OEGrapheme::OERenderActiveSiteMaps` function has been added that generates an
  interactive image of protein-ligand maps.

   .. only:: oehtml

      .. raw:: html

         <p align="center">
         <object data="../../_images/active-maps-1br6.svg" type="image/svg+xml"  width = "500" ></object>
         <p>

         <p align="center">
         <b>Example of visualizing protein-ligand maps (PDB: 1br6)</b>
         <p>

      .. image:: ../../graphemetk/images/releasenotes-1.3.6/active-maps-1br6.svg
         :width: 1pt

   .. only:: oepdf

      |NOPDFIMAGE|

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

* When rendering ligand-protein maps with **Grapheme TK**, molecule surfaces are generated
  to depict the overall shape of the pocket.  In the case of a large
  protein, this process can be both computationally expensive and can
  require a large amount of memory.  In order to avoid these issues,
  only protein atoms that are no more than 20Å away from any ligand
  atoms are now considered and the resolution of the surface is reduced.

* Rendering active site maps to an image with less than a ``200.0``
  width or height parameter is now disabled to avoid generating very tiny,
  incomprehensible images.

* When rendering ligand-protein maps (e.g., active site, unpaired),
  interactions between the ligand and more than 1 residue is now
  ignored and a warning is thrown.

* Scaling of legend labels for large images has been fixed.  All
  **Grapheme TK** legends of ligand-protein depictions now have a
  consistent style.

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

* A problem that occurred when coloring hexagon glyphs representing DNA/RNA
  residues with more than 1 interaction type has been fixed.

* An issue with depicting an interaction type in a legend when that
  interaction type is missing from the corresponding active site map
  has been fixed.

* A small improvement has been made to help to generate residue layouts that
  are platform-independent.

* A small improvement has been made to generate better residue layout:
  the space around the ligand for potential residue positions
  is now better sampled to allow positioning residues close to edge of
  the canvas.

* The text associated with the color stops when depicting color gradients vertically
  using the :oe:func:`OEGrapheme::OEDrawColorGradient` function is now right-adjusted.

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

* The :ref:`shapeoverlap2pdf.py <section_examples_summary_shapeoverlap2pdf>` example
  has been fixed.
