MarvinSketch

Structure Checker is integrated into Marvin Sketch and helps drawing chemically correct structures. Molecules are validated during the drawing process and detected structural issues are highlighted. Possible solutions are also offered that can be selected interactively by the user.

Setting Structure Checker Configuration

Viewing the default checker list

Before you start using Structure Checker in MarvinSketch, consult the list of available checkers in the Preferences dialog (Edit >Preferences > Checkers tab).

images/download/attachments/50440198/default_checker_list.png
The default list contains checkers in alphabetical order.
Two types of checkers are listed and are distinguished by the additional 'error' tag and by different icons:

  • images/download/attachments/50440198/defaultcheck.png Error detecting checkers: Error checkers are looking for chemically wrong molecule parts (e.g., valence errors, overlapping atoms);

  • images/download/attachments/50440198/defaultfeaturecheck.png Feature detecting checkers: Feature checkers searches the selected molecule characteristics which in the specific structures are not considered as an error (e.g., query properties).

Click on the name of the checker to see additional options and select the needed options by clicking the tick box.

Checking order

Some molecule properties might change after fixing an issue. You can define a checking sequence by moving up or down the list elements. The order of the checkers may be important in case you run a Fix All action.
In order to change the sequence of the checker items, select the checker from the list and click on the up images/download/attachments/50440198/up.png or down images/download/attachments/50440198/down.png icon on the right side of the dialog window.

Add and remove checker items

To discard items from the checking sequence, select the checker and click on the images/download/attachments/50440198/remove.png button.
For adding new elements to the list, click on the images/download/attachments/50440198/add.png button and select the relevant checker.

Save and load checker configuration

Different checking lists might be needed for different compound families. To make checking simpler, you can save your checking list to your computer and open it again if you are editing the same molecule type.

  • Click the Save button images/plugins/servlet/confluence/placeholder/unknown-attachment to save your set checker configuration.

  • Click the Load button images/download/attachments/50440198/open.png to open a saved configuration list from file.

  • You can also load remote checker configuration from URL images/download/attachments/50440198/url.png . Unless you save this configuration to your computer, the loaded checker configuration cannot be modified.

  • You can integrate custom, external checkers or fixers to the list of available checkers images/download/attachments/50440198/configure.png .

You can see the path of currently applied configuration file at the bottom of the window.

External checkers

Custom checker and fixer implementations can be integrated into the list of available checkers. To learn about the details, visit Custom Checkers and Fixers.

After you have finished adding external checkers and fixers, click on OK; the newly added checkers will appear among the factory checkers. These external checkers/fixers will now also be available in Structure Checker Application and in all other applications using Structure Checker. When the external checker/fixer uses actionStringToken annotation, the checker can be referenced on the defined name in structurechecker command-line and in Chemical Terms applications as well.
See how to Add checker(s) to checker configuration.

Invalid checkers

Structure Checker configuration files may contain erroneous checker(s), i.e., Invalid Checker(s).
images/download/attachments/50440198/invalid_checker.png
invalid checker
If the imported configuration file contains invalid checker(s), a warning message will appear informing the user about the issue.
Remove the invalid checker(s) from the list to accept the proper configuration.

Starting Structure Checker

You can open Structure Checker at any stage of your work with Marvin Sketch by

  • clicking on the Check structure icon images/download/attachments/50440198/defaultcheck.png in the toolbar

  • selecting Check Structure in the Structure menu

  • left-clicking the Checker button in the statusbar

  • using shortcut Ctrl+R.

A Structure Checker window will appear next to the MarvinSketch window. The molecule regions found by Structure Checker are highlighted on the canvas with a light red color. If you click on any checker message, the affected area changes color to darker red. If you move the cursor over one of the affected region, the appropriate checker message is highlighted in the checker list.

images/download/attachments/50440198/str_checker.jpg

Rechecking the structure

After you have changed the structure (including accepting a fix), the checker will offer re-checking: click on the Check structure againin the Structure Checker window.

images/download/attachments/50440198/checkerwindow.png
re-check

Another option is to turn on automatic re-checking: click the Enable automatic checking at the bottom of the text. At any point you can allow Structure Checker to fix the issues one by one or every of them by a single click.

Automatic structure checking

Turn on Automatic Check to follow every drawing step you make by a quick check. This option is switched on in the Structure menu or right-clicking the Checker images/download/attachments/50440198/statusbar-checker-disabled.png icon on the status bar which then becomes colored.

  • In case of an error, a red exclamation mark appears images/download/attachments/50440198/statusbar-checker-error.png . Left-clicking on this icon opens the Structure Checker window, where all the warnings are listed.

  • While the molecules are scanned for checker issues, a yellow question mark images/download/attachments/50440198/statusbar-checker-progress.png appears on the status bar.

  • If the molecule is correct, a green check mark images/download/attachments/50440198/statusbar-checker-enabled.png appears in the Checker icon on the status bar.