This is a read-only mirror of

Get coords

From PyMOL Wiki
Jump to navigation Jump to search

get_coords is an API only function that returns the coordinates of a selection as a numpy array.

New in PyMOL 1.7.4

The order of coordinates is that of the internal atom ordering, like in iterate, and unlike in get_coordset. The function considers the object state and TTT matrices, like in get_model.


cmd.get_coords(str selection='all', int state=1)

Returns: ndarray, shape (N, 3), where N is the number of atoms if state > 0, or (natoms * nstates) if state=0.


  • selection = str: atom selection {default: all}
  • state = int: state index or all states if state=0 {default: 1}

See Also

For state > 0, the function is equivalent to:

numpy.array(cmd.get_model(selection, state).get_coord_list())