Difference between revisions of "FindSurfaceCharge"

From PyMOLWiki
Jump to navigation Jump to search
m (TeddyWarner moved page FindSurfaceResiduesListCharged to FindSurfaceCharge: Significantly changed function)
(Changed function significantly)
Line 6: Line 6:
 
}}
 
}}
  
Based on the [[findSurfaceResidues]] script, the [[findSurfaceResiduesListCharged]] script will select and color surface residues and atoms on an object or selection. The function will also identify and output a list of all charged residues on the surface of a selection. This additionally calculates the ionization state of a protein at a given pH.
+
Drawing upon the [[findSurfaceResidues]] script, the [[findSurfaceCharge]] script will identify and output a list of all charged residues on the surface of a selectionand calculates the ionization state of a protein at a given pH. The charge can be calculated for either a folded or denatured protein. This function is intended to be used to give buffer conditions for mass spectrometry.
 
 
Each time, the script will create two new selections called, '''exposed_res_XYZ''' and '''exposed_atm_XYZ''' where ''XYZ'' is some random number. This is done so that no other selections/objects are overwritten.
 
  
 
= Usage =
 
= Usage =
  
  findSurfaceResiduesListCharged [pH=7.0 [, selection=all [, cutoff=2.5 [, doShow=0 ]]]
+
  findSurfaceResiduesListCharged [pH=7.0 [, folded=True [, selection=all [, cutoff=2.5 ]]]
  
 
= Arguments =
 
= Arguments =
  
 
* '''pH''' = float: The pH to calculate the surface charge at {default: 7.0}
 
* '''pH''' = float: The pH to calculate the surface charge at {default: 7.0}
 +
* '''Folded''' = bool: Whether the program should calculate the charge of a folded (True) or denatured (False) protein.
 
* '''selection''' = str: The object or selection for which to find exposed residues {default: all}
 
* '''selection''' = str: The object or selection for which to find exposed residues {default: all}
 
* '''cutoff''' = float: The cutoff in square Angstroms that defines exposed or not. Those atoms with > cutoff Ang^2 exposed will be considered ''exposed'' {default: 2.5 Ang^2}
 
* '''cutoff''' = float: The cutoff in square Angstroms that defines exposed or not. Those atoms with > cutoff Ang^2 exposed will be considered ''exposed'' {default: 2.5 Ang^2}
* '''doShow''' = 0/1: Change the visualization to highlight the exposed residues vs interior {default: 0}
 
  
 
= Examples =
 
= Examples =
  
 
<gallery>
 
<gallery>
File:ChargedOutput.PNG|Result of 4FIX.pdb at pH 7.4.
+
File:SurfaceCharge.PNG|Result of 4FIX.pdb at pH 7.0.
 
</gallery>
 
</gallery>
  
Line 34: Line 32:
  
 
# see how pH changes the protein surface charge:
 
# see how pH changes the protein surface charge:
findSurfaceResiduesListCharged[7.2]
+
findSurfaceResiduesListCharged(7.0)
     The expected surface charge of this protein at pH 7.2 is: -0.42
+
     The expected surface charge of this protein at pH 7.0 is: -2.55
 +
 
 +
findSurfaceResiduesListCharged(7.0, False)
 +
    The expected charge of this denatured protein at pH 7.0 is: +0.26
  
 
findSurfaceResiduesListCharged[10.0]
 
findSurfaceResiduesListCharged[10.0]
     The expected surface charge of this protein at pH 10.0 is: -13.17
+
     The expected surface charge of this protein at pH 10.0 is: -14.19
 
 
findSurfaceResiduesListCharged[5.0]
 
    The expected surface charge of this protein at pH 5.0 is: +53.02
 
  
 
</source>
 
</source>

Revision as of 22:00, 14 March 2023

Type Python Module
Download findSurfaceResiduesListCharged.py
Author(s) Teddy Warner
License BSD-2-Clause
This code has been put under version control in the project Pymol-script-repo

Drawing upon the findSurfaceResidues script, the findSurfaceCharge script will identify and output a list of all charged residues on the surface of a selectionand calculates the ionization state of a protein at a given pH. The charge can be calculated for either a folded or denatured protein. This function is intended to be used to give buffer conditions for mass spectrometry.

Usage

findSurfaceResiduesListCharged [pH=7.0 [, folded=True [, selection=all [, cutoff=2.5 ]]]

Arguments

  • pH = float: The pH to calculate the surface charge at {default: 7.0}
  • Folded = bool: Whether the program should calculate the charge of a folded (True) or denatured (False) protein.
  • selection = str: The object or selection for which to find exposed residues {default: all}
  • cutoff = float: The cutoff in square Angstroms that defines exposed or not. Those atoms with > cutoff Ang^2 exposed will be considered exposed {default: 2.5 Ang^2}

Examples

run findSurfaceResiduesListCharged.py
fetch 4FIX, async=0

findSurfaceResiduesListCharged

# see how pH changes the protein surface charge:
findSurfaceResiduesListCharged(7.0)
    The expected surface charge of this protein at pH 7.0 is: -2.55

findSurfaceResiduesListCharged(7.0, False)
    The expected charge of this denatured protein at pH 7.0 is: +0.26

findSurfaceResiduesListCharged[10.0]
    The expected surface charge of this protein at pH 10.0 is: -14.19

See Also