MolPane Widget

Basics

The MolPane Widget is for displaying structures and reactions. It has this icon in the form builder Design mode toolbar: images/download/attachments/42173225/molecule.png

images/download/attachments/42173225/widget-molpane.png

The MolPane Widget is based on the ChemAxon MViewPane component and you have full control over the display and manipulation of the structure through the right-click popup menu functions. This includes various options for 2D and 3D molecule display. For full details see the Marvin User Guide.

The MolPane Widget can be used to render Structure fields and text fields. All structure entities (e.g those using JChem Base or JChem Cartridge tables) will have a single structure field what will typically be displayed using the MolPane widget. Any entity might also have text fields whose contents are structures in some recognised format (e.g. smiles, Molfile, InChI, MRV). In this special case the MolPane Widget can be used to display these text fields as structures. To do so use the MolPane widget in the form view, or change the renderer in the grid view to the structure renderer.

Settings

Permanent changes to the display settings can be made using the settings editor, as with any Widget. This includes many of the Marvin display settings, but also lets you:

  • Specify whether the structure should be displayed in the original (default) or standardized form.

  • Hit alignment and orientation options.

    images/download/attachments/42173225/widget-molpane-settings.png

As with all Widgets, multiple MolPanes can be used to display your structure. This can be useful if you want to see the structure in multiple forms (e.g 2D and 3D, or original and standardized). The image below shows the same 3D structure displayed in original, 2D and 2D standardized forms.

images/download/attachments/42173225/widget-molpane-multiple.png

Using molpane for a structure grid

The structure renderer used in the MolPane widget supports rendering multiple structures as a grid. This also applies to the structure renderer in the grid view. Structure formats supporting multiple structures will be automatically recognised. This includes smiles, where each structure is specified on a different line.

By default the grid size is set at 1x1. To change this edit the Number of Rows and Number or columns in the settings. In grid view a vertical scrollbar will be used if there are more structures than the grid can display. In grid view only the number of structures in the grid will be displayed, but a warning message is displayed and the full set of structures can be seen by right clicking on the column and selecting 'View value'.

The following screenshot shows the MolPane widget being used to display the structure field (top) and a chemical terms field that has generated the stereo isomers for that structure and shown in a 2x2 grid (bottom). This illustrates how the MolPane widget is particularly useful when used in conjunction with a chemical terms field. To do this you would typically use a chemical terms expression which converts the generated structures to text using the

molString(mols, 'format')

function, where mols is a different chemical terms expression (e.g. streoisomers()) and format is the format that the structures are to be generated in (e.g. cxsmiles).

images/download/attachments/42173225/structure-grid-widget.png

Editing structures

If you double click on the MolPane widget for a structure field the Marvin Sketch editor opens letting you edit the structure. Once you have made you changes click on the OK button and your changes are applied. Structures in text fields are edited as text, not using Marvin Sketch.

images/download/attachments/42173225/widget-molpane-edit.png

One important aspect of editing structures is which form of the structure are you editing, as the display settings can display a different form or the structure compared to the original that is in the database. When editing the structure it is always the original database structure that you are editing (the one that was originally entered or imported). This may be in a different form to the one that is currently displayed as:

  • A 3D structure may be being displayed as 2D.

  • The standardized form of the structure may be the one displayed.
    If you require the structures to be saved in a particular format (e.g. smiles) this can be specified using the 'Format for saving structures' extra attribute of the field (this applies to structure and text fields). Open the schema editor, find the field, go to the 'Extra attributes' tab and add the 'Format for saving structures' attribute and specify the format to use.

Query mode

In query mode you specify a query structure by double clicking on the panel to open the sketcher. Sketch your query and close the window and you will see the query structure set. You can also specify the search type and the advanced search options using the right click popup menu.