Structure Checker

Version 14.9.29.0

Find the user guide of Structure Checker GUI version 5.10.4 or earlier at a different location. Click here to visit the old site.

Contents

Introduction

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.

Available checkers

See the detailed list of available checkers.

Structure Checker Graphical User Interface (GUI) user guide

General layout

Structure Checker

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.

  1. Select input files:

    select input file

    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 remove file button in line with file.

    Click Next to proceed to the next step.

  2. Create checklist:

    Click Next to proceed.

  3. Set options:

    set options

    Operation mode

    Report options

    Each error and issue is recorded in the report logged during the checking and fixing procedure.

    Click Next to proceed.

  4. Specify output:

    specify output

  5. Run Structure Checker:

    summary

    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:

    navigate back

    To perform structure check, click Run.

    manual fix

    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.

    result

    According to previously set checking procedure, Summary window displays the checking and fixing results in different tabs.

    tabs1 or tabs2

Preferences

You can reach the following actions via Preferences button preferences buttton:
preferences menu

Profiles

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.

How to set and configure a custom profile

Checker/Fixer Manager

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.


External Structure Checkers and Fixers window contains two tabs: Checkers and Fixers. Add the external checker(s)/fixer(s) by pressing plus button on the relevant tab.

dialog
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.


Links

List of available checkers
Structure Checker in MarvinSketch
structurechecker Command Line Tool
Examples of structure checking in various ChemAxon products
Structure Checker Developer Guide

Go to top