FindSurfaceCharge: Difference between revisions

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