Difference between revisions of "Rotate"

From PyMOLWiki
Jump to navigation Jump to search
Line 1: Line 1:
 
===DESCRIPTION===
 
===DESCRIPTION===
 +
'''rotate''' can be used to rotate the atomic coordinates of a molecular object.  Behavior differs depending on whether or not the '''object''' parameter is specified.
 
   
 
   
  "rotate" can be used to rotate the atomic coordinates of a
+
If object is '''None''', then rotate rotates the atomic coordinates according to the axes and angle for the selection and state provided.  All presentation geometries will need to be regenerated to reflect the new atomic coordinates.
  molecular object.  Behavior differs depending on whether or not the
+
 
  "object" parameter is specified.
+
If object is set to an object name, then selection and state are ignored and instead of translating the atomic coordinates, the object's representation display matrix is modified.  This option is for use in animations only.
+
 
  If object is None, then rotate rotates the atomic coordinates
 
  according to the axes and angle for the selection and state
 
  provided.  All representation geometries will need to be
 
  regenerated to reflect the new atomic coordinates.
 
 
  If object is set to an object name, then selection and state are
 
  ignored and instead of translating the atomic coordinates, the
 
  object's representation display matrix is modified.  This option
 
  is for use in animations only.
 
 
 
===USAGE===
 
===USAGE===
   
+
  rotate axis, angle [,selection [,state [,camera [,object [,origin]]]]]
  rotate axis, angle [,selection [,state [,camera [,object [,origin]]]]]
+
 
 
 
===PYMOL API===
 
===PYMOL API===
<source lang="python">
+
<source lang="python">
  cmd.rotate(list-or-string axis, string selection = "all", int state = 0,
+
cmd.rotate(list-or-string axis, string selection = "all", int state = 0,
              int camera = 1, string object = None)
+
          int camera = 1, string object = None)
</source>
+
</source>
===EXAMPLES===
+
 
  rotate x, 45, pept
+
===EXAMPES===
+
rotate x, 45, pept
 +
 
 
===NOTES===
 
===NOTES===
 
   if state = 0, then only visible state(s) are affected.
 
   if state = 0, then only visible state(s) are affected.
Line 34: Line 25:
 
If you have an electrostatic map and it's not rotating with the molecule as you expect it to, see the [[Cmd turn|Turn]] command.  [[Cmd turn|Turn]] moves the camera and thus the protein and map will be changed.
 
If you have an electrostatic map and it's not rotating with the molecule as you expect it to, see the [[Cmd turn|Turn]] command.  [[Cmd turn|Turn]] moves the camera and thus the protein and map will be changed.
  
 
 
[[Category:Commands|rotate]]
 
[[Category:Commands|rotate]]

Revision as of 20:37, 13 June 2005

DESCRIPTION

rotate can be used to rotate the atomic coordinates of a molecular object. Behavior differs depending on whether or not the object parameter is specified.

If object is None, then rotate rotates the atomic coordinates according to the axes and angle for the selection and state provided. All presentation geometries will need to be regenerated to reflect the new atomic coordinates.

If object is set to an object name, then selection and state are ignored and instead of translating the atomic coordinates, the object's representation display matrix is modified. This option is for use in animations only.

USAGE

rotate axis, angle [,selection [,state [,camera [,object [,origin]]]]]

PYMOL API

cmd.rotate(list-or-string axis, string selection = "all", int state = 0,
           int camera = 1, string object = None)

EXAMPES

rotate x, 45, pept

NOTES

  if state = 0, then only visible state(s) are affected.
  if state = -1, then all states are affected. 
Electrostatic Map Caveat

If you have an electrostatic map and it's not rotating with the molecule as you expect it to, see the Turn command. Turn moves the camera and thus the protein and map will be changed.