PPIIMoL

From PyMOLWiki
Revision as of 04:10, 14 August 2025 by SilviaRodriguez (talk | contribs)
Jump to navigation Jump to search

PPIIMoL

PPIIMoL is a Python module for PyMOL that automates the detection of polyproline II (PPII) helices in proteins. It streamlines structural analysis by:

  • Identifying characteristic torsional angles (phi and psi) of PPII helices.
  • Detecting potential non-canonical hydrogen bonds (Cα-H···O=C) relevant to structural stability.
  • Exporting results for further analysis.
  • Providing direct, customizable visualization in PyMOL.

This tool was developed as part of a Bachelor's Thesis in Computer Engineering in collaboration with the CSIC neuroscience laboratory.

Features

  • 🔍 Automatic detection of PPII segments via phi/psi angle analysis.
  • 🧬 Identification of Cα-H···O=C interactions relevant to structural stability.
  • 📊 Export of results in CSV format for further analysis.
  • 🎨 Direct visualization in PyMOL with customizable color codes.
  • 🖱️ Simple GUI based on Tkinter.

Requirements

  • PyMOL 2.x or newer.
  • Python with Tkinter support enabled (for the GUI).

Installation

  1. Download or clone the repository:
git clone https://github.com/silviaenma/PPIIMoL.git
  1. Start PyMOL and load the module:
run PPIIMoL/PPIIMoL.py
  1. (Optional) Install permanently as a plugin:
  • In PyMOL, go to: Plugin → Plugin Manager → Install New Plugin.
  • Select the file `PPIIMoL.py` or the full `PPIIMoL` folder.
  • Restart PyMOL to complete installation.

Example Usage

# Load the module in PyMOL
run PPIIMoL/PPIIMoL.py

# Load a structure
load 3bog.pdb

# Detect PPII helices
ppii_detect()

Results will be automatically exported in a folder named with the current date, containing CSV files with detected segments and interactions. Detected PPII helices will be highlighted in the PyMOL viewer according to the selected color scheme in the GUI.

Repository

The project is hosted on GitHub: PPIIMoL on GitHub

License

This project is licensed under the GNU GPLv3.