< Index >

Molecular Control

The Molecular Control gives a hierarchical overview of the loaded molecules and provides means to interact with the molecular entities.



Every molecule is part of a System, molecules from different Systems do not interfere with each other, e.g. in MD-Simulations. BALLView creates a new System for every molecular file, that the user loads.

Highlighting

By clicking with the left mouse button on the names of molecular entities, users can highlight these. To highlight more then one item, use the Shift- or Control-modifier. A click with the right mouse button will open a context menu, which will operate on the highlighted molecular items:

Selections (or how to find an atom)

Left from the names of the molecular entities are checkboxes, which show the user which molecular entities are currently selected (picked). The selected objects become colored in the Scene. This can be used to find an atom in the three-dimensional structure of its molecule. If a user starts a MD-Simulation or a Energy Minimization while some molecular entities are selected, BALLView only operates on these items. (Which is e.g. usefull for optimising the position of only the hydrogen atoms of a protein from a PDB-file.)

Cut, Copy, Paste

The user can cut or copy any molecular entities in the Molecular Control and also paste them into other objects (see the Menu point "Edit").
This makes it possible e.g. to merge Systems:
  1. Load two molecular files (e.g. PDB files)
  2. Highlight the molecules of the first System (they should become blue like in the picture above)
  3. Click on the menu entry "Cut" in "Edit"
  4. Highlight the second System
  5. Click on the menu entry "Paste" in "Edit"
  6. The first System can now be deleted

Regular expressions

At the bottom of the Molecular Control resides a yellow text field. In this text field, the user can enter regular expressions to select molecular entities. To apply the typed expression, the Return key has to be pressed. The button next to the text field clears the current selection. Possible predicates are:

true() this is always true
false() this is always false
selected() this is true for already selected atoms
name(string) the name of atoms
type(string) type name of atoms
element(char) element (abbreviated by its symbol)
residue(string) name of residues
residueID(int) PDB ID of the residue (usally a number)
protein(string) name of proteins
secondaryStruct(string) name of secondary structures
chain(string) name of chains
nucleotide(string) name of nucleotides
solvent() true if the atom is a solvent atom added by BALL
backbone() true for backbone atoms
inRing() true if in a circular entity
doubleBonds() atoms with double bonds
tripleBonds() atoms with triple bonds
numberOfBonds(int) atoms with a given number of bonds
aromaticBonds() atoms with aromatic bonds
connectedTo(char) atoms which are connected to an atom of given element
spHybridized()
sp2Hybridized()
sp3Hybridized()
charge(float) atoms with given charge
isAxial()
is4C1()

All predicates can be connected with AND and OR, grouped with brackets, and each predicate can be negated with '!'
Example: !residueID(12) AND (element(N) OR element(C))

Properties of Molecular Entities

To view and modify the properties of molecular entities, BALLView offers a special dialog, which can be opened in the context menu of the MolecularControl under the point "Properties". In this dialog the user can e.g. set the name of a Chain or change the charge of atoms. (An other fast way to obtain the basic informations for an atom, is to select(pick) exactly one atoms. The informations like charge and position are then shown in the LogView.)



An other dialog enables the user to obtain all informations of any bond. To open this dialog, one atom has to be highlighted and the context menu entry "Show Bonds" has to be clicked. In this dialog, the user can read the bonds order and type. The arrow buttons in the dialog enable the user to identify the partner atoms in the bond.

Distances and angles between atoms

When exactly two atoms are selected(picked) the distance between them is shown in the LogView. For three selected atoms, the angle between them is shown, and for four atoms the torsion angle.

Count atoms and bonds

The context menu also has an entry to count the bonds and atoms of the currently selected molecular entity (e.g. a Residue).

Move molecular entities

To move e.g. a Chain or single atoms, the user can highlight them and switch to a special move mode with the context menu entry "Move". The mouse cursor changes to indicate the new mode. In this mode the mouse can be used to move and rotate all selected items. This works the same way as the normal rotation and translation of the viewpoint. To switch back to the rotation mode, the user can press either the Escape key or click on the menu entry "Display->Rotate Mode" .

Selection and Highlighting

The selection and the higlighting can be converted into each other by using the context menu. To select highlighted items use "Select", selected items can become highlighted by pressing "Highlight Selection". This is e.g usefull for creating a Representation for picked molecular items or for finding a picked atom in the hierarchical overview in the MolecularControl (the parent entries of the selected objects will be opened).

< Index >