List of Symbols
Mouse left click
Mouse right click
Mouse middle click
Drag the mouse while holding a button
Alt key
Control key
Shift key
Directional arrow keys
1. Open a molecule file
Open DialogVideoVideo (Youtube)

To open an SDF file either launch the application and use the open dialog to select the molecule file or drag and drop your file on the application icon.

Multiple SDF files can be opened at the same time.

A dialog requests you to choose the property to use to cluster (grouping) the molecules into groups:

  • By default it is “Cluster”.
  • Press escape or cancel in the dialog if this default is ok for you.
  • You can create a new property for the grouping and also copy values from another property to start with.

2. Move around the display
Translate the ViewKeyboard shortcutsZoom/UnzoomView DropdownVideoVideo (Youtube)

Hold down the mouse right button and drag to translate the view.
  • Use the W(up), S(down), A(left), D(right) keys.
  • The Arrow Keys move too the view if no molecule is currently selected.

The mouse wheel zoom/unzoom the view

  • Zooming is always towards the mouse cursor position.
  • Use the ‘R’ key to fully zoom on the mouse cursor.
  • Press ‘T’ to fully unzoom.
  • E’ will zoom on the group under the mouse.
Use the view dropdown to center the view on a specific group.

3. Display the whole dataset on a minimap
DescriptionVideoVideo (Youtube)
The minimap makes large dataset navigation easier.

  • It is activated by the Minimap button.
  • The white rectangle on the minimap represents the current viewing area.
  • The blinking dot represents the centre of the screen.
  • on the minimap will centre the view on the mouse cursor position.
  • Pressing and over the minimap will make the current view follow the cursor position on the minimap.

4. Select the current molecule
DescriptionVideoVideo (Youtube)
  • When over a molecule, click on to make it current.
  • It will appear in a small window in the top-right side of the screen.
  • At the same time the molecule is highlighted by a moving light to show its position in the working area.
  • At high zoom level the moving light is replaced by a less distracting square.
  • A on the molecule in the zoomed window will center the view on it.

5. Move molecules across different groups
DescriptionVideoVideo (Youtube)
  • To move a molecule from one group to another one, on it and it over the desired group. Then release the button.
  • When several molecules are selected and you move one of them to a different group, all the selected molecules will follow.
  • To include all the molecules from a group to another, hold the and on the group handle. Then it over the group you want to add the molecules. Release the button to finish the action.

6. Change the name of a group of molecules
DescriptionVideoVideo (Youtube)
  • Double on the group title. A dialog appears to type the new name.
  • To mark a group as already processed, Double on its title. The color of the group turns green on the main view and in the minimap.

7. Select multiple molecules at once
DescriptionShortcutsVideoVideo (Youtube)
  • To select multiple molecules press the lasso button lasso_button_eyemol .
  • Then go over the molecules to be selected and while pressing the , surround them with the lasso.
  • The background of the selected molecules will turn green.
  • Release the button to finish the action.
  • Press add_more_eyemol to add more molecules to the current selection.
  • Press clear_eyemol to clear the selection.

Instead of using the toolbar buttons you can:

  • Hold the and while pressing the , draw a lasso to select a set of molecules.
  • Hold and and while pressing the , draw a lasso to add molecules to the current selection.
  • Hold and while pressing the , draw a lasso on the background of the main view to clear the selection.
  • Hold and on a group handle to select its content.
  • Press + ‘A’ to select all the molecules currently visible on the screen.

8. Store separately multiple selections of molecules
DescriptionVideoVideo (Youtube)
  • 4 Different selections can be kept separately. By default the first selection is active.
  • To activate another selection use the “selection” menu or the shortcuts + 1,2,3,4.
  • To differentiate the selections, each one has a specific color.
  • You can activate the four selections at once by pressing + 5.
9. Search for a substructure motif
DescriptionExtra featuresSome hintsVideoVideo (Youtube)

To perform a substructure search do as follows:

  • Zoom very close on a molecule containing the substructure to search for.
  • Use the selection lasso (see simple selections) to define the search substructure. The selected atoms become orange on the screen.
  • Once the atom selection is complete press find_fragment , the “find fragment” button.
  • The molecules containing the fragment become selected.
  • To extract the selected molecules into a new group press the “group selected objects” button group_selected_objects .
  • To align the searched fragment to the reference molecule press “align fragmentalign_fragment instead of “find fragment“.
  • The scope of the search by default is bounded to the group of the searching molecule. To search the whole dataset press the “search all groups” button search_all_groups and press the “find fragment” button find_fragment.
  • If during the selection process the lasso crosses the boundaries of the molecule frame, the atom selection process is canceled and the selection mode switches to molecule selection.
  • By default, the search is performed without the chirality of the selected atoms. To take into account the chirality, toggle the “use chirality” button CHIRALITY.

10. Cluster a dataset by structural similarity
DescriptionVideoVideo (Youtube)

To perform a clustering based on structural similarity do as follows:

  • Select in the menu “Object -> Group by similarity” or press%.
  • A dialog appears requesting to enter a cluster similarity threshold.
  • Press enter to start the clustering. Please note that this action may take long depending on the number of molecules to cluster. A progression bar shows the percentage of time to completion.
  • Following the clustering, a new property called “similarity” is added to each molecule, numbering the newly created groups.
  • At the end of the clustering the view shows the molecules organized by similarity into groups.
  • To select the 10 structurally closest molecules to a reference molecule, move the mouse cursor over it and press J.

11. Sub-cluster a single group by structural similarity
DescriptionVideoVideo (Youtube)

To perform a structural similarity clustering on the molecules of a single group do as follows:

  • Move the cursor over a group and to open the context menu.
  • Select the option “Subgroup by similarity“.
  • Enter a similarity threshold in the dialog box.
  • A supercluster is created that contains all the similarity groups. The “Subgroup by similarity” can be repeated with various thresholds until a good clustering is obtained.
12. Display molecule properties
DescriptionVideoVideo (Youtube)

To display the molecule properties contained in the SDF file do as follows:

  • Toggle the “display object properties” button i or press ‘I’.
  • The list of properties is displayed for the molecule currently under the mouse cursor.

To display one of the molecule properties inside its frame, select the property in the “Display” dropdown menu:

  • If the selected display property is not defined for a given molecule, its background appears in gray.

13. Search for a text in the dataset
DescriptionExtra featuresVideoVideo (Youtube)

SEARCH_INPUT_WINDOW

To perform a text search in the whole dataset:

  • Press + ‘F‘ to go to the Search input field.
  • Select the property to be scanned from the dropdown menu.
  • Type the text to search and then press enter.
  • The first molecule found becomes current and is displayed in the zoomed window.
  • If there are more than one result to your query, use the green arrows SEARCH_ARROWS to navigate along the molecules.

SEARCH_INPUT_WINDOW

To select the result of the query check the “Select” checkbox before performing the search.

To add the current selection to the following search result use the “Select” and the “Append” checkboxes.

Complex text searches can be performed using regular expressions. To do so check the “RegEx” checkbox.

14. Cluster the dataset based on molecule properties
DescriptionVideoVideo (Youtube)

To cluster the molecules by a property, select the property of your choice in the “Organize by:” dropdown menu. The molecules change group but keep the color of their original group, the one selected in the open file dialog box (see 1. Open a Molecule file.)

If the clustering property is numerical (like molecular weight), every group will likely contain only a single molecule. To merge a range of numerical values inside a single group enter a binning value in the “Bins:” input field and press enter.

Enter 0 as a binning value in the “Bins:” input field and press enter to revert to a numerical clustering based on unique property values.

To go back to the initial clustering property press the home button home .

 

capture

15. Create groups and super-groups of molecules
DescriptionVideoVideo (Youtube)

To create a new group:

  • Press the button create_new_group or use the shortcut ‘!
  • Enter the name of the new group in the dialog box. If the name already exists, a number is automatically added at the end of the name to avoid ambiguity.

The new group is placed at the mouse cursor position if you use the keyboard shortcut. Otherwise it is placed at one of the edges of the working area.

To create a super-group, a group containing other groups:

  • Press the new_supergroupnew supergroup” button or use the ‘§’ shortcut.
  • Enter the name of the new group in the dialog box. If the name already exists, a number is automatically added at the end of the name to avoid ambiguity.

To move a group into a supergroup:

  • Hold the key and on the group to drag it onto the super-group.

To visually compact all the super-groups use the menu “Groups -> compact group“.

To visually compact a single super-group, press the shortcut key ‘C‘ while the cursor is on the super-group.

The “Tree view” button tree_view opens a hierarchical display of the groups. Double on any group name to center the view on it.

tree-view

16. Sort molecules in a group
DescriptionVideoVideo (Youtube)

Molecules can be sorted by property inside the groups. To sort Molecules:

  • Use the “Sort:” dropdown menu sort.
  • Select the property to use for sorting in the dropdown list.
  • The arrow button next to the “Sort:” dropdown changes the sort order when pressed.

17. Reorganize the groups on the screen
DescriptionVideoVideo (Youtube)

Press the “reorganize groups” button reorganize_groups or press ‘v‘ to tidy up the screen and the position of the groups. The reorganization is purely visual to minimize the space occupied by the groups on the screen.

capture_reorganize

 

Alternatively, groups can also be sorted by various properties using the “Groups” menu:

18. Navigate from molecule to molecule within a group
DescriptionVideoVideo (Youtube)

To quickly navigate from molecule to molecule within a group do as follows:

  • on a molecule to start the navigation. This makes it the current molecule and displays it in the zoomed window.
  • Zoom in with the mouse wheel until your feel comfortable to appraise it.
  • Then use the right arrow to move to the next molecule. The view is centered on it and it becomes the current molecule.
  • Use the left arrow if you want to return to the previous molecule.
  • The up and down arrows move the focus to the molecule displayed respectively one row up or down.

19. Navigate the dataset from group to group
DescriptionVideoVideo (Youtube)

To quickly navigate from group to group do as follows:

  • Make a molecule the current molecule ( on it) in a first group you want to browse.
  • To move to the group on its left press + left arrow key. The view focuses on the next group and zooms to fill the view.
  • The same for the “right | up |down” directions: + “right | up | down” arrow key.

20. Display molecule properties as colors
DescriptionVideoVideo (Youtube)

The Molecule cell background can be colored simultaneously by four different properties:

  • Press the “Display colored properties” button display_colored_properties .
  • A dialog appears to select up to 4 properties to display. Select a property in the dropdown menu and check the “Color ramp” checkbox.
  • A histogram of the values of the dataset for that property is displayed and colored.
  • The colors can be changed by the triangles on the color bar.
  • Press ok and the molecules will be colored according to their property values.
  • To temporarily hide/show the color scale press the “Hide color properties” button hide_color_properties .

colors_properties_capture

21. Display molecule properties as 3D bars
DescriptionVideoVideo (Youtube)

The colored property can also be displayed as 3D bars with the molecules on the top:

  • In the “Display colored properties” dialog, check the “3D” checkbox next to the property to display in 3D then press ok.
  • The colored bars are illuminated by a light that you can move by holding + and drag.
  • Select “no 3D” at the bottom of the dialog window to remove the 3D effect.

Note that for very large datasets, the 3D Property Bar view may significantly decrease the performance of the display.

22. Filter in and out molecules on the screen
DescriptionVideoVideo (Youtube)
Molecules can be filtered using a complex combination of criteria:

  • Press the “Filter on properties” button filter. The filter dialog box appears.

filtering_capture

  • Select from the list of properties (green rectangle in figure), one to use as filter.
  • Adjust the range of values to the interval you want to keep. Values can be as follows:
    • Numerical : Adjust values with two sliders.
    • Alphanumerical : Fill the “Like:” field with a regex or a simple text filter.
    • Date: Select a starting and ending date (as in black rectangle in figure).
  • Press the “Add/Update” button to include the new filter into the list of filters at the top of the dialog (red rectangle in figure). All the filters are then applied to the dataset.
  • To change the range of a filter and see its effect in real-time, click on the filter in the list, check the “real time filtering” checkbox and then move the sliders. The molecules are on the fly filtered in or out as you move the sliders.

Press the “Disable filtersdisable_filters to temporarily show all molecules.

23. Generate a 2D plot of groups based on properties
DescriptionVideoVideo (Youtube)

Clusters can be placed on a 2D plot with X and Y axis defined as molecule properties:

  • Press the “Graph of groups” button graph_groups
  • In the dialog box select the two properties to use for the X and Y axis and the way values from the molecules in the groups are used (min, mean or max) and press ok.
  • The groups are then displayed on a 2D graph. To avoid the group overlapping hold and rotate the mouse wheel. The size of the groups increases or decreases but their graph coordinates do not change.
  • To display the coordinates of a group in the plot hold the key and move the mouse cursor over the cluster.

24. Display a property 2D plot for each group
DescriptionVideoVideo (Youtube)

To attach a graph to each cluster:

  • Press the “Graph per group” button graph_per_group .
  • In the dialog box select the two properties to use for the X and Y axis and the way values from the molecules in the groups are used (min, mean or max) and press ok.
  • A graph is attached to the left side of each group. If necessary press ‘v‘ to reorganize the view and avoid overlapping.
  • Placing the mouse over the dots in a graph displays their coordinates.
  • on a dot to make the corresponding molecule current.
  • Placing the mouse over the molecules in the group highlights the corresponding dot in the plot.

25. Spreadsheet display and use
DescriptionVideoVideo (Youtube)

To activate the dataset spreadsheet:

  • Press the “Spreadsheet” button spreadsheet to display the dataset as a spreadsheet at the bottom of the screen.
  • on the line numbers to center the view on the corresponding molecule.
  • on a molecule in the view to reach the corresponding line in the spreadsheet.

Use the “formula” button formula to create new properties from existing ones:

  • In the dialog box type the name of the new property.
  • In the “Formula:” field type the mathematical formula to be used to create the new property. For instance, if you want to calculate a pIC50 from a IC50 nano-Molar value, i.e. “–log10( IC50 *1e-9)”, do as follows:
    • Type first “–log10(“
    • Select the IC50 property from the list
    • Finish your formula with “*1e-9)” and press enter.
  • on a column title to display a context menu where you can choose to “hide, show all, rename or delete” columns.
  • Double on a column title to sort the spreadsheet using this property. Do it again to reverse the sort order.
26. Tips and shortcuts to accelerate the navigation
DescriptionVideoVideo (Youtube)

Some tips and shortcuts to accelerate the navigation on a dataset:

  • Press ‘T‘ to instantly zoom on the location pointed by the mouse cursor.
  • Press ‘R‘ to instantly zoom out and display the whole dataset.
  • Press ‘E‘ to instantly zoom on the cluster under the mouse cursor.
  • Alternate ‘T‘,’E‘ and ‘R‘ to quickly navigate a dataset and focus on groups or molecules that catch your eyes from the whole dataset level.
  • on a molecule to center the view on it.
  • Hold + to center and zoom on the molecule.

27. Freeze cluster positions
DescriptionVideoVideo (Youtube)

To prevent some groups from moving when the view is reorganized :

  • Move the cursor over a group to freeze and to open the context menu.
  • Select Fix/unfix in the context menu.
  • A glowing rectangle will be displayed around the frozen groups.

Alternative to the context menu:

  • Move the cursor over a group to freeze and press ‘F‘.

Note: The frozen groups will still apparently move on the screen when reorganize_groupsis pressed (or ‘v‘) but their position relative to each other will stay the same.

28. Hiding clusters
DescriptionVideoVideo (Youtube)

Cluster can be hidden when there are too many groups to work easily and some of them are not of immediate interest:

  • Move the cursor over the name of a group to hide.
  • Hold + and on the title. The group is now hidden.
  • The hidden groups only appear in the tree view as gray items (see 15. Create groups and super-groups of molecules).
  • Use the gray item context menu by clicking on a group of the tree and select “show” to make the group visible again.

To show all hidden groups at once use the menu “Groups->Show all“.

29. Delete molecules, groups and supergroups
DescriptionVideoVideo (Youtube)

To delete a molecule:

  • Place the mouse cursor over the molecule to delete and either press the ‘del‘ key or select “delete object” from the context menu ().

Press + ‘Z‘ to undo the delete molecule (or use the menu “Edit->Undo“).

If a selection is active and you delete one of the selected molecules, all the selected molecules are deleted.

 

To delete a group (and all its content):

  • Place the mouse cursor over the group to delete and either press + or select “Delete group” from the context menu ().

 

To delete a supergroup (but not its content):

  • Place the mouse cursor over the supergroup background and either press + or select “Delete group” from the context menu ().

30. Subgrouping
DescriptionVideoVideo (Youtube)

Subgrouping consists of assigning the molecules of each group to new groups based on selected property. Theses new groups are added to the original group which becomes a supergroup.

To perform a subgrouping:

  • Select the menu “Groups->Subgroup“.
  • A dialog box appears to choose the secondary grouping property (the current grouping property is grayed out). Press ok.
  • Each group becomes a supergroup containing molecules grouped by the secondary property.

To perform a subgrouping on a single group:

  • Place the mouse cursor over the group of interest then to display the context menu.
  • Select the item “group by” and choose the secondary property in the submenu.

Note: This operation cannot be undone at the moment (v1.00).

31. Property selector
DescriptionVideoVideo (Youtube)

The property selector is used to select which properties loaded from the SDF file are to be displayed/hidden.

To make a selection of displayed properties:

  • Press the property selector icon. A dialog box with 2 lists appears. The right list contains the properties to display. The left list contains the properties to hide.
  • Select a property to hide in the right list and press the right arrow. It moves to the left list. (Select multiple properties using or ).

Important note: properties that have been hidden are not saved when using “File->Save“, “File->Save as” or “File->Save Selected“.

SELECT_INFORMATION_TO_USE

32. Molecule viewing time
DescriptionVideoVideo (Youtube)

Each molecule of the dataset has an internal clock measuring the viewing time i.e. the time it has been displayed at a high zoom level. When this viewing time is displayed, it is possible to easily spot the zones of the dataset that have been overlooked.

To display the viewing time:

  • Press the icon MOLECULE_VIEWING_TIME.
  • The viewing time is represented as a colored circle above each molecule. The size of the circle is proportional to the time spent displaying the molecule at high zoom level. A green circle mean the molecule has been displayed at least 3s.

 

The circle is hidden at high zoom level to avoid overlapping with the molecule.

33. Molecule display modes
DescriptionVideoVideo (Youtube)

The molecules can be displayed in 3 different ways: wire, sticks and spheres. These 3 modes are accessible from the “Molecules” menu.

  • The stick display mode is best when the atom names are hidden (MOLECULE_TITLES).
  • The light source is moved by holding the key + and drag the mouse.
  • In sphere mode molecules are usually too big to fit in their boxes. Hold the key and rotate the mouse wheel to change their size.