Skip to content

Protein-ligand interaction tools -- SMINA & distance criteria - #2288

Merged
karolamik13 merged 11 commits into
prody:mainfrom
karolamik13:prody__main
Nov 16, 2026
Merged

karolamik13 merged 11 commits into
prody:mainfrom
karolamik13:prody__main

Conversation

@karolamik13

Copy link
Copy Markdown
Contributor

This PR finalizes and extends SMINA-based analysis tools that were previously partially implemented in the InSty module of ProDy. It also introduces new functions for analyzing ligand-protein interactions in molecular structures and MD trajectories.

1. SMINA scoring analysis
The following functions provide detailed analysis and visualization of protein–ligand interactions using the SMINA scoring function:

  • calcSminaPerAtomInteractions() – Improved calculation of individual ligand atom contributions to SMINA scoring terms.
  • showSminaPerAtomInteractions() – Visualizes atom-specific scoring contributions.
  • calcSminaResidueContributions() – Evaluates individual protein residue contributions to the SMINA score by systematically removing residues and recalculating the score.
  • listSminaResidueContributions() – Lists and ranks residues based on their scoring contributions.
  • showSminaResidueContributions() – Visualizes residue-specific contributions to individual scoring terms.
  • showSminaLigandStructure() – Displays a 2D ligand structure with atom-specific scoring contributions and optional information about interacting protein residues.

Example of usage (caseStudy5 from WatFinder tutorial; ADP molecule):
SMINA_contacts

2. Distance-based ligand-protein interaction analysis
These functions also focus on ligand-protein interactions but use a different approach based on geometric distance criteria rather than SMINA scoring. They enable the characterization of ligand-residue contacts, their distances, and persistence across molecular conformations, including MD trajectories.

  • calcLigandResidueDistances() – Calculates minimum distances between ligand atoms and protein residues, providing statistics such as mean distances, standard deviations, and contact persistence based on a user-defined distance cutoff.
  • showLigandResidueDistances() – Visualizes ligand-residue distances and contact persistence using customizable bar plots, allowing identification of residues that interact with the ligand most frequently.

An example (shown below) demonstrating the application of these #2 functions is based on caseStudy4b from the WatFinder tutorial.

Top 15 residues:
MES_top15_5A

All residues:
MES_top100_5A

@jamesmkrieger jamesmkrieger left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good and looks like it’s working well

@karolamik13
karolamik13 merged commit 66027d8 into prody:main Nov 16, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants