Molecular Docking in the AI Era

Companion code for Molecular Docking in the AI Era: A Hands-On Handbook for Structure-Based Drug Discovery, by Suryaprakash Tripathy.

Twenty-five chapters ship code, one folder each, in one repository. Clone it once and you have everything in the book. Each chapter stands alone: open its folder, run run.sh, and the numbers printed in that chapter come out.

Start here. Setup, the pinned environment, and the structures the book uses: dock.nexagenlabs.com/setup

Every number in the book is asserted by a test

The book prints measured values rather than illustrative ones. Those values live in the repository as expected results, and the test suite asserts them, so a divergence between page and code shows up as a failing build rather than as a reader's afternoon.

Two hundred and fifty-six tests run from a fresh clone and the suite passes, on Windows and on Ubuntu. A few are marked expected-to-fail where different RDKit and AutoDock Vina builds produce slightly different coordinates — which few depends on the platform, and the reason is attached to each. Nothing is tuned to match.

Three things that silently ruin a result

--minimize on an RMSD call superimposes the two structures before it measures them, which discards the thing a redock exists to test. Measured here on a pose displaced by exactly 3.0 Å: without the flag it returns 3.00000, and with it 0.00000. The flag does not weaken a validation. It makes every validation pass — a redock that never left the crystal pose and one that missed by 3 Å report the same number. A test in the repository fails the build if the string appears anywhere in it.

The other two are quieter. Vina's default seed of 0 means random, not zero, so an unseeded run cannot be repeated; and PDBQT drops formal charge and reorders atoms, so keep an SDF as the reference copy. None of the three produces an error.

One system, all the way through

Every chapter from 5 onward uses AmpC β-lactamase from Escherichia coli (UniProt P00811): four public crystal structures, a congeneric series of inhibitors with measured affinities, and five published prospective screening campaigns with experimental follow-up. Everything that can be reproduced from public files, can be.

The chapters

Chapters 1 and 19 ship no code, so there is no /ch01 or /ch19. If you typed one, you are in the right place already.

Versions

Parts of this book date faster than the rest. Model releases, licences and tool versions are listed with a dated changelog at dock.nexagenlabs.com/versions. Chapters 13 to 16 point here for a reason.

References

The reference list as machine-readable data, with a DOI on every entry that has one: dock.nexagenlabs.com/references

Errata

Corrections to the book and to the code are listed on the errata page. If you have found an error in either, please report it: the page says how.