Skip to main content

Fixes problems in PDB files

Project description

PDBFixer

CI Status PyPI Version Conda Forge PyPI Downloads Python Versions License: Apache-2.0 Documentation neoralab Authors OpenMM Authors

PDBFixer

PDBFixer is a Python library for repairing and preparing Protein Data Bank (PDB) files before simulation. It focuses on an intuitive API that automates common cleanup steps so structures are ready for downstream workflows without manual editing.

Overview

PDBFixer can automatically:

  • Add missing heavy atoms and hydrogens.
  • Build missing loops.
  • Convert non-standard residues to standard equivalents.
  • Select a single position for atoms with alternate locations.
  • Remove unwanted chains or heterogens.
  • Build a water box for explicit solvent simulations.

Consult the manual for full usage guidance.

Improvements over the OpenMM fork

  • Published on PyPI as pdbfixer-neoralab with support for Python 3.11 and newer.
  • Modernized packaging via pyproject.toml and versioningit, keeping releases in sync with Git tags.
  • Distributed purely as a Python API, removing the legacy web and command-line interfaces to focus on library usability.

Installation

PyPI or uv

Install with pip or uv (Python 3.11+):

pip install pdbfixer-neoralab
uv pip install pdbfixer-neoralab

Conda

Install from conda-forge:

conda install -c conda-forge pdbfixer

From source

Clone the repository and follow the manual for source installation details.

Versioning

PDBFixer uses versioningit to derive its version from Git tags. Building from a source checkout therefore requires either a cloned repository with Git metadata or a source distribution that already includes the generated version. When no tag information is available, the default reported version is 0+unknown. To preview the build version:

python -m versioningit

Quickstart

PDBFixer is distributed purely as a Python API. Use it directly from your code:

from pdbfixer import PDBFixer

fixer = PDBFixer(filename="input.pdb")
fixer.findMissingResidues()
fixer.findMissingAtoms()
fixer.addMissingAtoms()
fixer.addMissingHydrogens(pH=7.0)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pdbfixer_neoralab-1.0.0.tar.gz (59.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pdbfixer_neoralab-1.0.0-py3-none-any.whl (61.1 kB view details)

Uploaded Python 3

File details

Details for the file pdbfixer_neoralab-1.0.0.tar.gz.

File metadata

  • Download URL: pdbfixer_neoralab-1.0.0.tar.gz
  • Upload date:
  • Size: 59.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for pdbfixer_neoralab-1.0.0.tar.gz
Algorithm Hash digest
SHA256 9c8db93273703fadafc16fe35509ee4f74bc979a6104de336c8f44fb08da0217
MD5 c33fb4b15d41c45a075d48cb0de6217b
BLAKE2b-256 e581937667dbf1ff9d049bf3b46d98ac5fb8e9da84bde897cb2aeaa6d9b13510

See more details on using hashes here.

File details

Details for the file pdbfixer_neoralab-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for pdbfixer_neoralab-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 05785590a18f6b6cdcd963350994ee41c929cc1638c5e8a1b71d97b77a500eff
MD5 fc9499c9903ef4827cfd7cdac178b8d7
BLAKE2b-256 4c9a2436e7349031aeafea6d378e67dabb1464743568ac5a46725af61d7cdcb3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page