This is a read-only mirror of pymolwiki.org

Difference between revisions of "ShowLigandWaters"

From PyMOL Wiki
Jump to navigation Jump to search
m (13 revisions)
 
(7 intermediate revisions by one other user not shown)
Line 9: Line 9:
  
 
== Introduction ==
 
== Introduction ==
This script detects waters molecules within a specified distance from the ligand.
+
This script detects waters molecules within a specified distance from the ligand.<br>
Water molecules are shown.
+
Detected water molecules are shown as spheres.<br>
Distance between water molecules and O or N atoms of ligand are shown and is maked an output file containing a list of distance between waters and ligand atoms and the number of interactions
+
Distances between water molecules and O or N atoms of ligand (potential H-bonds) are shown by dotted lines.<br>
 +
An output file containing a list of distance between waters and ligand atoms and the number of interactions is written in the main PyMol folder.
  
  
Line 28: Line 29:
 
<source lang="python">
 
<source lang="python">
 
PyMOL>waters FAD, 2.8
 
PyMOL>waters FAD, 2.8
 +
</source>
 +
Output in GUI of PyMol:
  
 
Total number of water molecules at 2.8 A from ligand FAD: 3  
 
Total number of water molecules at 2.8 A from ligand FAD: 3  
 
 
Number of water molecules that interact with ligand: 3
 
Number of water molecules that interact with ligand: 3
 
 
Number of interactions between water molecules and ligand: 4
 
Number of interactions between water molecules and ligand: 4
 
   
 
   
</source>
+
output file: waters.txt
 
 
output file: waters.py
 
  
 
HOH residue 2002 -- and -- ['FAD', '1363', 'O1P']  --->  2.611289 A
 
HOH residue 2002 -- and -- ['FAD', '1363', 'O1P']  --->  2.611289 A
Line 54: Line 53:
 
== The Code ==
 
== The Code ==
  
Copy the following text and save it as pairwisedistances.py
+
Copy the following text and save it as waters.py
  
 
<source lang="python">
 
<source lang="python">
from pymol import cmd, stored, math
+
# -*- coding: cp1252 -*-
 +
"""
 +
This script detects waters molecules within a specified distance from the ligand.
 +
Water molecules are shown.
 +
Distance between water molecules and O or N atoms of ligand are shown.
  
def pairwise_dist(sel1, sel2, max_dist, output="N", sidechain="N", show="N"):
+
Author: Gianluca Tomasello, Gianluca Molla
"""
+
University of Insubria, Varese, Italy
usage: pairwise_dist sel1, sel2, max_dist, [output=S/P/N, [sidechain=N/Y, [show=Y/N]]]
+
09/02/2013
sel1 and sel2 can be any to pre-existing or newly defined selections
+
gianluca.molla@uninsubria.it
max_dist: maximum distance in Angstrom between atoms in the two selections
 
--optional settings:
 
output: accepts Screen/Print/None (default N)
 
sidechain: limits (Y) results to sidechain atoms (default N)
 
show: shows (Y) individual distances in pymol menu (default=N)
 
"""
 
print ""
 
cmd.delete ("dist*")
 
extra=""
 
if sidechain=="Y": extra=" and not name c+o+n"
 
 
#builds models
 
m1=cmd.get_model(sel2+" around "+str(max_dist)+" and "+sel1+extra)
 
m1o=cmd.get_object_list(sel1)
 
m2=cmd.get_model(sel1+" around "+str(max_dist)+" and "+sel2+extra)
 
m2o=cmd.get_object_list(sel2)
 
  
#defines selections
+
Usage
cmd.select("__tsel1a", sel1+" around "+str(max_dist)+" and "+sel2+extra)
+
waters, [ligand name, distance]
cmd.select("__tsel1", "__tsel1a and "+sel2+extra)
+
 
cmd.select("__tsel2a", sel2+" around "+str(max_dist)+" and "+sel1+extra)
+
Parameters
cmd.select("__tsel2", "__tsel2a and "+sel1+extra)
+
 
cmd.select("IntAtoms_"+max_dist, "__tsel1 or __tsel2")
+
ligand : the ligand residue name
cmd.select("IntRes_"+max_dist, "byres IntAtoms_"+max_dist)
+
 
+
distance : a float number that specify the maximum distance from the ligand to consider the water molecule
#controlers-1
+
         
if len(m1o)==0:
+
Output
print "warning, '"+sel1+extra+"' does not contain any atoms."
+
-A file is produced containing a list of distance between waters and ligand atoms and the number of interactions
return
+
-A graphic output show the water molecules interacting whith the ligand atoms by showing the distances between them
if len(m2o)==0:
+
"""
print "warning, '"+sel2+extra+"' does not contain any atoms."
+
 
return
+
from pymol import cmd,stored
+
#define function: waters
#measures distances
+
def waters(ligand, distance):
s=""
+
    stored.HOH = []
counter=0
+
    cmd.set('label_color','white')  
for c1 in range(len(m1.atom)):
+
    cmd.delete ("sele")
for c2 in range(len(m2.atom)):
+
    cmd.hide ("everything")
distance=math.sqrt(sum(map(lambda f: (f[0]-f[1])**2, zip(m1.atom[c1].coord,m2.atom[c2].coord))))
+
    cmd.show_as ("sticks", "resn %s" % ligand)
if distance<float(max_dist):
+
    #iterate all water molecules nearby the ligand
s+="%s/%s/%s/%s/%s to %s/%s/%s/%s/%s: %.3f\n" % (m1o[0],m1.atom[c1].chain,m1.atom[c1].resn,m1.atom[c1].resi,m1.atom[c1].name,m2o[0],m2.atom[c2].chain,m2.atom[c2].resn,m2.atom[c2].resi,m2.atom[c2].name, distance)
+
    cmd.iterate('resn %s around %s and resn HOH' % (ligand,distance),'stored.HOH.append(resi)')  
counter+=1
+
    f = open("waters.txt","a")
if show=="Y": cmd.distance (m1o[0]+" and "+m1.atom[c1].chain+"/"+m1.atom[c1].resi+"/"+m1.atom[c1].name, m2o[0]+" and "+m2.atom[c2].chain+"/"+m2.atom[c2].resi+"/"+m2.atom[c2].name)
+
    count=0
 +
    count_int=0
 +
   
 +
    for i in range(0,len(stored.HOH)):      
 +
        cmd.distance('dist_HOH_FAD', 'resi ' + stored.HOH[i], '(resn %s and n. O*+N*) w. 3.6 of resi %s'% (ligand, stored.HOH[i]))
 +
        stored.name = []
 +
        #iterate all ligand atoms within a predetermined distance from the water molecule
 +
        cmd.iterate('(resn %s and n. O*+N*) w. 3.6 of resi %s'% (ligand, stored.HOH[i]),'stored.name.append([resn,resi,name])')  
 +
 
 +
        if stored.name:          
 +
            count = count+1
 +
            count_int = count_int+len(stored.name)
 +
 
 +
        for j in range(0,len(stored.name)):           
 +
            cmd.select('base', 'resi ' + stored.HOH[i])
 +
            cmd.select('var','resn '+ligand+ ' and n. ' + stored.name[j][2])
 +
            #calculate the distance between a specific atom and the water molecule
 +
            dist = cmd.get_distance('base','var')           
 +
            f.write('HOH residue %s -- and -- %s  --->  %f A\n'%(stored.HOH[i],stored.name[j], dist)) 
 +
 
 +
    cmd.select ("waters","resn %s around %s and resn HOH" % (ligand,distance))
 +
    cmd.show_as ("spheres", "waters")
 +
    cmd.zoom ("visible")
 +
    num_atm = cmd.count_atoms ("waters")
 +
    print ("Total number of water molecules at %s A from ligand %s: %s \n" % (distance,ligand,num_atm))
 +
    print ("Number of water molecules that interact with ligand: %d\n" % (count))
 +
    print ("Number of interactions between water molecules and ligand: %d\n" % count_int)
 +
    f.write('-------------------------------------------------------------\n')
 +
    f.write("Total number of water molecules at %s A from ligand %s: %s \n" % (distance,ligand,num_atm))
 +
    f.write("Number of water molecules that interact with ligand: %d\n" % count)
 +
    f.write("Number of interactions between water molecules and ligand: %d\n\n\n\n" % count_int)
 +
    f.close()
 +
    cmd.delete ("waters")
 +
   
 +
cmd.extend("waters",waters)
  
#controler-2
 
if counter==0:
 
print "warning, no distances were measured! Check your selections/max_dist value"
 
return
 
 
#outputs
 
if output=="S": print s
 
if output=="P":
 
f=open('IntAtoms_'+max_dist+'.txt','w')
 
f.write("Number of distances calculated: %s\n" % (counter))
 
f.write(s)
 
f.close()
 
print "Results saved in IntAtoms_%s.txt" % max_dist
 
print "Number of distances calculated: %s" % (counter)
 
cmd.hide("lines", "IntRes_*")
 
if show=="Y": cmd.show("lines","IntRes_"+max_dist)
 
cmd.deselect()
 
 
 
cmd.extend("pairwise_dist", pairwise_dist)
 
 
</source>
 
</source>
  

Latest revision as of 03:53, 28 March 2014

Type Python Script
Download
Author(s) Gianluca Tomasello
License CC BY-NC-SA


Introduction

This script detects waters molecules within a specified distance from the ligand.
Detected water molecules are shown as spheres.
Distances between water molecules and O or N atoms of ligand (potential H-bonds) are shown by dotted lines.
An output file containing a list of distance between waters and ligand atoms and the number of interactions is written in the main PyMol folder.


Usage

waters [ligand name, distance]


Required Arguments

  • ligand name = the ligand residue name
  • distance = max distance in Angstroms


Examples

example #1 on PDB structure (1C0L)

PyMOL>waters FAD, 2.8

Output in GUI of PyMol:

Total number of water molecules at 2.8 A from ligand FAD: 3 Number of water molecules that interact with ligand: 3 Number of interactions between water molecules and ligand: 4

output file: waters.txt

HOH residue 2002 -- and -- ['FAD', '1363', 'O1P'] ---> 2.611289 A HOH residue 2002 -- and -- ['FAD', '1363', 'O5B'] ---> 3.592691 A HOH residue 2008 -- and -- ['FAD', '1363', 'O1A'] ---> 2.678604 A HOH residue 2009 -- and -- ['FAD', '1363', 'O2P'] ---> 2.643039 A


Total number of water molecules at 2.8 A from ligand FAD: 3 Number of water molecules that interact with ligand: 3 Number of interactions between water molecules and ligand: 4

example #1


The Code

Copy the following text and save it as waters.py

# -*- coding: cp1252 -*-
"""
This script detects waters molecules within a specified distance from the ligand.
Water molecules are shown.
Distance between water molecules and O or N atoms of ligand are shown.

Author: Gianluca Tomasello, Gianluca Molla
University of Insubria, Varese, Italy
09/02/2013
gianluca.molla@uninsubria.it

Usage
waters, [ligand name, distance]

Parameters

ligand : the ligand residue name 

distance : a float number that specify the maximum distance from the ligand to consider the water molecule
           
Output
-A file is produced containing a list of distance between waters and ligand atoms and the number of interactions
-A graphic output show the water molecules interacting whith the ligand atoms by showing the distances between them
"""

from pymol import cmd,stored
#define function: waters
def waters(ligand, distance):
    stored.HOH = [] 
    cmd.set('label_color','white') 
    cmd.delete ("sele")
    cmd.hide ("everything")
    cmd.show_as ("sticks", "resn %s" % ligand)
    #iterate all water molecules nearby the ligand
    cmd.iterate('resn %s around %s and resn HOH' % (ligand,distance),'stored.HOH.append(resi)') 
    f = open("waters.txt","a")
    count=0
    count_int=0
    
    for i in range(0,len(stored.HOH)):        
        cmd.distance('dist_HOH_FAD', 'resi ' + stored.HOH[i], '(resn %s and n. O*+N*) w. 3.6 of resi %s'% (ligand, stored.HOH[i]))
        stored.name = []
        #iterate all ligand atoms within a predetermined distance from the water molecule
        cmd.iterate('(resn %s and n. O*+N*) w. 3.6 of resi %s'% (ligand, stored.HOH[i]),'stored.name.append([resn,resi,name])') 

        if stored.name:           
            count = count+1
            count_int = count_int+len(stored.name)

        for j in range(0,len(stored.name)):            
            cmd.select('base', 'resi ' + stored.HOH[i])
            cmd.select('var','resn '+ligand+ ' and n. ' + stored.name[j][2]) 
            #calculate the distance between a specific atom and the water molecule
            dist = cmd.get_distance('base','var')            
            f.write('HOH residue %s -- and -- %s  --->  %f A\n'%(stored.HOH[i],stored.name[j], dist))  

    cmd.select ("waters","resn %s around %s and resn HOH" % (ligand,distance))
    cmd.show_as ("spheres", "waters")
    cmd.zoom ("visible")
    num_atm = cmd.count_atoms ("waters")
    print ("Total number of water molecules at %s A from ligand %s: %s \n" % (distance,ligand,num_atm))
    print ("Number of water molecules that interact with ligand: %d\n" % (count))
    print ("Number of interactions between water molecules and ligand: %d\n" % count_int)
    f.write('-------------------------------------------------------------\n')
    f.write("Total number of water molecules at %s A from ligand %s: %s \n" % (distance,ligand,num_atm))
    f.write("Number of water molecules that interact with ligand: %d\n" % count)
    f.write("Number of interactions between water molecules and ligand: %d\n\n\n\n" % count_int)
    f.close()
    cmd.delete ("waters")
    
cmd.extend("waters",waters)