Depicting Polar Hydrogens

Problem

You want to depict your molecule with explicit polar hydrogens. See example in Figure 1.

../_images/DepictPolarHydrogens.png

Figure 1. Example of depicting polar hydrogens

Ingredients

Difficulty Level

../_images/chilly.png

Solution

Before rendering a molecule, the OEPrepareDepiction function should be called which prepares the molecule for depiction. This function perceives atom and bond stereo information and suppresses or adds hydrogens if necessary. By default, the explicit hydrogens are suppressed by the OEPrepareDepiction function, see example (A) in Table: Example of default molecule depiction. Only hydrogens that are necessary to faithfully represent tetrahedral stereochemistry are added, see example (B) in Table 1.

Table 1. Example of default molecule depiction

( A )

( B )
../_images/DepictDefault.png ../_images/DepictDefault-StereoH.png

If the molecule has only implicit hydrogens then you can add the polar hydrogens by calling the OEAddExplicitHydrogens function with the polarOnly = True parameter (lines 3-4), before preparing the molecule for depiction. It is important to call the OEPrepareDepiction function with clearcoords = True and suppressH = False parameters (lines 6-8).

 1def DepictMoleculeWithPolarHydrogens(mol, opts, filename):
 2
 3    polarOnly = True
 4    oechem.OEAddExplicitHydrogens(mol, polarOnly)
 5
 6    clearcoords = True
 7    suppressH = False
 8    oedepict.OEPrepareDepiction(mol, clearcoords, suppressH)
 9
10    disp = oedepict.OE2DMolDisplay(mol, opts)
11    oedepict.OERenderMolecule(filename, disp)

Discussion

If the molecule already has explicit hydrogens then you can suppress all non polar hydrogens by calling the OESuppressHydrogens function with retainPolar = True parameter (lines 3-4), prior to preparing the molecule for depiction.

 1def DepictMoleculeOnlyPolarHydrogens(mol, opts, filename):
 2
 3    retainPolar = True
 4    oechem.OESuppressHydrogens(mol, retainPolar)
 5
 6    clearcoords = True
 7    suppressH = False
 8    oedepict.OEPrepareDepiction(mol, clearcoords, suppressH)
 9
10    disp = oedepict.OE2DMolDisplay(mol, opts)
11    oedepict.OERenderMolecule(filename, disp)

See also in OEChem TK manual

API

See also in OEDepict TK manual

Theory

API