The MolPane
Widget
is for displaying structures and reactions. It has this icon in the form builder
Design mode toolbar:
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.
Permanent changes to the display settings can be made using the settings editor, as with any Widget. This inlcudes many of the Marvin display settings, but also lets you:
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.
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 strucutres 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 scrolbar will be used if there are more structures than the grid can disaply. In grid view only the number of structures in the grid will be displayed, but awarning 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).
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.
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:
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.
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.
Copyright © 1998-2009 ChemAxon Ltd. All rights reserved.