Keywords: manual

Next: model.write_data() write Up: The model class: handling Previous: model.reorder_atoms() standardize Contents Index

## model.orient() -- center and orient MODEL

`orient()`

Output:
  orient_data object

> This command translates the MODEL so that its gravity center is at the origin of the coordinate system and that the three principal axes of the model's inertia ellipsoid correspond to the , , and axes of the coordinate system. It may even be used for approximate superposition if molecules have a similar non-spherical shape. Information about the principal axes is written to the `log` file.

> On successful completion, an orient_data object is returned; for instance, if you save this in a variable 'r', the following data are available:

- `r.translation`; the translation used to transform mdl to the center of mass
- `r.rotation`; the rotation matrix used to transform mdl (applied after the translation)

Example: examples/commands/orient_model.py

      # Example for: model.orient()

      # This will orient the model along the principal axes of the inertia ellipsoid:

      from modeller import *

      env = environ()
      env.io.atom_files_directory = '../atom_files'
      mdl = model(env)
      mdl.read(file='1fas')
      r = mdl.orient()
      mdl.write(file='1fas.ini')

      print "Translation: ", r.translation