This release is a pre-release and may not be stable for production use.
Hydrogen Bond Analysis Tool (HBAT) v2
A Python package to automate the analysis of potential hydrogen bonds and similar type of weak interactions like halogen bonds and non-canonical interactions in macromolecular structures, available in Protein Data Bank (PDB) file format. HBAT uses a geometric approach to identify potential hydrogen bonds by analyzing distance and angular criteria between donor-hydrogen-acceptor triplets.
Background
HBAT v2 is a modern Python re-implementation of the original Perl-based tool developed by Abhishek Tiwari and Sunil Kumar Panigrahi.
Features
- Detect and analyze potential hydrogen bonds, halogen bonds, and X-H...π interactions
- Automated PDB fixing with OpenBabel and PDBFixer integration
- Supports graphical (tkinter), command-line, and programming interfaces
- Use graphical interfaces for interactive analysis, CLI/API for batch processing and automation
- Cooperativity chain visualization using NetworkX/matplotlib and GraphViz
- Export cooperativity chain visualizations to PNG, SVG, PDF formats
- Built-in presets for different structure types (high-resolution, NMR, membrane proteins, etc.)
- Customizable distance cutoffs, angle thresholds, and analysis modes.
- Multiple Output Formats: Text, CSV, and JSON export options
- Optimized algorithms for efficient analysis of large structures
- Cross-Platform: Works on Windows, macOS, and Linux.
Please review HBAT documentation for more details.
Supported Interactions
- Hydrogen Bonds: O-H...O, N-H...O, N-H...N, and other X-H...Y interactions
- Halogen Bonds: C-X...Y interactions (X = F, Cl, Br, I; Y = N, O, S)
- X-H...π Interactions: Hydrogen bonds to aromatic ring systems
Please review HBAT documentation for more details.
Installation
Option 1: Install from PyPI (Recommended)
pip install hbat
Run HBAT Command-Line Interface (CLI) using hbat or launch HBAT GUI using hbat-gui.
Option 2: Install from Source
git clone https://github.com/abhishektiwari/hbat.git
cd hbat
pip install -e .
Alternatively,
pip install git+https://github.com/abhishektiwari/hbat.git
Run HBAT Command-Line Interface (CLI) using hbat or launch HBAT GUI using hbat-gui.
Option 3: Install from Conda
conda install -c hbat hbat
Requirements
System Requirements
- Python: 3.9 or higher
- tkinter: tkinter is included with Python standard library on most systems. However, on Mac install Python and tkinter using
brew.
brew install python python3-tk
- GraphViz (Optional): Required for advanced cooperativity chain visualization with high-quality graph rendering. HBAT will automatically fall back to NetworkX/matplotlib visualization if GraphViz is not available.
Install GraphViz:
On Ubuntu/Debian:
sudo apt-get update
sudo apt-get install graphviz
On macOS (using Homebrew):
brew install graphviz
On Windows:
- Download and install from GraphViz official website
- Or using Chocolatey:
choco install graphviz - Or using conda:
conda install -c conda-forge graphviz
Note: After installing GraphViz, restart your terminal/command prompt before running HBAT to ensure the GraphViz executables are available in your PATH.
Usage
Graphical Interface
Launch the GUI application:
hbat-gui
The GUI provides,
- File browser for loading PDB files
- Parameter configuration panels
- Tabbed results display
- Export and visualization options
Command-Line Interface
Basic usage:
hbat input.pdb
Output Format Options
HBAT supports multiple output formats with automatic detection based on file extension:
# Single file outputs (format auto-detected from extension)
hbat input.pdb -o results.txt # Text format
hbat input.pdb -o results.csv # CSV format (single file with all data)
hbat input.pdb -o results.json # JSON format (single file with all data)
# Multiple file outputs (separate files per interaction type)
hbat input.pdb --csv results # Creates results_h_bonds.csv, results_x_bonds.csv, etc.
hbat input.pdb --json results # Creates results_h_bonds.json, results_x_bonds.json, etc.
With custom parameters:
hbat input.pdb -o results.csv --hb-distance 3.0 --mode local
List Available Presets
hbat --list-presets
Use a specific preset
hbat protein.pdb --preset high_resolution
hbat membrane_protein.pdb --preset membrane_proteins
Use preset with custom overrides
hbat protein.pdb --preset drug_design_strict --hb-distance 3.0 --verbose
CLI Options
positional arguments:
input Input PDB file
optional arguments:
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
Output file (format auto-detected from extension: .txt, .csv, .json)
--json JSON Export to multiple JSON files (base name for files)
--csv CSV Export to multiple CSV files (base name for files)
Preset Options:
--preset PRESET Load parameters from preset file (.hbat or .json)
--list-presets List available example presets and exit
Analysis Parameters:
--hb-distance HB_DISTANCE
Hydrogen bond H...A distance cutoff in Å (default: 3.5)
--hb-angle HB_ANGLE Hydrogen bond D-H...A angle cutoff in degrees (default: 120)
--da-distance DA_DISTANCE
Donor-acceptor distance cutoff in Å (default: 4.0)
--xb-distance XB_DISTANCE
Halogen bond X...A distance cutoff in Å (default: 4.0)
--xb-angle XB_ANGLE Halogen bond C-X...A angle cutoff in degrees (default: 120)
--pi-distance PI_DISTANCE
π interaction H...π distance cutoff in Å (default: 4.5)
--pi-angle PI_ANGLE π interaction D-H...π angle cutoff in degrees (default: 90)
--covalent-factor COVALENT_FACTOR
Covalent bond detection factor (default: 1.2)
--mode {complete,local}
Analysis mode: complete (all interactions) or local (intra-residue only)
Output Control:
--verbose, -v Verbose output with detailed progress
--quiet, -q Quiet mode with minimal output
--summary-only Output summary statistics only
Analysis Filters:
--no-hydrogen-bonds Skip hydrogen bond analysis
--no-halogen-bonds Skip halogen bond analysis
--no-pi-interactions Skip π interaction analysis
License
This project is licensed under the MIT License - see the LICENSE file for details.
Citation
If you use HBAT in your research, please cite:
@software{tiwari2025hbat,
author = {Tiwari, Abhishek},
title = {HBAT: Hydrogen Bond Analysis Tool},
version = {v2},
year = {2025},
url = {https://github.com/abhishektiwari/hbat}
}
@article{tiwari2007hbat,
author = {Tiwari, Abhishek and Panigrahi, Sunil Kumar},
doi = {10.3233/ISI-2007-00337},
journal = {In Silico Biology},
month = dec,
number = {6},
title = {{HBAT: A Complete Package for Analysing Strong and Weak Hydrogen Bonds in Macromolecular Crystal Structures}},
volume = {7},
year = {2007}
}
Contributing
See our contributing guide and development guide. At a high-level,
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
1 maintainer
Release files for hbat 2.2.15rc33178779002
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hbat-2.2.15rc33178779002.tar.gz | 2.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hbat-2.2.15rc33178779002-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.6 MB
Release files / hbat-2.2.15rc33178779002.tar.gz
| Download URL | hbat-2.2.15rc33178779002.tar.gz |
|---|---|
| Size | 2.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
97d051dbd3604a28b276cb7f6416a4dd7355f5b3dc3dc8debe257ea2cba3fa24
|
|
BLAKE2b-256 checksum How to use checksums |
b2bde0d925700faac8a7b919d569a443d1d7c7f76f40201c0a220c8b41dd9ffb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2025.
Transparency logRelease files / hbat-2.2.15rc33178779002-py3-none-any.whl
| Download URL | hbat-2.2.15rc33178779002-py3-none-any.whl |
|---|---|
| Size | 171.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
85f9a411d6eb9e41cf83cbe35a393a6ebf992aa686156231788b76e5fc2cd4b4
|
|
BLAKE2b-256 checksum How to use checksums |
c75c928cb88540b48641b64674d362823977499ee0a6601b27e7b2cb73919a3e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2025.
Transparency log
