Tables of Commands
Model View
|
matr |
[1,2,3 or abc] or [abc a1b1c1] or [x11 x12 x13 y11 y12 y13 z11 z12 z13] |
Orients the model along a (1 or 100), b (2 or 010), c (3 or 001) or any other crystallographic direction, like 123, which sets current normal along (1*a+2*b+3*c) vector. Two crystallographic directions (from and to) may be specified align current view normal along the (to-from) vector. Also a full Cartesian matrix can be specified. If the directions are signed or consist of multiple digits all components should be of the same length like in 120101 or -1+1+1 (same as -10101). If no arguments given, prints current Cartesian orientation matrix. Examples:
|
|
rota |
[axis angle] or [x y z angle increment] |
Changes current view by rotating around given axis (x, y or z) when two arguments are provided and makes a continuous rotation around give axis when 5 arguments are provided. Note that X axis is aligned horizontally, Y - vertically and Z is out of the screen plane. Examples:
|
|
direction |
|
The command prints current normal in crystallographic coordinates and tries to match it to a crystallographic direction. |
|
mpln |
[atoms]] [-n] [-r] |
Finds the best plane through the current selection or given atoms, or out of all visible atoms if none are given.
|
|
Changing scale/zoom |
|
To get current value of the scene zoom use:
To set current zoom to a certain value use:
this can be used to put different structures to the same scale. Note that the value 1 corresponds to the scale when the smallest dimension of the screen view is 1 A
|
The model can be rotated using by moving the mouse pointer while holding the left mouse button down (also Shift+arrow keys); rotated around Z by pressing the Ctrl key down while rotating; zoomed using the right mouse button (also Shift+Home/End or Alt key+left mouse button); shifted in the viewing plane by pressing Ctrl+Shift and holding the right mouse button down. The default mouse behaviour can be overridden in some modes (look at mode split) also some objects, like cell basis or text boxes can override some mouse operations (like zooming on the cell basis) or extend it (moving the basis while holding Shift key down).
Keyboard Shortcuts
Ctrl+Q |
ShowQ |
Toggles between three states:
|
Ctrl+H |
ShowH |
Toggles between three states:
|
Ctrl+T |
ShowStr |
Toggles between three states:
|
Ctrl+I |
sel -i |
Inverts the current selection. |
Ctrl+A |
sel -a |
Selects all atoms currently visible, however if labels are active (i.e. one or more label is selected) then this selects all labels. |
Ctrl+U |
sel -u |
Deselects all of current selection. |
Ctrl+G |
mode grow |
Enters mode grow. See also symmetry operations. |
Ctrl+O |
reap |
Brings up the Open File dialogue. |
|
F2 |
swapbg |
Swaps the background between white and coloured. |
|
F3 |
labels |
Toggles labels on/off. |
|
F4 |
grad -i |
Toggles gradient background on/off. |
|
F5 |
|
Go to the work menu. |
|
F6 |
|
Go to the view menu. |
|
F7 |
|
Go to the tools menu. |
|
F8 |
|
Go to the info menu. |
|
F11 |
Fullscreen(true/false) |
Toggles full screen mode on/off. |
|
Shift+F11 |
HtmlPanelVisible |
Toggles html panel on/off. |
|
Esc |
|
Exits current mode (some modes, like mode match, can override this), clears current selection and text in the command line |
|
Break |
|
Interrupts the solution/refinement after the current cycle. |
|
Del (Ctrl+Backspace on Mac) |
kill |
Deletes selected object |
Fixed/Refined Parameters
|
fix |
{occu, xyz, Uiso} [atoms] |
Fixes the specified refinement parameter, ie these parameters will not be refined in subsequent refinement cycles.
Examples:
|
||
|
free |
{occu, xyz, Uiso} [atoms] |
The opposite of fix - makes the specified parameters for the given atoms refineable. Feeing the occupancy is also available from the context menu. |
||
|
mode |
fixu |
Fixes Uiso or ADP for subsequently clicked atoms. |
||
|
mode |
fixxyz |
Fixes coordinates for subsequently clicked atoms. |
||
|
mode |
occu occupancy_to_set |
Sets atoms occupancy to the povided value for subsequently clicked atoms. |
||
|
labels -f show currently fixed atomic parameters, labels -f -r show labels for fixed atoms and also the number at which the occupancy of riding atoms is fixed |
||||
Symmetry Operations
Symmetry Operations |
||
|
|
||
|
lstsymm |
|
Prints symmetry operations and their codes for current structure. |
|
envi |
[r=2.7 Å] A1 or one selected atom [-h] [-q] Note: if more than one atom is selected the first one is used |
Prints a list of those atoms within a sphere of radius r around the specified atom.
|
|
mode |
grow [-s] [-v] [-b] [-shells] |
Displays the directions in which the molecule can be grown
|
|
mode |
pack |
Displays the position of symmetry equivalent asymmetric units as tetrahedra. These asymmetric units can be generated by clicking on the corresponding tetrahedron. |
|
sgen |
atoms The Symmetry operation is represented as 1_555, 1555 or -1+X,Y,Z and atoms as a selection or a names list |
Generates symmetry equivalents of the provided (or all atoms, if there is no selection) using the provided symmetry operation. Note: For symmetry operations starting with '-' and letter, a leading zero must be added, for example, 0-x,-y,-z, otherwise Olex2 confuses this with an option. |
|
pack |
a_from a_to b_from b_to c_from c_to [atoms] |
Packs all or specified atoms within given dimensions
Example: pack $O will pack all O atoms with the default of -1.5 to 1.5 cells range. |
|
pack |
from to |
Equivalent to 'pack from to from to from to', like 'pack 0 1' is expanded to 'pack 0 1 0 1 0 1' |
|
pack |
cell |
Shows content of the unit cell. In conjunction with 'grow -w' allows the creation of views where all asymmetric units contributing to the unit cell are shown. |
|
pack |
r |
Packs fragments within radius r of the selected atom(s) or the centre of gravity of the asymmetric unit. |
|
grow |
[atoms] [-w] |
Grows all possible/given atoms; for polymeric structures or structures that require to be grown several times Olex2 will continue grow until the operation results in a symmetry element that has been used previously.
Example: If the main molecule is grown, but only one solvent molecule is shown, using 'grow -w' will produce other solvent molecules using symmetry operators used to grow the main molecule |
|
If some atoms are deleted after growing operations, Olex2 will use existing unique atoms as the asymmetric unit atoms; this can be helpful to avoid a sequence of sgen/kill commands. labels -l -i: Adds labels only to the 'original' - i.e. not created by symmetry - molecule. In a packed structure: Right-click on a bond > Graphics > Select the Groups(s): Will select all bonds (or atoms) of that type in the grown structure. |
||
Constraints/Restraints
Disorder Modelling: Constraints and Restraints |
||
|
EXYZ |
atom types (to add for the selected atom) |
Makes the selected site shared by atoms of several atom types.
|
|
EADP |
atoms |
Makes the ADP of the specified atoms equivalent. |
|
SADI |
atoms or bonds [esd=0.02]
|
For selected bonds or atom pairs SADI makes the distances specified by selecting bonds or atom pairs similar within the esd. If only one atom is selected it is considered to belong to a regular molecule (like PF6) and adds similarity restraints for P-F and F-F distances. For three selected atoms (A1,A2,A3) it creates similarity restraint for A1-A2 and A2-A3 distances. |
|
DFIX |
d atom pairs or pairwise selection in order [esd=0.02] |
For selected bonds or atom pairs DFIX will generate length fixing restraint with the given esd. If only one atom is selected, all outgoing bonds of that atom will be fixed to the given length with provided esd. For three selected atoms (A1,A2,A3) the A1-A2 and A2-A3 restraints will be generated. |
|
DANG |
d atom pairs or pairwise selection in order [esd=0.04] |
For selected bonds or atom pairs, distance restraints similar to dfix will be generated. |
|
tria |
d1 d2 angle [esd=0.02] |
For given set of bond pairs sharing an atom or atom triplets generates two dfix commands and one dang command. Example: tria 1 1 180 C1 C2 C3 will generate 'DFIX 1 0.02 C1 C2 C2 C3' and 'DANG 2 0.04 C1 C3' it will calculate the distance for dang from d1 d2 and the angle. |
|
FLAT |
[atoms][esd=0.1] |
Restrains given fragment to be flat (can be used on the grown structure) within given esd. |
|
CHIV |
[atoms][val=0] [esd=0.1] |
Restrains the chiral volume of the provided group to be val within given esd |
|
SIMU |
[d=1.7] [esd12=0.04] [esd13=0.08] |
Restrains the ADPs of all 1,2 and 1,3 pairs within the given atoms to be similar with the given esd. |
|
DELU |
[esd12=0.01] [esd13=0.01] |
'rigid bond' restraint |
|
ISOR |
[esd=0.1] [esd_terminal=0.2] |
Restrains the ADP of the given atom(s) to be approximately isotropic |
|
SAME |
N |
Splits the selected atoms into the N groups and applies the SAME restraint to them. Olex2 will manage the order of atoms within the ins file, however mixing rigid group constraints and the 'same' instructions might lead to an erroneous instruction file. |
|
showp |
[any]; space separated part number(s) |
Shows only the parts requested: showp 0 1 will show parts 0 and 1, showp 0 just part 0. showp by itself will display all parts. |
|
split |
[-r={eadp, isor, simu}] |
Splits selected atom(s) along the longest ADP axis into two groups and links their occupancy through a free variable.
|
|
AFIX |
shelx afix number{mn} |
If no are atoms provided and afix corresponds to a fitted group where n is 6 or 9 (such as 106 or 79), all the rings which satisfy the given afix will be automatically made rigid (this is useful in the case of many PPh3 fragments); alternatively a single ring atom can be selected to make that ring rigid. In other cases, depending on afix either 5,6 or 10 atoms will be expected. Special cases of afix 0, 1 and 2 can be used to remove afix, fix all parameters or leave just the coordinates refinable, all other afix instructions will consider the first atom as a pivot atom and the rest - dependent atom.
|
|
part |
[part=new_part] [atoms] |
Changes part number for given/selected atom;
|
|
fvar |
[value] [atoms] |
This command links two or more atoms through a free variable.
|
|
sump |
[val=1] [esd=0.01] |
Creates a new linear equation. If any of the selected atoms has refinable or fixed occupancy, a new variable is added with value 1/(number of given atoms), otherwise already used variable is used with weight of 1.0. Example: If 3 atoms (A1, A2, A3) are selected this command will generate three free variables and insert the r2 1.0 var 3 instruction (equivalent to 1.0 = 1.0*occu(A1) + 1.0*occu(A2) + 1.0*occu(A3). |
|
mode |
split [-r={eadp, isor, simu}] |
Splits subsequently clicked atoms into parts, or in combination with the Shift key can be used to drag an atom to change its position. While in the mode the newly generated atoms can be selected and moved as a group with Shift down or rotated when dragging the selection. The original and generated atoms will be placed into different parts.
|
Selection Syntax
|
sel |
sel atoms where xatom.bai.mw > 20 |
Will select all atoms where the atomic mass is larger than 20 |
|
sel |
Symmetry operation (represented by 1_555 or 1555) |
Will select all currently shown symmetry generated atoms which were generated by the symmetry operation given. |
|
sel |
sel rings NC5 |
Will select all NC5 rings in the structure |
|
sel |
sel part 1 |
Will select part 1 of the structure |
HKL File Operations
|
hklstat |
|
Prints detailed information about reflections used in the refinement. |
|
omit
|
h k l
|
Inserts 'OMIT h k l' instruction in the ins file |
|
omit |
val |
Inserts 'OMIT h k l' for all reflections with . |
|
omit |
s 2theta |
Inserts 'OMIT s 2theta' instruction in the ins file |
|
edithkl |
[h k l] |
Brings up a dialogue, where 'bad' reflections from the Shelx lst file and all its constituent symmetry equivalents can be inspected and flagged to be excluded from the refinement. In constrast to the OMIT h k l instruction, which excludes the reflection and all it equivalents, this dialogue allows to exclude those equivalents that are actually outliers. If a particular reflection is specified, this particular reflection and all its constituent equivalents can be viewed. |
|
excludehkl |
-h=h1;h2;.. -k=k1;k2.. -l=l1;l2.. [-c] |
This function provides a mechanism to reversibly exclude some reflections from refinement (these reflections will be moved to the end of the hkl file so they appear after the 0 0 0 reflection).
|
|
appendhkl |
-h=h1;h2;.. -k=k1;k2.. -l=l1;l2.. |
Acts in the opposite way to excludehkl |
|
For more advanced HKL processing, a Python script may be used. A sample hklf5.py script is provided in {Olex2 folder}/etc/scripts. The script can be copied and modified to accommodate any particular twinning law and run inside Olex2. The script allows creating an HKLF 5 file where reflections which belong to different twin components are assigned different batch numbers. To run a python script in Olex2 use the following command to load the script: >>@py -l This command shows a 'File Open' dialog, a python script can be selected. After loading the script can be modified and executed by pressing OK. |
||
Customising the GUI
|
|
||
|
setfont |
{Default, Picture_labels} {choosefont(), font detail} |
Brings up the dialog to choose font for the Console or Labels which end up on the picture. The built-in function choosefont([olex2]) to choose a system font (or specially prepared/portable font) can be used to specify the font. Example setfont Default choosefont() setfont Default choosefont(getfont(default)) This will bring up the choice of font to change to along with the current font. |
|
EditMaterial |
{helpcmd, helptxt, execout, error, exception, any object name available with lstgo} |
Brings up a dialog to change properties of the specified text section or graphical object.
This command can be used to edit properties of any objects printed by 'lstgo' macro. An example of that could be editing material of the console text: Example EditMaterial Console Note: The object name is case sensitive. |
|
save |
{scene, style, view, model} [file_name] |
If the file name is not provided, the 'Save as...' dialog will be shown which allows to save current settings to file. The scene save current font names/sizes as well as the materials for the specific console output, like external programs output, error and exception reporting. |
|
load |
{scene, style, view model} [file_name] |
Load one of the previously saved items. If no file name is provided, the 'Open file...' dialog will appear, otherwise if just a file name is provided (the extension will be guessed by Olex2), for styles and scene the last used folders will be used by default, whereas the current folder will be used for the views and models. |
|
grad |
[C1 C2 C3 C4] |
Choose the colour of the four corners of the graduated background.
|
|
brad |
r [hbonds] |
Adjust the bond radii in the display. If the 'hbonds' is provided the second argument, the given radius is applied to all hydrogen bonds. |
|
ads |
{elp, sph, ort, std} |
A function for drawing styles development. Changes atom draw style for all/selected atoms.
|
|
arad |
{sfil, pers, isot, isoth, bond, vdw} |
A function for drawing styles development; applies different radii to all/selected atoms.
|
|
azoom |
% [atoms] |
Changes the radii of all/given atoms, the change is given in percents. |
Tables, Reports and Images
|
pictPS |
filename.ps |
Generates a post-script file of what is visible in the molecule display.
The bond width is taken from the display. This can be changed with brad
|
|
pict |
filename.ext [n=2] |
Generates a bitmap image of what is visible on the molecule display. n Refers to the size of the output image. If n is smaller than 10, it refers to a multiple of the current display size, if it is larger than 100, it refers to the width of the image in pixels.
|
|
picta |
filename.ext [n=1] |
A portable version of pict with limited resolution (see explanation for n above), which is OS and graphics card dependent. This may not be stable on some graphics cards
|
|
picts |
filename.ext [n=1] |
Creates a 'stereo' picture with two views taken with the +/- a option value rotation around y axis and placed onto one picture separated by s % of a single projection width.
|
|
label |
label [atoms] |
Adds labels to all/given/selected atoms and bonds. These labels can be moved by pressing the SHIFT key while holding down the left mouse button and edited by double clicking on them.
|
Structure Analysis
|
There are various tools available for the analysis of structures. |
||
|
htab |
[minimal angle=150°] [maximum bond length 2.9 Å] |
Searches and adds found hydrogen bonds (like HTAB and RTAB in Shelx) into the list for the refinement program to add to the CIF. Equivalent symmetry positions are automatically inserted and merged with the existing ones. The command can be executed several times with different parameter values, only one unique instructions will be added.
|
|
pipi |
[centroid-to-centroid distance 4 Å] |
The command analyses the p-p interactions (only stacking interactions for now) for flat regular C6 or NC5 rings and prints information for the ones where the intercentroid distance is smaller than [4] Å and the intercentroid shift is smaller than [3] Å.
|
|
calcvoid |
[radii file name] |
Calculates and displays the structure map. Also calculates the largest channels along crystallographic directions and the packing index.
Note: |
|
molinfo |
[radii file name] |
Calculates molecular volume and the surface area for all/selected atoms.
Generation 5 for octahedron approximate sphere by 8192 triangles, for tetrahedron by 4096 triangles, each generation up increases the number of triangles by factor of 4, generation down - decreases it by the same factor. |
|
calcfourier |
{-calc,- diff, -obs, -tomc} |
Calculates Fourier for current model
|
|
calcpatt |
|
Calculates and displays Patterson map |
|
match |
[atoms] |
This procedure find relation between the connectivity graphs of molecular fragments of loaded structure and aligns the fragments. If no arguments are given, the procedure analyses all fragments and in the case fragments with matching connectivity found, aligns1 them and prints corresponding root mean square distance (RMSD) in angstroms. If two atoms are provided (explicitly by name or through the selection) the graph relation information - orientation matrix and the matching atoms is printed, use -a option to align the fragments.
See the 'How to...?' section for more information. |
|
Notes etc about Structure Analysis |
||
Atom Connectivity Table Manipulation
|
conn |
n [r] atoms |
Sets the maximum number of bonds for the specified atoms to n and changes the default bond radius for the given atom type to r. Examples:
|
|
compaq |
[-a] [-c] [-q] |
Moves all atoms or fragments of the asymmetric unit as close to each other as possible. If no options are provided, all fragments are assembled around the largest one.
|
|
addbond |
A1 A2 or atoms |
Adds a bond to the connectivity list for the specified atoms. This operation will also be successful if symmetry equivalent atoms are specified. |
|
delbond |
A1 A2 or Selected bond(s) |
Removes selected bonds from the connectivity list. |
|
sort |
[m] [l] [p] [h] atoms |
The sorting of atoms in the atom list is very powerful, but also quite complex .
Usage: sort [+atom_sort_type] TBA sort [Atoms] [moiety [+moiety_sort_type] [moiety_atoms]] If just 'moiety' is provided - the atoms will be split into the moieties without sorting. Examples:
|
|
name |
[selection/atom names] |
The command allows changing the atom names.
|
|
FixHL |
|
Updates H-atom labels according to the labels of the bearing atoms |
|
Olex2 will display the altered connectivity table in the case if structure is grown or packed |
||
