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

LayerWhat it representsWhy it matters
PDB-style identity and coordinatesAtom records, residue labels, chain identifiers, and x, y, z positionsDefines the starting geometry and spatial frame
Partial chargeA numeric charge on each atomContributes to electrostatic terms used by the selected AutoDock scoring model
AutoDock atom typeA type such as C, A, N, NA, OA, or HDMaps an atom to force-field parameters; it is not simply the element symbol
Ligand torsion treeROOT, BRANCH, and ENDBRANCH hierarchyDefines which ligand fragments move relative to one another during the search
TORSDOFNumber of torsional degrees of freedom recorded for the ligandDocuments the flexibility model and is used by AutoDock4-related terms
Remarks and provenanceOptional generator metadata, SMILES, atom mapping, and preparation notesCan 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

Simplified ligand PDBQT structure
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 roleTypical contentsPrimary inspection
Rigid receptor PDBQTPrepared receptor coordinates, polar hydrogens, partial charges, and AutoDock atom typesBiological assembly, retained components, protonation assumptions, missing atoms, charge and type assignment
Ligand PDBQTPrepared ligand coordinates and parameters plus a ROOT/BRANCH torsion treeChemical identity, state, geometry, atom types, charges, and selected rotatable bonds
Flexible-receptor PDBQTSelected sidechain atoms in separate BEGIN_RES/END_RES and branching recordsResidue selection, separation from the rigid receptor, and added search complexity
Docking-output PDBQTRanked poses and Vina remarks based on the prepared inputPose 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

CheckQuestion to answerEvidence to retain
1. IdentityIs this the intended receptor construct and ligand stereoisomer?Stable identifier and original input file
2. Chemical stateAre protonation, tautomer, formal charge, and hydrogens intentional?Enumeration rule, pH assumption, and selected structure
3. GeometryAre coordinates complete and physically plausible?Preparation method and visual review
4. ChargesWere partial charges assigned by the expected method and do they look plausible?Tool, version, options, and charge summary
5. Atom typesDo donor, acceptor, aromatic, halogen, metal, and other types match the intended model?Prepared PDBQT plus flagged exceptions
6. TorsionsAre rigid and rotatable bonds represented deliberately?Active torsion count and reviewed exceptions
7. Receptor scopeWere waters, ions, metals, cofactors, alternate locations, and flexible residues handled explicitly?Component decision record
8. Round tripCan 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

RecordMinimum useful detail
SourceOriginal receptor and ligand files, database identifiers, retrieval date, and selected chain or assembly
ChemistryProtonation, tautomer, stereochemistry, formal charge, hydrogen, and geometry decisions
PreparationSoftware, exact version, command or visible settings, and any manual edits
PDBQT interpretationCharge model, atom typing, active torsions, rigid root, flexible residues, and excluded components
IntegrityStable 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

  1. 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.
  2. AutoDock Vina project. Basic Docking Official AutoDock Vina Documentation (2026) Current official receptor and ligand PDBQT preparation, execution, and SDF export guidance.
  3. Meeko authors. Overview of Ligand Preparation Official Meeko Documentation (2026) Official description of RDKit input, atom typing, partial charges, rotatable bonds, and PDBQT generation.
  4. Meeko authors. Exporting Docking Results Official Meeko Documentation (2026) Official explanation of PDBQT bond-order limitations and SMILES-based reconstruction to SDF.
  5. 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.