Receptor and Ligand Preparation

Receptor and ligand preparation converts raw structures and molecules into model-ready inputs for docking, scoring, pose evaluation, or property prediction. Preparation choices can dominate results, so they should be treated as part of the method.

A preparation pipeline can be written as:

where includes cleaning, standardization, protonation, conformer handling, and binding-site definition.

Preparation is not neutral:

Changing can change the model input, docking pose, score, and failure rate even when the model weights stay fixed.

Receptor Preparation

  • Choose chain, biological assembly, and relevant structure.
  • Handle missing residues, alternate conformations, waters, ions, metals, cofactors, and ligands.
  • Assign protonation or charge states when needed.
  • Define the pocket, docking box, or local context.
  • Decide whether the receptor is rigid, flexible, or ensemble-based.
DecisionCommon optionsRisk
chain/assemblyasymmetric unit, biological assembly, selected chainwrong interface or missing binding context
watersremove all, keep structural waters, model explicitlywater-mediated contacts disappear
cofactors/metalsremove, keep, parameterizeactive-site chemistry changes
missing residuesignore, model, croppocket geometry becomes inconsistent
apo/holo structureapo, holo, predictedconformation may leak ligand information or miss induced fit

Ligand Preparation

  • Define molecular identity before deduplication and split assignment.
  • Standardize salt, charge, aromaticity, tautomer, and stereochemistry policy.
  • Enumerate or choose protonation and tautomer states when relevant.
  • Generate conformers if the workflow requires 3D inputs.
  • Preserve identifiers without using them as model features.
  • Track input hash and featurizer/preparation version.

Ligand state enumeration can be represented as:

where each state may differ by tautomer, protonation, stereochemistry, salt handling, or conformer. A benchmark should state whether it evaluates the best enumerated state, a selected canonical state, or all states.

Failure Accounting

Failed preparation is part of the result:

If failures are silently removed, the reported metric may only describe easy molecules or clean receptors. This is especially risky when failures correlate with charge, size, metal coordination, flexible ligands, or low-quality structures.

Reproducibility Contract

FieldWhy it matters
input structure ID and chain policydefines the receptor object
preparation software and versionchanges charges, hydrogens, atom typing
pH/protonation assumptionschanges interaction geometry
tautomer/stereo policychanges ligand identity
conformer generation settingschanges search starting points
pocket or box definitionchanges docking search space
failure handlingdefines denominator of metrics

Checks

  • Are receptor and ligand preparation versions recorded?
  • Is pocket definition independent from test-set information?
  • Are stereochemistry and protonation rules consistent across splits?
  • Are failed preparations counted and reported?
  • Are preparation failures correlated with target labels or molecular classes?
  • Are waters, metals, cofactors, and alternate conformations handled by a stated rule?
  • Is a ligand-defined pocket allowed by the deployment scenario?
  • Are raw and prepared molecule identifiers traceable without exposing private paths?