Difference between revisions of "Translate"

From PyMOLWiki
Jump to navigation Jump to search
Line 51: Line 51:
[[Rotate]], [[Move]]
[[Rotate]], [[Move]]

Revision as of 10:28, 20 June 2009


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.


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


cmd.translate(list vector, string selection = "all", int state = 0,
              int camera = 1, string object = None)


A simple example; just move the alpha-carbons one Ang. along the X-axis.


# move the alpha carbons one Ang. on the X-axis
translate [1,0,0], name ca


A slightly more complicated example. Load two proteins, align them, and then move one away from the other to see their similarities separately.

# load 1cll and 1ggz
fetch 1cll 1ggz, async=0

# align the two proteins
cealign 1cll, 1ggz

# orient the proteins

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


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


Rotate, Move