Each OEAtomBase keeps track of two types of charges:
|Property Name||Type||Get Method||Set Method|
Neither the formal charge nor the partial charge is a directly observable property of an atom. Instead the same molecule may be represented by different valence representations, each placing the formal charges in different locations, i.e. different partial charging algorithms may assign significantly different partial charges to the same atom (for example benzene can be represented as [cH+]1[cH-][cH+][cH-][cH+][cH-]1)
Normally, file formats such as SMILES, SLN or MDL’s SDF format, specify the formal charges on each atom of a connection table. However, when reading from other file formats or when repairing ‘broken’ molecules, it may be convenient to assign formal charges to each atom such that the atomic valence is consistent. OEChem TK provides this functionality via the OEAssignFormalCharges function. This function requires that bond orders and implicit hydrogen counts have been set on a molecule. It then adjusts the formal charge on each uncharged atom to correct common valence model mismatches. For example, quaternary nitrogens are assigned a +1 formal charge, and terminal oxygen connected only by a single bond (with no implicit hydrogens) is assigned a -1 formal charge.
A more technical discussion of the formal charges that are assigned by this function are described in the OpenEye Charge Model section.
To assign Marsilli-Gasteiger partial charges to a molecule, OEChem TK provides the OEGasteigerPartialCharges function. This sets the partial charge property of each atom, using the SetPartialCharge method. The algorithm itself reproduces the partial charges as calculated by Tripos Inc’s Sybyl software, with default parameter settings, which is the de facto reference implementation for Gasteiger charges.
The Gasteiger partial charge algorithm currently assumes that all hydrogen atoms are represented explicitly, for example by calling OEAddExplicitHydrogens.
The current version of OEGasteigerPartialCharges should return the same results independent of the currently assigned aromaticity models and the values of each atom’s “integer atom type” property. Early versions of OEChem TK allowed customization of the Gasteiger charge calculation by explicitly assigning the Tripos atoms types of each atom of the molecule. Unfortunately, this required assigning Tripos’ aromaticity and assigning Tripos atom types before each call to OEGasteigerPartialCharges. The more recent behavior is less error-prone (as it’s no longer possible to forget to prepare a molecule) and greatly simplifies common usage.
The first stage of the Marsilli-Gasteiger “Partial Equalization of Orbital Electronegativities” (PEOE)” calculation [Gasteiger-1980] is assignment of seed charges to each atoms. Typically for neutral atoms the partial charge seed is zero, but for example, each oxygen in a carboxylate is assigned -0.5, and the net formal charge on conjugated rings is shared equally amongst the atoms of the ring system. These seed charges may also be useful in some applications, and can be assigned using the OEGasteigerInitialCharges method.