What Is the PDBQT Format? Charges, Atom Types, and Torsions in AutoDock Vina
Learn what a PDBQT file stores, how ligand torsion trees differ from rigid receptor records, why bond orders can be lost, and what to inspect before an AutoDock Vina run.
A PDBQT file can look almost identical to a PDB file in a text editor. That similarity is useful for coordinates, but it can hide the decisions that matter most for docking. The final columns carry parameters used by the scoring function, while ligand records are reordered into a tree that tells the search which fragments may rotate [1].
This makes PDBQT the boundary between chemical preparation and docking execution. If the boundary is wrong, a perfectly completed Vina run can still answer a question about the wrong molecular representation.
What information does a PDBQT file contain?
The information layers in PDBQT
| Layer | What it represents | Why it matters |
|---|---|---|
| PDB-style identity and coordinates | Atom records, residue labels, chain identifiers, and x, y, z positions | Defines the starting geometry and spatial frame |
| Partial charge | A numeric charge on each atom | Contributes to electrostatic terms used by the selected AutoDock scoring model |
| AutoDock atom type | A type such as C, A, N, NA, OA, or HD | Maps an atom to force-field parameters; it is not simply the element symbol |
| Ligand torsion tree | ROOT, BRANCH, and ENDBRANCH hierarchy | Defines which ligand fragments move relative to one another during the search |
| TORSDOF | Number of torsional degrees of freedom recorded for the ligand | Documents the flexibility model and is used by AutoDock4-related terms |
| Remarks and provenance | Optional generator metadata, SMILES, atom mapping, and preparation notes | Can preserve information needed to reconstruct chemically meaningful output |
The Q and T in PDBQT refer to partial charge and atom type. The AutoDock 4.2 guide specifies their positions in ATOM and HETATM records and separately defines the ligand flexibility keywords [1]. Current Vina documentation uses prepared receptor and ligand PDBQT files for a standard rigid-receptor workflow [2].
An AutoDock atom type describes interaction behavior. For example, aromatic carbon and aliphatic carbon can have different types even though both atoms are carbon. A file therefore should not be audited by element count alone.
How to read a ligand PDBQT torsion tree
REMARK SMILES ...
ROOT
ATOM 1 C1 LIG A 1 ... 0.120 A
ATOM 2 N1 LIG A 1 ... -0.310 NA
ENDROOT
BRANCH 2 3
ATOM 3 C2 LIG A 1 ... 0.080 C
ATOM 4 O1 LIG A 1 ... -0.420 OA
ENDBRANCH 2 3
TORSDOF 1
The ROOT block is the rigid base of the ligand. Each BRANCH record identifies a rotatable connection and opens a child fragment; ENDBRANCH closes it. Branches can be nested, so the order of atom records follows the torsion tree rather than merely reproducing the input atom order [1].
Inspect the model visually as well as textually. A bond that should be rigid but appears as a branch can expand the search unnecessarily. A genuinely rotatable bond that was frozen can prevent relevant conformations from being explored. Ring bonds, amide-like bonds, terminal groups, and macrocycles deserve deliberate review rather than a rotatable-bond count alone.
Why PDBQT is not a complete chemical archive
PDBQT does not reliably preserve bond orders or formal charges as a general chemical exchange format. Meeko's export documentation explains that reconstructing those properties from PDBQT alone can be impossible for some molecules [4]. Its workflow addresses this by writing a SMILES string and atom-index mapping into ligand remarks, then using that metadata when exporting Vina results to SDF.
This is why the official Vina tutorial recommends a chemically explicit ligand source such as SDF and warns against using PDB as the starting format for small molecules, because PDB does not contain bond connectivity information [2]. Meeko parameterizes an RDKit molecule with 3D coordinates and explicit hydrogens into atom types, partial charges, and rotatable bonds [3,5].
How receptor and ligand PDBQT files differ
Rigid receptor, flexible ligand, and flexible sidechains
| File role | Typical contents | Primary inspection |
|---|---|---|
| Rigid receptor PDBQT | Prepared receptor coordinates, polar hydrogens, partial charges, and AutoDock atom types | Biological assembly, retained components, protonation assumptions, missing atoms, charge and type assignment |
| Ligand PDBQT | Prepared ligand coordinates and parameters plus a ROOT/BRANCH torsion tree | Chemical identity, state, geometry, atom types, charges, and selected rotatable bonds |
| Flexible-receptor PDBQT | Selected sidechain atoms in separate BEGIN_RES/END_RES and branching records | Residue selection, separation from the rigid receptor, and added search complexity |
| Docking-output PDBQT | Ranked poses and Vina remarks based on the prepared input | Pose coordinates, scores, preserved mapping metadata, and chemically safe export |
Standard Vina docking treats the receptor as rigid and the ligand as flexible. When selected receptor sidechains are flexible, current Meeko documentation places them in a separate flexible PDBQT representation and omits those movable atoms from the rigid receptor file. That is a different protocol, not an automatic property of every receptor PDBQT.
A practical PDBQT preflight checklist
Eight checks before execution
| Check | Question to answer | Evidence to retain |
|---|---|---|
| 1. Identity | Is this the intended receptor construct and ligand stereoisomer? | Stable identifier and original input file |
| 2. Chemical state | Are protonation, tautomer, formal charge, and hydrogens intentional? | Enumeration rule, pH assumption, and selected structure |
| 3. Geometry | Are coordinates complete and physically plausible? | Preparation method and visual review |
| 4. Charges | Were partial charges assigned by the expected method and do they look plausible? | Tool, version, options, and charge summary |
| 5. Atom types | Do donor, acceptor, aromatic, halogen, metal, and other types match the intended model? | Prepared PDBQT plus flagged exceptions |
| 6. Torsions | Are rigid and rotatable bonds represented deliberately? | Active torsion count and reviewed exceptions |
| 7. Receptor scope | Were waters, ions, metals, cofactors, alternate locations, and flexible residues handled explicitly? | Component decision record |
| 8. Round trip | Can a docked pose be exported without guessing the original chemistry? | SMILES/mapping remarks or another verified reconstruction path |
Run this inspection after the broader protein and ligand preparation workflow and before defining a production screen. If a ligand fails during conversion, use the SDF and ligand preflight guide to diagnose chemistry before repeatedly changing file converters.
What to record for a reproducible PDBQT workflow
Minimum preparation record
| Record | Minimum useful detail |
|---|---|
| Source | Original receptor and ligand files, database identifiers, retrieval date, and selected chain or assembly |
| Chemistry | Protonation, tautomer, stereochemistry, formal charge, hydrogen, and geometry decisions |
| Preparation | Software, exact version, command or visible settings, and any manual edits |
| PDBQT interpretation | Charge model, atom typing, active torsions, rigid root, flexible residues, and excluded components |
| Integrity | Stable filenames or checksums connecting source, prepared input, output, and exported pose |
Where a guided desktop workflow can help
The difficult part is not adding a file extension. It is keeping preparation decisions visible from input review to docking output. MolNexus 0.1.1 connects standard receptor and ligand preparation review, interaction-box setup, AutoDock Vina 1.2.7 execution with Vina or Vinardo, pose inspection, local history, and exports in one Windows workspace.
It does not replace chemical judgment or prove that a PDBQT representation is scientifically correct. Its value is making the standard workflow easier to inspect and retain when that documented scope matches the project.
Frequently asked questions
References
- Morris GM, Huey R, Lindstrom W, et al.. AutoDock Version 4.2 User Guide: PDBQT Format for Coordinate Files The Scripps Research Institute (2014) Original AutoDock guide defining PDBQT atom records, charges, atom types, torsion-tree keywords, and TORSDOF.
- AutoDock Vina project. Basic Docking Official AutoDock Vina Documentation (2026) Current official receptor and ligand PDBQT preparation, execution, and SDF export guidance.
- Meeko authors. Overview of Ligand Preparation Official Meeko Documentation (2026) Official description of RDKit input, atom typing, partial charges, rotatable bonds, and PDBQT generation.
- Meeko authors. Exporting Docking Results Official Meeko Documentation (2026) Official explanation of PDBQT bond-order limitations and SMILES-based reconstruction to SDF.
- Santos-Martins D, He Y, Eberhardt J, et al.. Meeko: Molecule Parametrization and Software Interoperability for Docking and Beyond Journal of Chemical Information and Modeling (2025) DOI: 10.1021/acs.jcim.5c02271 Original Meeko paper describing molecular parameterization and interoperable docking preparation.