|
| 1 | +ORI Tokens |
| 2 | +========== |
| 3 | + |
| 4 | +ORI tokens define the center of mass for the designed portion of the enzyme scaffold. It allows for control over the active site and transition |
| 5 | +state orientation relative to the protein core. In binder design, the ORI token defines the center of mass of the binder relative to the target protein. |
| 6 | + |
| 7 | +.. warning:: |
| 8 | + |
| 9 | + ORI tokens are only used in RFdiffusion2 and are not compatible with the original RFdiffusion. |
| 10 | + You must specify an ORI token when using RFdiffusion2 |
| 11 | + |
| 12 | +How to Add ORI Tokens to Your Input PDB |
| 13 | +--------------------------------------- |
| 14 | +First add a ``HETATM`` to your PDB file: |
| 15 | + |
| 16 | +.. code-block:: none |
| 17 | +
|
| 18 | + HETATM 6700 ORI ORI z 1 9.450 95.149 43.231 0.00 0.00 z ORI |
| 19 | +
|
| 20 | +Let's break down what each of these fields mean: |
| 21 | + |
| 22 | +* ``HETATM``: This indicates that the line describes a non-standard atom. |
| 23 | +* ``6700``: This is the atom serial number. You can choose any unique number that does not conflict with existing atom numbers in your PDB file. |
| 24 | +* ``ORI``: This is the atom name. It should be set to ``ORI`` to indicate that this atom represents the ORI token. |
| 25 | +* ``ORI``: This is the residue name. It should also be set to ``ORI``. |
| 26 | +* ``z``: This is the chain identifier. You can choose any single character (letter or number) that does not conflict with existing chain IDs in your PDB file. |
| 27 | +* ``1``: This is the residue sequence number. You can choose any number that does not conflict with existing residue numbers in your PDB file. |
| 28 | +* ``9.450 95.149 43.231``: These are the X, Y, and Z coordinates of the ORI token in Angstroms. Set these to the desired position for the ORI token. |
| 29 | +* ``0.00 0.00``: These are the occupancy and temperature factor values. They can be set to ``0.00`` for the ORI token. |
| 30 | +* ``z``: This is the element symbol. It can be set to any character, as it is not relevant for the ORI token. |
| 31 | +* ``ORI``: This is the charge. It can be set to any value, as it is not relevant for the ORI token. |
| 32 | + |
| 33 | +For an example of this you can take a look at ``rf_diffusion/benchmark/input/mcsa_41/M0584_1ldm.pdb``, which is used in the demo discussed in the README. |
| 34 | +The last line of this file is the ORI token. |
| 35 | + |
| 36 | +.. note:: |
| 37 | + You can also add the ORI token using PyMOL by running the following command in the PyMOL command line: |
| 38 | + |
| 39 | + .. code-block:: |
| 40 | +
|
| 41 | + cmd.delete("molecule1");cmd.pseudoatom(object="molecule1", pos=[-1,3,2], elem="ORI", name="ORI", vdw=1.5, hetatm=True, chain='z', segi='z', resn="ORI"); cmd.show("sphere", "molecule1"); |
| 42 | +
|
| 43 | +Once you have added this line to your PDB file, you can move it using `PyMOL <https://www.pymol.org/>`_ or other protein visualization software. |
| 44 | + |
| 45 | +For PyMOL, you can easily move the ORI token by selecting it (clicking on the sphere that represents the ORI token) and using the `"move" <https://pymolwiki.org/index.php/Move>`_ command or by dragging it with the mouse. |
| 46 | +To drag the ``HETATM`` with the mouse, select the atom by clicking on it, then go to A (action) -> drag coordinates: |
| 47 | + |
| 48 | +.. figure:: /_static/images/drag_action.png |
| 49 | + :width: 90% |
| 50 | + :alt: Selecting the 'drag coordinates' option from the Action menu in PyMOL |
| 51 | + |
| 52 | + Selecting the menu option that will allow you to drag only the ORI token in PyMOL. |
| 53 | + |
| 54 | +If you are using a three-button mouse, you can hold shift and right-click on the ``HETATM`` to drag it in and out of the screen. |
| 55 | +To translate the atom in and out of the screen, hold shift while center-clicking and dragging. |
| 56 | + |
| 57 | +.. figure:: /_static/images/moving_ori.gif |
| 58 | + :alt: Moving the ORI token in PyMOL by clicking and dragging it with the mouse |
| 59 | + |
| 60 | + Moving the ORI token in PyMOL by clicking and dragging it with the mouse. |
| 61 | + |
| 62 | + |
| 63 | +Recommendations for ORI Token Placement |
| 64 | +--------------------------------------- |
| 65 | +ORI tokens specify the center of mass of the designed region of the protein, but how do you determine where that should be? |
| 66 | + |
| 67 | +One method of doing this is to estimate where the center of mass of the designed region should be relative to your input structure and then generate several ORI tokens (20-30) in a sphere around that area. |
| 68 | +Whether you want to homogeneously or randomly sample different locations within that sphere and how far apart you want the different ORI tokens to be will depend on your specific design problem. |
| 69 | +If you have the computational resources, you can generate several designs for each ORI token placement and then filter the results. |
| 70 | + |
| 71 | + |
| 72 | + |
| 73 | + |
0 commit comments