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
