Translate - Revision history

Pyadmin: 13 revisions

2014-03-28T01:44:38Z

13 revisions

Jaredsampson: /* EXAMPLES */ Added example numbers. Moved Example 1 description below its heading.

2014-02-19T16:12:52Z

EXAMPLES: Added example numbers. Moved Example 1 description below its heading.

Jaredsampson: /* ARGUMENTS */ corrected list of arguments from 1.7.0.0 `help translate`

2014-02-19T16:09:43Z

ARGUMENTS: corrected list of arguments from 1.7.0.0 `help translate`

Karo: Arguments added

2010-09-07T11:28:44Z

Arguments added

Karo: Tried to clarify the object option

2010-09-07T11:23:05Z

Tried to clarify the object option

New page

'''translate''' can be used to translate the atomic coordinates of a molecular object (move an object). Behavior differs depending on whether or not the "object" parameter is specified.

If object is None, then translate translates atomic coordinates according to the vector provided for the selection and in the 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'''.

===USAGE===
<source lang="python">
translate vector [,selection [,state [,camera [,object ]]]]
</source>

===PYMOL API===
<source lang="python">
cmd.translate(list vector, string selection = "all", int state = 0,
int camera = 1, string object = None)
</source>

===EXAMPLES===
A simple example; just move the alpha-carbons one Ang. along the X-axis.
====Example====
<source lang="python">
# move the alpha carbons one Ang. on the X-axis
translate [1,0,0], name ca
</source>

====Example====
A slightly more complicated example. Load two proteins, align them, and then move one away from the other to see their similarities separately.
<source lang="python">
# load 1cll and 1ggz
fetch 1cll 1ggz, async=0

# align the two proteins
cealign 1cll, 1ggz

# orient the proteins
orient

# move 1cll above 1ggz so we can
# see both proteins separately
translate [0, 40, 0], 1cll
</source>

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

===SEE ALSO===
[[Rotate]], [[Move]], [[Model_Space_and_Camera_Space]]

[[Category:Commands|Translate]]
[[Category:States|Translate]]

Vinnyrose at 14:28, 20 June 2009

2009-06-20T14:28:13Z

New page

===DESCRIPTION===
'''translate''' can be used to translate the atomic coordinates of a molecular object (move an object). Behavior differs depending on whether or not the "object" parameter is specified.

If object is None, then translate translates atomic coordinates according to the vector provided for the selection and in the 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 overall representation display matrix is modified. This option is for use in animations only.

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

===USAGE===
<source lang="python">
translate vector [,selection [,state [,camera [,object ]]]]
</source>

===PYMOL API===
<source lang="python">
cmd.translate(list vector, string selection = "all", int state = 0,
int camera = 1, string object = None)
</source>

===EXAMPLES===
A simple example; just move the alpha-carbons one Ang. along the X-axis.
====Example====
<source lang="python">
# move the alpha carbons one Ang. on the X-axis
translate [1,0,0], name ca
</source>

====Example====
A slightly more complicated example. Load two proteins, align them, and then move one away from the other to see their similarities separately.
<source lang="python">
# load 1cll and 1ggz
fetch 1cll 1ggz, async=0

# align the two proteins
cealign 1cll, 1ggz

# orient the proteins
orient

# move 1cll above 1ggz so we can
# see both proteins separately
translate [0, 40, 0], 1cll
</source>

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

===SEE ALSO===
[[Rotate]], [[Move]]

[[Category:Commands|Translate]]
[[Category:States|Translate]]

Pete0934 at 21:45, 13 May 2008

2008-05-13T21:45:18Z

New page

===DESCRIPTION===
'''translate''' can be used to translate the atomic coordinates of a molecular object (move an object). Behavior differs depending on whether or not the "object" parameter is specified.

If object is None, then translate translates atomic coordinates according to the vector provided for the selection and in the 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 overall representation display matrix is modified. This option is for use in animations only.

The "camera" option controls whether the camera or the model's axes are used to interpret the translation vector.

===USAGE===

translate vector [,selection [,state [,camera [,object ]]]]

===PYMOL API===
<source lang="python">
cmd.translate(list vector, string selection = "all", int state = 0,
int camera = 1, string object = None)
</source>

===EXAMPLES===
A simple example; just move the alpha-carbons one Ang. along the X-axis.
====Example====
<source lang="python">
# move the alpha carbons one Ang. on the X-axis
translate [1,0,0], name ca
</source>

====Example====
A slightly more complicated example. Load two proteins, align them, and then move one away from the other to see their similarities separately.
<source lang="python">
# load 1cll and 1ggz
fetch 1cll 1ggz, async=0

# align the two proteins
cealign 1cll, 1ggz

# orient the proteins
orient

# move 1cll above 1ggz so we can
# see both proteins separately
translate [0, 40, 0], 1cll
</source>

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

===SEE ALSO===
[[Rotate]], [[Move]]

[[Category:Commands|translate]]

Tree at 04:42, 23 February 2005

2005-02-23T04:42:33Z

New page

===DESCRIPTION===

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

If object is None, then translate translates atomic coordinates
according to the vector provided for the selection and in the 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 overall representation display matrix is modified. This
option is for use in animations only.

The "camera" option controls whether the camera or the model's
axes are used to interpret the translation vector.

===USAGE===

translate vector [,selection [,state [,camera [,object ]]]]

===PYMOL API===
<source lang="python">
cmd.translate(list vector, string selection = "all", int state = 0,
int camera = 1, string object = None)
</source>

===EXAMPLES===

translate [1,0,0], name ca

===NOTES===

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

[[Category:Commands|translate]]

@@ Line 13: / Line 13: @@
 ===ARGUMENTS===
-'''axis'''
+'''vector'''
-::x, y, z, or float vector: axis about which to rotate
+::float vector: [x, y, z] translation vector
-−
 '''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}
+::    state = -1: only current state is modified {default}
-::    camera = 0 or 1: is the axis specific in camera coordinates? {default: 1}
-::    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 vector in camera coordinates? {default: 1 (yes)}
 ===PYMOL API===

← Older revision	Revision as of 01:44, 28 March 2014
(No difference)

@@ Line 37: / Line 37: @@
 ===EXAMPLES===
 A simple example; just move the alpha-carbons one Ang. along the X-axis.
 <source lang="python">
 # move the alpha carbons one Ang. on the X-axis
@@ Line 44: / Line 44: @@
 </source>
-====Example====
+====Example 2====
 A slightly more complicated example.  Load two proteins, align them, and then move one away from the other to see their similarities separately.
 <source lang="python">