Rotate - Revision history

Bell: 17 revisions

2014-03-28T03:49:30Z

17 revisions

Folf at 11:39, 29 March 2011

2011-03-29T11:39:00Z

Karo at 11:28, 7 September 2010

2010-09-07T11:28:55Z

Karo: Tried to clarify the object option

2010-09-07T11:22:57Z

Tried to clarify the object option

New page

'''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.

If object is set to an object name, then selection and state are ignored and instead of translating the atomic coordinates, the [[Object_Matrix|object matrix]] is modified. This option is intended for use in animations.

The "camera" option controls whether the camera or the model's axes are used to interpret the translation vector. To move the object relative to the camera set '''camera=1''' (which is default), or to move the molecule relative to the model's geometry, set '''camera=0'''.

If this doesn't do what you want, consider [[Turn]].

===USAGE===
<source lang="python">
rotate axis, angle [,selection [,state [,camera [,object [,origin]]]]]
</source>

===ARGUMENTS===
'''axis'''
::x, y, z, or float vector: axis about which to rotate

'''angle'''
::float: degrees of rotation

'''selection'''
:: string: atoms whose coordinates should be modified {default: all}
:: state > 0: only the indicated state is modified
:: state = 0: all states are modified
:: state = -1: only the current state is modified {default}
:: camera = 0 or 1: is the axis specific in camera coordinates? {default: 1}
:: object = string: object name (only if rotating object matrix) {default: None}
:: origin = float vector: origin of rotateion {default: None}

===PYMOL API===
<source lang="python">
cmd.rotate(list-or-string axis, angle=0, string selection = "all", int state = 0,
int camera = 1, string object = None)
</source>

===EXAMPLES===
rotate x, 45, pept
rotate [1,1,1], 10, chain A

=====Electrostatic Map Caveat=====
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.

===SEE ALSO===
[[Object_Matrix|object matrix]] [[Translate]] [[Turn]] [[Model_Space_and_Camera_Space]]

[[Category:Commands|Rotate]]
[[Category:States|Rotate]]

Karo: Added "Arguments" according to source

2010-06-23T09:31:47Z

Added "Arguments" according to source

New page

'''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.

If this doesn't do what you want, consider [[Turn]].

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

===ARGUMENTS===
axis = x, y, z, or float vector: axis about which to rotate
angle = float: degrees of rotation
selection = string: atoms whose coordinates should be modified {default: all}
state > 0: only the indicated state is modified
state = 0: all states are modified
state = -1: only the current state is modified {default}
camera = 0 or 1: is the axis specific in camera coordinates? {default: 1}
object = string: object name (only if rotating object matrix) {default: None}
origin = float vector: origin of rotateion {default: None}

===PYMOL API===
<source lang="python">
cmd.rotate(list-or-string axis, angle=0, string selection = "all", int state = 0,
int camera = 1, string object = None)
</source>

===EXAMPLES===
rotate x, 45, pept
rotate [1,1,1], 10, chain A

=====Electrostatic Map Caveat=====
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.

===SEE ALSO===
[[Translate]] [[Turn]]

[[Category:Commands|Rotate]]
[[Category:States|Rotate]]

Vinnyrose at 14:23, 20 June 2009

2009-06-20T14:23:37Z

New page

===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.

If this doesn't do what you want, consider [[Turn]].

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

===PYMOL API===
<source lang="python">
cmd.rotate(list-or-string axis, angle=0, string selection = "all", int state = 0,
int camera = 1, string object = None)
</source>

===EXAMPLES===
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 [[Cmd turn|Turn]] command. [[Cmd turn|Turn]] moves the camera and thus the protein and map will be changed.

===SEE ALSO===
[[Translate]] [[Turn]]

[[Category:Commands|Rotate]]
[[Category:States|Rotate]]

Pete0934 at 21:47, 13 May 2008

2008-05-13T21:47:06Z

Pete0934 at 21:46, 13 May 2008

2008-05-13T21:46:01Z

New page

===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===
<source lang="python">
cmd.rotate(list-or-string axis, angle=0, string selection = "all", int state = 0,
int camera = 1, string object = None)
</source>

===EXAMPES===
rotate x, 45, pept

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

===SEE ALSO===
[[Translate]]

=====Electrostatic Map Caveat=====
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]]

Tree at 05:17, 23 February 2005

2005-02-23T05:17:58Z

New page

===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 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===

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

===PYMOL API===
<source lang="python">
cmd.rotate(list-or-string axis, string selection = "all", int state = 0,
int camera = 1, string object = None)
</source>
===EXAMPLES===

rotate x, 45, pept

===NOTES===

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

[[Category:Commands|rotate]]

@@ Line 23: / Line 23: @@
 '''selection'''
 ::    string: atoms whose coordinates should be modified {default: all}
-::    state > 0: only the indicated state is modified
+'''state'''
-::    state = 0: all states are modified
+::    > 0: only the indicated state is modified
-::    state = -1: only the current state is modified {default}
+::    = 0: all states are modified
-::    camera = 0 or 1: is the axis specific in camera coordinates? {default: 1}
+::    = -1: only the current state is modified {default}
-::    object = string: object name (only if changing object matrix) {default: None}
+'''camera'''
-::    origin = float vector: origin of rotation {default: None}
+::     = 0 or 1: is the axis specific in camera coordinates? {default: 1}
 ===PYMOL API===

← Older revision	Revision as of 03:49, 28 March 2014
(No difference)

@@ Line 15: / Line 15: @@
 </source>
-===EXAMPES===
+===EXAMPLES===
   rotate x, 45, pept
@@ Line 21: / Line 21: @@
     if state = 0, then only visible state(s) are affected.
     if state = -1, then all states are affected.
 ===SEE ALSO===
 [[Translate]]
 [[Category:Commands|rotate]]