Table of Contents

translate

“translate” translates the atomic coordinates of atoms in a selection. Alternatively, is modifies the matrix associated with a particular object or object-state.

Usage

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

Arguments

vector = float vector: 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 current state is modified {default}

camera = 0 or 1: is the vector in camera coordinates? {default: 1 (yes)}

object = string: object name (only if rotating object matrix) {default: None}

Examples

translate [1,0,0], name ca 

Notes

“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 is 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.

See Also

cmd.translate | commands