liveBook · Manning

Protonation

As explained in Build AI Drug Discovery Pipelines

Protonation is the addition of a proton to a molecule or ionizable chemical group.

Protonation adds a proton to a molecule or ionizable chemical group, changing properties such as acidity, basicity, charge, and possible molecular structure. In drug discovery, the relevant protonation state depends on the surrounding pH and can affect ligand preparation, descriptors, and docking results. section 6.1.2 section 9.1.3

Protonation belongs to a ligand’s protomer search space. Protomers differ through protonation or tautomerization; these processes can influence one another as molecules rearrange bonds to stabilize added charge. section 6.1.2

A practical protonation workflow includes:

  • Set the pH range to match the experimental assay or biological environment, because pH changes the balance between protonated and deprotonated forms. section 6.1.2
  • Generate protonated ligand variants, remove duplicates, and enumerate associated tautomers before downstream modeling. section 6.1.2
  • Assign protonation for ionizable residues and ligands during receptor and ligand preparation, alongside charges, stereochemistry, waters, cofactors, and geometry checks. section 9.1.3

Generating protomers for binding data

A small-molecule binding dataset containing 48 ligands can be expanded to roughly 1,500 protomers by using Dimorphite-DL across pH 6.4–8.4, followed by RDKit tautomer enumeration. Narrow that range when assay conditions differ. section 6.1.2

Listing 6.1 Load Data and Generate Protomers
hiv_tar1 = pd.read_csv(    #A
    "data/CH06_hargrove_data.csv",    #A
    usecols=[    #A
        "Name", "SMILES", "kon", "koff", "KD", "lnkon", "lnkoff", "lnKD"
    ]    #A
)    #A
 
# Narrow this range to match your own assay conditions before modeling.
dimorphite_dl = DimorphiteDL(    #B
    min_ph=6.4,    #B
    max_ph=8.4,    #B
    max_variants=128,    #B
    label_states=False,    #B
)    #B
 
tautomer_enumerator = rdMolStandardize.TautomerEnumerator()
 
def enumerate_protomers(smi):    #C
    if Chem.MolFromSmiles(smi) is None:
        print(f"WARNING: unparseable input SMILES, skipping: {smi}")
        return []
    seen, protomers = set(), []
    for prot_smi in dimorphite_dl.protonate(smi):
        prot = Chem.MolFromSmiles(prot_smi)
        if prot is None:
            continue
        for taut in tautomer_enumerator.Enumerate(prot):    #C
            if taut is None:
                continue
            canonical = Chem.MolToSmiles(taut)    #D
            if canonical and canonical not in seen:    #E
                seen.add(canonical)    #E
                protomers.append(taut)    #E
    return protomers
 
mols = []
ligand2protomers = {}
for ligand_idx, smi in enumerate(hiv_tar1["SMILES"].tolist()):
    mols.append(Chem.MolFromSmiles(smi))
    try:
        ligand2protomers[ligand_idx] = enumerate_protomers(smi)
    except Exception as err:
        print(f"WARNING: enumeration failed for {smi}: {err}")
        ligand2protomers[ligand_idx] = []

Inspect the runnable pattern for loading binding data, configuring Dimorphite-DL, validating SMILES, generating protonated variants, and enumerating tautomers. section 6.1.2

How Build AI Drug Discovery Pipelines covers it

How deep it goes
Explains chemical effects and implements pH-conditioned protomer generation, while deferring broader structure-preparation details to a checklist.
Examples
Demonstrates Dimorphite-DL generation across pH 6.4–8.4 and expansion of 48 ligands to roughly 1,500 protomers.
What it assumes
Teaches protonation and tautomerization terminology before applying them to molecules, datasets, and docking preparation.
What you can do after
Operate RDKit and Dimorphite-DL workflows to generate pH-relevant ligand protomers for downstream modeling.
How it connects
Connects protonation with pH, protomers, tautomerization, ligand preparation, molecular descriptors, and docking.

This explainer was generated by Manning's knowledge graph from the text of Build AI Drug Discovery Pipelines. The section links point to the parts of the book it draws on.