Structure Checker is a chemical validation tool detecting and fixing common structural errors or special features that can be potential sources of problems. Structure Checker wizard is a desktop application for the batch checking and fixing structures of input file(s). Your large files (like SDfiles) are scanned for drawing errors or features you want or don't want to include in the output file. This application offers manual operation mode displaying the compounds having errors and allowing the manual modification. Additionally, automatic fixers are provided for many types of issues, and a validation report can be generated as well. For the more comfortable usage of Structure Checker, "Profile manager" is available to customize every step of the wizard.
See the detailed list of available checkers.
General layout
This chapter gives you a simple walkthrough of the usage of Structure Checker application. The major steps are demonstrated on the screenshots of every page of the checking routine.
In this step you define the files to be checked and fixed. Click on the Browse button on the right side to add files one by one; click on Add more files to add further files or multiple files at a time. Select one or more files (Shift or Ctrl + mouse click) and click Open. You can add unlimited number of files but remember, the output will be written to only one file.
To remove a file from the list, click on button in line with file.
Click Next to proceed to the next step.
In this screen you can see two panels. On the left, all available checkers are listed in alphabetical order. For creating your checklist, select the actions you want to perform and click the Add button to transfer it to your checklist, i.e., into the right panel.
Removal of any element from the list is similarly easy: click the item(s) in the right panel first, then the Remove button between the two panels. Click on Remove All if you want to remove all elements from the list.
You can create an ordered list of checkers by moving the selected item(s) with the up or down arrow next to the right panel.
To load a configuration file located on your computer, click the Import button. Browse the location in the Open dialog window and click Open.
If you'd like to use the set checking configuration later, you can export it to a configuration file by clicking the Export button. Browse the location and name the file in the Save dialog window.
To load a configuration file from an internet source, click the URL button. Enter the URL in the Input dialog window and click OK.
You can copy the set configuration as action string: It helps you to use
configurations in structurechecker
command-line or in evaluate structure checker functions
.
Click on Copy at the bottom of right panel; the action string of the relevant configuration is copied to the clipboard.
Some checkers have options to refine the issue detection. These options appear when you click on the checker in the right panel of the configuration page.
Fixer can also be configured for each checker, i.e., what to do when an issue is found. Apart from Manual fix and keeping the compounds unfixed, Do not fix, one or more automatic fixers are also available as Fix option.
Click Next to proceed.
Operation mode
Report options
Each error and issue is recorded in the report logged during the checking and fixing procedure.
txt
or csv
format containing statistics
and a detailed list of detected problems.
In this page, you can see the confirmation of input and output files, operation mode, and report options before starting the checking/fixing process. To change any of these settings:
To perform structure check, click Run.
If you have chosen a mode which prompts you to fix manually the structures, a MarvinSketch window is displayed with the incorrect structure, and the Structure Checker side window shows you the source of the issues. Choose the fixing method by clicking on the checker, select the mode of fixing if applicable, and click Fix selected. After fixing the molecule, click on Accept button to accept the changes, or Discard, if you want to save the molecule with errors.
According to previously set checking procedure, Summary window displays the checking and fixing results in different tabs.
orYou can filter the results by clicking on the following buttons:
You can reach the following actions via Preferences button :
Using profiles, the checking routine can be simpler and easier. Besides the two read-only profiles, "Blank" and "Last Used", custom profiles are also available to set and use.
You can add, set custom profiles, and select the default one (used at start-up) by clicking on the Preferences button > Profile...> Edit Profiles... Unless default profile is selected, Blank profile is loaded at start-up.
Custom checker and fixer implementations can be integrated into the list of available checkers in ChemAxon products via the menu of Structure Checker > Preferences > Checker/Fixer Manager > .
External Structure Checkers and Fixers window contains two tabs: Checkers and Fixers.
Add the external checker(s)/fixer(s) by pressing
button on the relevant tab.
First, enter
the URL or browse the location of JAR file containing the particular checker/fixer in field Java Archive (JAR).
If the JAR file contains more than one classes, select the appropriate class from the drop-down
list to add that checker or fixer to the list of external checkers or fixers; information fields
will be filled automatically if checker/fixer classes use annotations (e.g., Checker/Fixer ID, Help text, Description, etc.).
The Checker/Fixer ID will appear among the list of available checkers.
You can add various external checkers and/or fixers from the same or from different JAR files. The integrated external checkers and fixers can be exported to or imported from a configuration XML by using the appropriate button (Export or Import). This configuration XML file stores the class, ID and JAR file location of the set 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.
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.
List of available checkers |
Structure Checker in MarvinSketch |
structurechecker Command Line Tool |
Examples of structure checking in various ChemAxon products |
Structure Checker Developer Guide |