User:Remig/plico/tugManual - Revision history

Remig: No rebuild with ALT-SHIFT-DRAG

2015-07-27T13:01:15Z

No rebuild with ALT-SHIFT-DRAG

Remig: /* Plico Tug Jmol script manual */

2015-07-24T18:29:18Z

‎Plico Tug Jmol script manual

Remig: /* Plico Tug Jmol script manual */

2015-07-22T16:09:29Z

‎Plico Tug Jmol script manual

Remig: Add freeze mode

2014-02-27T19:51:06Z

Add freeze mode

Remig: /* Plico Tug Jmol script manual */

2014-02-25T14:29:39Z

‎Plico Tug Jmol script manual

Remig at 00:09, 16 February 2014

2014-02-16T00:09:33Z

Remig: Add full chain mode stuff

2014-02-13T00:04:08Z

Add full chain mode stuff

Remig: Plico Tug Manual

2014-02-04T21:38:33Z

Plico Tug Manual

New page

== Plico Tug Jmol script manual ==

'''Tug''' is the central script of the Plico suite described here [[User:Remig/plico]] and is loaded by many of the other scripts if not already in place. It allows the user to move or rotate one section of a polypeptide against another by mouse actions. The script can be found here [[User:Remig/plico/tug]]. Copy and paste it to a text editor and save it as tug.spt in your scripts location.

It can then be launched by the following macro:

<pre>Title=PLICO Tug
Script=script <path to scripts>/tug.spt;plicotug</pre>

(Macros are placed in the .jmol/macros folder as described here [[Macro]].)

'''Operation:'''

Before invoking Tug, a polypeptide would normally be already loaded in the application. Any hydrogens should have been deleted as well as any alternate atoms. Residues must be labeled (no UNKs please). The Plico script Remap can be run if residues are not labeled as would be the case if the polypeptide was loaded from an XYZ file. However, if the polypeptide was generated by the Plico script Polymeraze, no other action would be required. The ball-and-stick style scheme, perhaps with dots on, seems best for working with tug.

When Tug is selected from the macro menu, a list of mouse actions appears in the upper-left of the Jmol application window.

Initially the only Tug option is to ALT-CLICK on an atom to mark the block or side-chain to be moved or rotated. Press the left mouse button (if more than one) while holding down the ALT key while hovering over an atom to perform this action.

When ALT-CLICK is pressed on any atom, the list is expanded to include ALT-DRAG to move atoms, SHIFT to set anchors, ALT-CTRL to set pivot points, ALT-SHIFT to set a destination atom, and DOUBLE-CLICK to exit Tug.

When ALT-CLICK is pressed on a back-bone atom (or a CB or O atom), its residue is presented in the RASMOL color scheme* and halos are drawn on its N and C atoms to mark it as available to be moved or rotated by ALT-DRAG. ALT-CLICK on a back-bone atom of another residue will then highlight all atoms between the two residues inclusive. The entire block will then be available to be moved or rotated by ALT-DRAG.

When ALT-CLICK is pressed on a side-chain atom beyond the CB atom, a circle is drawn around the atom and subsequent movements are then restricted to the side-chain until ALT-CLICK is pressed again on the same or another atom. ALT-DRAG then pulls just the side-chain in the direction of mouse movement as allowed by rotation on the chi bonds of the side-chain. Rotation angles are restricted to multiples of 60Â°. Pulling on the CG atom of proline toggles between its two puckered states. Note that marking a side chain atom does not cancel back-bone selection.

When ALT-DRAG is performed by pressing the left mouse button down while holding the alt key down and then moving the mouse, just the selected back-bone or side-chain moves accordingly. For a back-bone selection, when the button is released, the chain on either end of the selection is then rebuilt to proper bond lengths and angles by rotation on available ''phi'' and ''psi'' bonds. The required processing can take some time and the menu background color will go from yellow to pink for the duration. If the action cannot be accommodated, the chain will be restored to its previous state. Sometimes Jmol fails to recognize the button up event; in that case simply do another drag away and back.

Anchors may be set on either side of the back-bone block with SHIFT-CLICK to restrict the range of ''phi'' and ''psi'' bonds available to accommodate movements. Anchor atoms are highlighted in RASMOL colors*. A C-terminal anchor (C-ward) is set by default at the N of the C-terminal residue though it can then be moved or removed if desired. When a back-bone block is moved, atoms beyond the anchors are then guaranteed not to move as their ''psi'' and ''phi'' bonds are not rotated. (The N-terminal side of the block beyond any N side anchor (N-ward) may nevertheless see some small movement in certain collision cases. ) Note that some ''psi'' and ''phi'' bonds may be made unavailable regardless of anchor placement by action of the Plico Freeze script.

One or two pivot points may be set with ALT-CTRL-CLICK on any atom. Pivot point atoms are colored green. When a single pivot point is set, the back-bone selection rotates on the pivot rather than translating. The rotation is in the XY viewing plane. When two pivot points are set, the rotation is instead on the axis between them.

A single atom may be set as a target with ALT-SHIFT-CLICK. A cross will appear on the atom when so selected (and will disappear if ALT-SHIFT-CLICK is done on the same atom.) When a target atom is selected, mouse drag movements, including rotations, then move towards or away from the target atom. Otherwise movements are in the XY viewing plane.

When DOUBLE-CLICK is performed anywhere, a prompt is presented allowing you to exit Tug keeping your changes if any, to cancel and go back to Tug, or to undo the entire Tug session and restore the polypeptide from the file, tugsave.pdb, created when Tug was first entered.

'''Performance:'''

Tug is written as a compromise between performance and robustness. It makes heavy demands on Jmol resources and Jmol sometimes responds by locking up, requiring the services of the task manager to close it down. If that happens, you can then restart Jmol and load the file tugsave.pdb to quickly recover. Regardless movements in Tug are better made in several small steps rather than one large step. Large movements can better be achieved with other scripts in the Plico suite such as Turn, ToAlpha, and ToBeta.

Performance is achieved by only moving the selected block when dragging and only checking for collisions within the atom set between anchors after the chain has been rebuilt. Collisions of the selected block with atoms outside the atom set between anchors stop movement only if the collision is with a back-bone atom or a side-chain atom that cannot be moved away. Water molecules are deleted when encountered but may be replaced later by the Plico script Hydrate.

After the chain is rebuilt, internal collisions are resolved by moving side-chains, deleting water, and counter-rotating back-bone oxygens. The planar nature of the peptide bond results in the ''phi'' and ''psi'' bond pair on either side of a back-bone oxygen being parallel. Therefore rotations on both, identical in magnitude but opposite in direction, result in substantial movement of the oxygen away from a collision situation without much consequent movement of the rest of the molecule. Some movement does nevertheless occur and Tug can sometimes move the entire chain N-ward of the oxygen somewhat despite an N-ward anchor.

If collisions cannot be resolved, Tug restores the previous state. Also when exiting Tug, you are given the option to undo the entire session.

* If the default color scheme is RASMOL then the JMOL colors are used for highlighting.

@@ Line 20: / Line 20: @@
 Initially the only Tug options are to ALT-CLICK on an atom to mark the block or side-chain to be moved or rotated, SHIFT-CLICK to select a chain, just CLICK on a ''phi'' or ''psi'' bond, or DOUBLE-CLICK to exit Tug.  Press the left mouse button (if more than one) while holding down the ALT key or SHIFT key while hovering over an atom to perform these actions.
-When ALT-CLICK is pressed on any atom, the list is expanded to include ALT-DRAG to move atoms, SHIFT-CLICK to set anchors, ALT-CTRL-CLICK to set pivot points, ALT-SHIFT-CLICK to set a destination atom, ALT-DRAG to move, and SHIFT-ALT-DRAG to alt move.  This is Anchor mode described below.
+When ALT-CLICK is pressed on any atom, the list is expanded to include ALT-DRAG to move atoms, SHIFT-CLICK to set anchors, ALT-CTRL-CLICK to set pivot points, ALT-SHIFT-CLICK to set a destination atom, ALT-DRAG to move, and ALT-SHIFT-DRAG to alt move.  This is Anchor mode described below.
 If instead SHIFT-CLICK is pressed on any atom, the same list is presented except that SHIFT-CLICK remains as mark chain and Tug enters the Full Chain mode described below.
@@ Line 39: / Line 39: @@
 '''Anchor mode:'''
-When ALT-CLICK is pressed on a back-bone atom (or a CB atom), its residue is presented in the RASMOL color scheme* and halos are drawn on its N and C atoms to mark it as available to be moved or rotated by ALT-DRAG.  ALT-CLICK on a back-bone atom of another residue will then highlight all atoms between the two residues inclusive. The entire block will then be available to be moved or rotated by ALT-DRAG or SHIFT-ALT-DRAG.  When performed by pressing the left mouse button down while holding the alt key down and then moving the mouse, just the selected block moves accordingly.  The block stops if it collides with atoms outside the anchor range; this stoppage can be overridden with SHIFT-ALT-DRAG to get past a collision if necessary.  When the button is released, the chain on either end of the selection is then rebuilt to proper bond lengths and angles by rotation on available ''phi'' and ''psi'' bonds.  The required processing can take some time and the menu background color will go from yellow to pink for the duration.  If the action cannot be accommodated, you are given the option to  be restore the chain to its previous state.  (Sometimes Jmol fails to recognize the button up event; in that case simply do another drag away and back.)
+When ALT-CLICK is pressed on a back-bone atom (or a CB atom), its residue is presented in the RASMOL color scheme* and halos are drawn on its N and C atoms to mark it as available to be moved or rotated by ALT-DRAG.  ALT-CLICK on a back-bone atom of another residue will then highlight all atoms between the two residues inclusive. The entire block will then be available to be moved or rotated by ALT-DRAG or ALT-SHIFT-DRAG.  When performed by pressing the left mouse button down while holding the alt key down and then moving the mouse, just the selected block moves accordingly.  The block stops if it collides with atoms outside the anchor range; this stoppage can be overridden with ALT-SHIFT-DRAG to get past a collision if necessary.  When the button is released, the chain on either end of the selection is then rebuilt to proper bond lengths and angles by rotation on available ''phi'' and ''psi'' bonds.  The required processing can take some time and the menu background color will go from yellow to pink for the duration.  If the action cannot be accommodated, you are given the option to  be restore the chain to its previous state.  (Sometimes Jmol fails to recognize the button up event; in that case simply do another drag away and back.)
 Anchors may be set on either side of the back-bone block with SHIFT-CLICK to restrict the range of ''phi'' and ''psi'' bonds available to accommodate movements.  Anchor atoms are highlighted in RASMOL colors*.  A C-terminal anchor (C-ward) is set by default at the N of the C-terminal residue though it can then be moved or removed if desired.  When a back-bone block is moved, atoms beyond the anchors are then guaranteed not to move as their ''psi'' and ''phi'' bonds are not rotated.  (The N-terminal side of the block beyond any N side anchor (N-ward) may nevertheless see some small movement in certain collision cases. )  Note that some ''psi'' and ''phi'' bonds may be made unavailable regardless of anchor placement by freezing described above.

← Older revision		Revision as of 18:29, 24 July 2015
Line 3:		Line 3:


−	'''Tug''' ~~is the central script of the [[User:Remig/plico\|Plico]] suite and is loaded by many of the other scripts if not already in place. It~~ allows the user to move or rotate one section of a polypeptide against another by mouse actions. It also allows the user to move an entire chain to nest against another chain. The script can be found [[User:Remig/plico/tug\|here]]. Copy and paste it to a text editor and save it as tug.spt in your scripts location.	+	'''Tug''' allows the user to move or rotate one section of a polypeptide against another by mouse actions. It also allows the user to move an entire chain to nest against another chain. The script can be found [[User:Remig/plico/tug\|here]]. Copy and paste it to a text editor and save it as tug.spt in your scripts location.

	It can then be launched by the following macro:		It can then be launched by the following macro:

@@ Line 8: / Line 8: @@
 <pre>Title=PLICO Tug
-Script=script <path to scripts>/tug.spt;plicotug
+Script=script <path to scripts>/tug.spt;plico_tug
 </pre>
 (Macros are placed in the .jmol/macros folder as described in [[Macro]].)
@@ Line 18: / Line 18: @@
 When Tug is selected from the macro menu, a list of mouse actions appears in the upper-left of the Jmol application window.
-Initially the only Tug option is to ALT-CLICK on an atom to mark the block or side-chain to be moved or rotated, SHIFT-CLICK to select a chain or just CLICK on a ''phi'' or ''psi'' bond.  Press the left mouse button (if more than one) while holding down the ALT key or SHIFT key while hovering over an atom to perform these actions.
+Initially the only Tug options are to ALT-CLICK on an atom to mark the block or side-chain to be moved or rotated, SHIFT-CLICK to select a chain, just CLICK on a ''phi'' or ''psi'' bond, or DOUBLE-CLICK to exit Tug.  Press the left mouse button (if more than one) while holding down the ALT key or SHIFT key while hovering over an atom to perform these actions.
-When ALT-CLICK is pressed on any atom, the list is expanded to include ALT-DRAG to move atoms, SHIFT-CLICK to set anchors, ALT-CTRL-CLICK to set pivot points, ALT-SHIFT-CLICK to set a destination atom, ALT-DRAG to move, SHIFT-ALT-DRAG to alt move, and DOUBLE-CLICK to exit Tug.  This is Anchor mode described below.
+When ALT-CLICK is pressed on any atom, the list is expanded to include ALT-DRAG to move atoms, SHIFT-CLICK to set anchors, ALT-CTRL-CLICK to set pivot points, ALT-SHIFT-CLICK to set a destination atom, ALT-DRAG to move, and SHIFT-ALT-DRAG to alt move.  This is Anchor mode described below.
 If instead SHIFT-CLICK is pressed on any atom, the same list is presented except that SHIFT-CLICK remains as mark chain and Tug enters the Full Chain mode described below.
@@ Line 39: / Line 39: @@
 '''Anchor mode:'''
-When ALT-CLICK is pressed on a back-bone atom (or a CB atom), its residue is presented in the RASMOL color scheme* and halos are drawn on its N and C atoms to mark it as available to be moved or rotated by ALT-DRAG.  ALT-CLICK on a back-bone atom of another residue will then highlight all atoms between the two residues inclusive. The entire block will then be available to be moved or rotated by ALT-DRAG or SHIFT-ALT-DRAG.  When performed by pressing the left mouse button down while holding the alt key down and then moving the mouse, just the selected block moves accordingly.  The block stops if it collides with atoms outside the anchor range; this stoppage can be overridden with SHIFT-ALT-DRAG to get past a collision if necessary.  When the button is released, the chain on either end of the selection is then rebuilt to proper bond lengths and angles by rotation on available ''phi'' and ''psi'' bonds.  The required processing can take some time and the menu background color will go from yellow to pink for the duration.  If the action cannot be accommodated, the chain will be restored to its previous state.  (Sometimes Jmol fails to recognize the button up event; in that case simply do another drag away and back.)
+When ALT-CLICK is pressed on a back-bone atom (or a CB atom), its residue is presented in the RASMOL color scheme* and halos are drawn on its N and C atoms to mark it as available to be moved or rotated by ALT-DRAG.  ALT-CLICK on a back-bone atom of another residue will then highlight all atoms between the two residues inclusive. The entire block will then be available to be moved or rotated by ALT-DRAG or SHIFT-ALT-DRAG.  When performed by pressing the left mouse button down while holding the alt key down and then moving the mouse, just the selected block moves accordingly.  The block stops if it collides with atoms outside the anchor range; this stoppage can be overridden with SHIFT-ALT-DRAG to get past a collision if necessary.  When the button is released, the chain on either end of the selection is then rebuilt to proper bond lengths and angles by rotation on available ''phi'' and ''psi'' bonds.  The required processing can take some time and the menu background color will go from yellow to pink for the duration.  If the action cannot be accommodated, you are given the option to  be restore the chain to its previous state.  (Sometimes Jmol fails to recognize the button up event; in that case simply do another drag away and back.)
 Anchors may be set on either side of the back-bone block with SHIFT-CLICK to restrict the range of ''phi'' and ''psi'' bonds available to accommodate movements.  Anchor atoms are highlighted in RASMOL colors*.  A C-terminal anchor (C-ward) is set by default at the N of the C-terminal residue though it can then be moved or removed if desired.  When a back-bone block is moved, atoms beyond the anchors are then guaranteed not to move as their ''psi'' and ''phi'' bonds are not rotated.  (The N-terminal side of the block beyond any N side anchor (N-ward) may nevertheless see some small movement in certain collision cases. )  Note that some ''psi'' and ''phi'' bonds may be made unavailable regardless of anchor placement by freezing described above.
@@ Line 67: / Line 67: @@
 After the chain is rebuilt, internal collisions are resolved by moving side-chains, deleting water, and counter-rotating back-bone oxygens.  The planar nature of the peptide bond results in the ''phi'' and ''psi'' bond pair on either side of a back-bone oxygen being parallel.  Therefore rotations on both, identical in magnitude but opposite in direction, result in substantial movement of the oxygen away from a collision situation with little consequent movement of the rest of the molecule.  Some movement does nevertheless occur and Tug can sometimes move the entire chain N-ward of the oxygen somewhat despite an N-ward anchor.
-If collisions cannot be resolved, Tug restores the previous state.  Also when exiting Tug, you are given the option to undo the entire session.
+If collisions cannot be resolved, Tug gives the option to restore the previous state.  Also when exiting Tug, you are given the option to undo the entire session.
 * If the default color scheme is RASMOL then the JMOL colors are used for highlighting.

@@ Line 18: / Line 18: @@
 When Tug is selected from the macro menu, a list of mouse actions appears in the upper-left of the Jmol application window.
-Initially the only Tug option is to ALT-CLICK on an atom to mark the block or side-chain to be moved or rotated or SHIFT-CLICK to select a chain.  Press the left mouse button (if more than one) while holding down the ALT key or SHIFT key while hovering over an atom to perform these actions.
+Initially the only Tug option is to ALT-CLICK on an atom to mark the block or side-chain to be moved or rotated, SHIFT-CLICK to select a chain or just CLICK on a ''phi'' or ''psi'' bond.  Press the left mouse button (if more than one) while holding down the ALT key or SHIFT key while hovering over an atom to perform these actions.
 When ALT-CLICK is pressed on any atom, the list is expanded to include ALT-DRAG to move atoms, SHIFT-CLICK to set anchors, ALT-CTRL-CLICK to set pivot points, ALT-SHIFT-CLICK to set a destination atom, ALT-DRAG to move, SHIFT-ALT-DRAG to alt move, and DOUBLE-CLICK to exit Tug.  This is Anchor mode described below.
@@ Line 30: / Line 30: @@
 When ALT-CLICK is pressed on a back-bone O atom, a circle is drawn around the atom and subsequent movements are then restricted to that atom until ALT-CLICK is pressed again on the same or another atom.  ALT-DRAG then rotates the ''phi'' and ''psi'' bonds on either side of the O in opposite directions to move the O atom with minor movement of the atoms in the N-terminal direction from the O atom.  SHIFT-ALT-DRAG does the same except the minor movement is of the atoms in the C-terminal direction from the O atom.   Note again that marking a back-bone O atom does not cancel an existing back-bone selection.
@@ Line 36: / Line 41: @@
 When ALT-CLICK is pressed on a back-bone atom (or a CB atom), its residue is presented in the RASMOL color scheme* and halos are drawn on its N and C atoms to mark it as available to be moved or rotated by ALT-DRAG.  ALT-CLICK on a back-bone atom of another residue will then highlight all atoms between the two residues inclusive. The entire block will then be available to be moved or rotated by ALT-DRAG or SHIFT-ALT-DRAG.  When performed by pressing the left mouse button down while holding the alt key down and then moving the mouse, just the selected block moves accordingly.  The block stops if it collides with atoms outside the anchor range; this stoppage can be overridden with SHIFT-ALT-DRAG to get past a collision if necessary.  When the button is released, the chain on either end of the selection is then rebuilt to proper bond lengths and angles by rotation on available ''phi'' and ''psi'' bonds.  The required processing can take some time and the menu background color will go from yellow to pink for the duration.  If the action cannot be accommodated, the chain will be restored to its previous state.  (Sometimes Jmol fails to recognize the button up event; in that case simply do another drag away and back.)
-Anchors may be set on either side of the back-bone block with SHIFT-CLICK to restrict the range of ''phi'' and ''psi'' bonds available to accommodate movements.  Anchor atoms are highlighted in RASMOL colors*.  A C-terminal anchor (C-ward) is set by default at the N of the C-terminal residue though it can then be moved or removed if desired.  When a back-bone block is moved, atoms beyond the anchors are then guaranteed not to move as their ''psi'' and ''phi'' bonds are not rotated.  (The N-terminal side of the block beyond any N side anchor (N-ward) may nevertheless see some small movement in certain collision cases. )  Note that some ''psi'' and ''phi'' bonds may be made unavailable regardless of anchor placement by action of the Plico script [[User:Remig/plico|freeze]].
+Anchors may be set on either side of the back-bone block with SHIFT-CLICK to restrict the range of ''phi'' and ''psi'' bonds available to accommodate movements.  Anchor atoms are highlighted in RASMOL colors*.  A C-terminal anchor (C-ward) is set by default at the N of the C-terminal residue though it can then be moved or removed if desired.  When a back-bone block is moved, atoms beyond the anchors are then guaranteed not to move as their ''psi'' and ''phi'' bonds are not rotated.  (The N-terminal side of the block beyond any N side anchor (N-ward) may nevertheless see some small movement in certain collision cases. )  Note that some ''psi'' and ''phi'' bonds may be made unavailable regardless of anchor placement by freezing described above.
 One or two pivot points may be set with ALT-CTRL-CLICK on any atom.  Pivot point atoms are colored green.  When a single pivot point is set, the back-bone selection rotates on the pivot rather than translating.  The rotation is in the XY viewing plane.   When two pivot points are set, the rotation is instead on the axis between them.  If there is no atom at the desired pivot point, a water oxygen may be put there temporarily with the Plico script  [[User:Remig/plico/modify|modify]] to serve as a pivot.
@@ Line 58: / Line 63: @@
 Tug is written as a compromise between performance and robustness.  It makes heavy demands on Jmol resources and Jmol sometimes responds by locking up, requiring the services of the task manager to close it down.  If that happens, you can then restart Jmol and load the file tugsave.pdb to quickly recover.  Regardless movements in Tug are better made in several small steps rather than one large step.  Large movements can better be achieved with other scripts in the Plico suite such as [[User:Remig/plico/turn|turn]] or [[User:Remig/plico/toab|toAlphaBeta]].
-Performance is achieved by only moving the selected block when dragging and only checking for collisions within the atom set between anchors after the chain has been rebuilt.  Collisions of the selected block with atoms outside the atom set between anchors stop movement only if the collision is with a back-bone atom or a side-chain atom that cannot be moved away.  Water molecules are deleted when encountered but may be replaced later by the Plico script Hydrate.
+Performance is achieved by only moving the selected block when dragging and only checking for collisions within the atom set between anchors after the chain has been rebuilt.  Collisions of the selected block with atoms outside the atom set between anchors stop movement only if the collision is with a back-bone atom or a side-chain atom that cannot be moved away.  Water molecules are deleted when encountered but may be replaced later by the Plico script [[User:Remig/plico|hydrate]].
 After the chain is rebuilt, internal collisions are resolved by moving side-chains, deleting water, and counter-rotating back-bone oxygens.  The planar nature of the peptide bond results in the ''phi'' and ''psi'' bond pair on either side of a back-bone oxygen being parallel.  Therefore rotations on both, identical in magnitude but opposite in direction, result in substantial movement of the oxygen away from a collision situation with little consequent movement of the rest of the molecule.  Some movement does nevertheless occur and Tug can sometimes move the entire chain N-ward of the oxygen somewhat despite an N-ward anchor.

@@ Line 3: / Line 3: @@
-'''Tug''' is the central script of the Plico suite described [[User:Remig/plico|here]] and is loaded by many of the other scripts if not already in place.  It allows the user to move or rotate one section of a polypeptide against another by mouse actions.  It also allows the user to move an entire chain to nest against another chain.  The script can be found  [[User:Remig/plico/tug|here]].  Copy and paste it to a text editor and save it as tug.spt in your scripts location.
+'''Tug''' is the central script of the [[User:Remig/plico|Plico]] suite and is loaded by many of the other scripts if not already in place.  It allows the user to move or rotate one section of a polypeptide against another by mouse actions.  It also allows the user to move an entire chain to nest against another chain.  The script can be found [[User:Remig/plico/tug|here]].  Copy and paste it to a text editor and save it as tug.spt in your scripts location.
 It can then be launched by the following macro:
@@ Line 27: / Line 27: @@
 '''Side-chain mode:'''
-When ALT-CLICK is pressed on a side-chain atom beyond the CB atom, a circle is drawn around the atom and subsequent movements are then restricted to the side-chain until ALT-CLICK is pressed again on the same or another atom.  ALT-DRAG then pulls just the side-chain in the direction of mouse movement as allowed by rotation on the ''chi'' bonds of the side-chain with no collisions.  ALT-SHIFT-DRAG does allow collisions should that prove necessary.  Rotation angles are restricted to multiples of 60Â°.  Pulling on the CG atom of proline toggles between its two puckered states.  Note that marking a side chain atom does not cancel back-bone selection.
+When ALT-CLICK is pressed on a side-chain atom beyond the CB atom, a circle is drawn around the atom and subsequent movements are then restricted to the side-chain until ALT-CLICK is pressed again on the same or another atom.  ALT-DRAG then pulls just the side-chain in the direction of mouse movement as allowed by rotation on the ''chi'' bonds of the side-chain with no collisions.  ALT-SHIFT-DRAG does allow collisions should that prove necessary.  Rotation angles are restricted to multiples of 60Â°.  Pulling on the CG atom of proline toggles between its two puckered states.  Note that marking a side chain atom does not cancel an existing back-bone selection.
-When ALT-CLICK is pressed on a back-bone O atom, a circle is drawn around the atom and subsequent movements are then restricted to that atom until ALT-CLICK is pressed again on the same or another atom.  ALT-DRAG then rotates the ''phi'' and ''psi'' bonds on either side of the O in opposite directions to move the O atom with minor movement of the atoms in the N-terminal direction from the O atom.  SHIFT-ALT-DRAG does the same except the minor movement is of the atoms in the C-terminal direction from the O atom.   Note again that marking a back-bone O atom does not cancel back-bone selection.
+When ALT-CLICK is pressed on a back-bone O atom, a circle is drawn around the atom and subsequent movements are then restricted to that atom until ALT-CLICK is pressed again on the same or another atom.  ALT-DRAG then rotates the ''phi'' and ''psi'' bonds on either side of the O in opposite directions to move the O atom with minor movement of the atoms in the N-terminal direction from the O atom.  SHIFT-ALT-DRAG does the same except the minor movement is of the atoms in the C-terminal direction from the O atom.   Note again that marking a back-bone O atom does not cancel an existing back-bone selection.
@@ Line 36: / Line 36: @@
 When ALT-CLICK is pressed on a back-bone atom (or a CB atom), its residue is presented in the RASMOL color scheme* and halos are drawn on its N and C atoms to mark it as available to be moved or rotated by ALT-DRAG.  ALT-CLICK on a back-bone atom of another residue will then highlight all atoms between the two residues inclusive. The entire block will then be available to be moved or rotated by ALT-DRAG or SHIFT-ALT-DRAG.  When performed by pressing the left mouse button down while holding the alt key down and then moving the mouse, just the selected block moves accordingly.  The block stops if it collides with atoms outside the anchor range; this stoppage can be overridden with SHIFT-ALT-DRAG to get past a collision if necessary.  When the button is released, the chain on either end of the selection is then rebuilt to proper bond lengths and angles by rotation on available ''phi'' and ''psi'' bonds.  The required processing can take some time and the menu background color will go from yellow to pink for the duration.  If the action cannot be accommodated, the chain will be restored to its previous state.  (Sometimes Jmol fails to recognize the button up event; in that case simply do another drag away and back.)
-Anchors may be set on either side of the back-bone block with SHIFT-CLICK to restrict the range of ''phi'' and ''psi'' bonds available to accommodate movements.  Anchor atoms are highlighted in RASMOL colors*.  A C-terminal anchor (C-ward) is set by default at the N of the C-terminal residue though it can then be moved or removed if desired.  When a back-bone block is moved, atoms beyond the anchors are then guaranteed not to move as their ''psi'' and ''phi'' bonds are not rotated.  (The N-terminal side of the block beyond any N side anchor (N-ward) may nevertheless see some small movement in certain collision cases. )  Note that some ''psi'' and ''phi'' bonds may be made unavailable regardless of anchor placement by action of the Plico Freeze script.
+Anchors may be set on either side of the back-bone block with SHIFT-CLICK to restrict the range of ''phi'' and ''psi'' bonds available to accommodate movements.  Anchor atoms are highlighted in RASMOL colors*.  A C-terminal anchor (C-ward) is set by default at the N of the C-terminal residue though it can then be moved or removed if desired.  When a back-bone block is moved, atoms beyond the anchors are then guaranteed not to move as their ''psi'' and ''phi'' bonds are not rotated.  (The N-terminal side of the block beyond any N side anchor (N-ward) may nevertheless see some small movement in certain collision cases. )  Note that some ''psi'' and ''phi'' bonds may be made unavailable regardless of anchor placement by action of the Plico script [[User:Remig/plico|freeze]].
-One or two pivot points may be set with ALT-CTRL-CLICK on any atom.  Pivot point atoms are colored green.  When a single pivot point is set, the back-bone selection rotates on the pivot rather than translating.  The rotation is in the XY viewing plane.   When two pivot points are set, the rotation is instead on the axis between them.
+One or two pivot points may be set with ALT-CTRL-CLICK on any atom.  Pivot point atoms are colored green.  When a single pivot point is set, the back-bone selection rotates on the pivot rather than translating.  The rotation is in the XY viewing plane.   When two pivot points are set, the rotation is instead on the axis between them.  If there is no atom at the desired pivot point, a water oxygen may be put there temporarily with the Plico script  [[User:Remig/plico/modify|modify]] to serve as a pivot.
-A single atom may be set as a target with ALT-SHIFT-CLICK.  A cross will appear on the atom when so selected (and will disappear if ALT-SHIFT-CLICK is done on the same atom.)  When a target atom is selected, mouse drag movements, including rotations, then move towards or away from the target atom.  Otherwise movements are in the XY viewing plane.
+A single atom may be set as a target with ALT-SHIFT-CLICK.  A cross will appear on the atom when so selected (and will disappear if ALT-SHIFT-CLICK is done on the same atom.)  When a target atom is selected, mouse drag movements, including rotations, then move towards or away from the target atom.  Otherwise movements are in the XY viewing plane.  If there is no atom at the desired target point, a water oxygen may be put there temporarily with the Plico script [[User:Remig/plico/modify|modify]] to serve as a target.
 When DOUBLE-CLICK is performed anywhere, a prompt is presented allowing you to exit Tug keeping your changes if any, to cancel and go back to Tug,  or to undo the entire Tug session and restore the polypeptide from the file, tugsave.pdb, created when Tug was first entered.
@@ Line 51: / Line 51: @@
 The result of this behavior is that, when one chain is dragged towards another, it will not stop until three points of contact are made, a full nesting.
-You may get to Full Chain Mode from Anchor mode by SHIFT-CLICKing on a block back-bone atom.
+You may get to Full Chain Mode from Anchor mode by SHIFT-CLICKing on any back-bone atom within the highlighted block.
 '''Performance:'''
-Tug is written as a compromise between performance and robustness.  It makes heavy demands on Jmol resources and Jmol sometimes responds by locking up, requiring the services of the task manager to close it down.  If that happens, you can then restart Jmol and load the file tugsave.pdb to quickly recover.  Regardless movements in Tug are better made in several small steps rather than one large step.  Large movements can better be achieved with other scripts in the Plico suite such as Turn, ToAlpha, and ToBeta.
+Tug is written as a compromise between performance and robustness.  It makes heavy demands on Jmol resources and Jmol sometimes responds by locking up, requiring the services of the task manager to close it down.  If that happens, you can then restart Jmol and load the file tugsave.pdb to quickly recover.  Regardless movements in Tug are better made in several small steps rather than one large step.  Large movements can better be achieved with other scripts in the Plico suite such as [[User:Remig/plico/turn|turn]] or [[User:Remig/plico/toab|toAlphaBeta]].
 Performance is achieved by only moving the selected block when dragging and only checking for collisions within the atom set between anchors after the chain has been rebuilt.  Collisions of the selected block with atoms outside the atom set between anchors stop movement only if the collision is with a back-bone atom or a side-chain atom that cannot be moved away.  Water molecules are deleted when encountered but may be replaced later by the Plico script Hydrate.
-After the chain is rebuilt, internal collisions are resolved by moving side-chains, deleting water, and counter-rotating back-bone oxygens.  The planar nature of the peptide bond results in the ''phi'' and ''psi'' bond pair on either side of a back-bone oxygen being parallel.  Therefore rotations on both, identical in magnitude but opposite in direction, result in substantial movement of the oxygen away from a collision situation without much consequent movement of the rest of the molecule.  Some movement does nevertheless occur and Tug can sometimes move the entire chain N-ward of the oxygen somewhat despite an N-ward anchor.
+After the chain is rebuilt, internal collisions are resolved by moving side-chains, deleting water, and counter-rotating back-bone oxygens.  The planar nature of the peptide bond results in the ''phi'' and ''psi'' bond pair on either side of a back-bone oxygen being parallel.  Therefore rotations on both, identical in magnitude but opposite in direction, result in substantial movement of the oxygen away from a collision situation with little consequent movement of the rest of the molecule.  Some movement does nevertheless occur and Tug can sometimes move the entire chain N-ward of the oxygen somewhat despite an N-ward anchor.
 If collisions cannot be resolved, Tug restores the previous state.  Also when exiting Tug, you are given the option to undo the entire session.
 * If the default color scheme is RASMOL then the JMOL colors are used for highlighting.