Markush Editor User Guide

    Markush Editor Application

    images/download/thumbnails/1806319/markusheditor.png Markush Editor is a desktop application of ChemAxon for chemical patent drafting, suitable for creating and editing complex Markush structures and generating Markush claims. Markush Editor uses a graphical representation of the hierarchical nature of the R-groups in Markush structures. The structures (fragments) of an opened Markush file will be identified, classified, and organized as a scaffold and attached R-groups to help you follow each nested structure. For running this application, you need to download and run Markush Editor installer. Without a valid Markush Editor license, the application can only be used in viewer mode. Short video tutorials demonstrating the main functionalities of the application are available here.

    images/download/attachments/1806319/MarkushEditorGUI.png

    Main Menu and Toolbar

    The main menu contains File , View , Tools , Window and Help elements.

    images/download/attachments/1806319/image2020-10-2_9-37-10.png
    • File

      • New, images/download/attachments/1806319/newdocument24.png

      • Open (Ctrl+O), images/download/attachments/1806319/open24.png

      • Compose Markush Structure..., images/download/thumbnails/1806319/image2020-10-2_9-40-39.png

      • Save, images/download/attachments/1806319/save24.png

      • Save As...,images/download/attachments/1806319/saveas24.png

      • Save All,images/download/attachments/1806319/saveAll24_editor_tool.gif

      • Export to document images/download/thumbnails/1806319/image2020-10-2_9-41-25.png

      • Exit.

    • View

      • Show Only Editor (Ctrl+Shift+Enter)

      • Full Screen (Alt+Shift+Enter)

    • Tools

      • Plugins

      • Options... images/download/thumbnails/1806319/image2020-10-2_9-44-12.png

    • Windows

      • Document preview images/download/thumbnails/1806319/image2020-10-2_9-38-24.png

      • Checker View

      • Claim hierarchy

      • Reset Windows

      • Close Window

      • Close All Documents

      • Close Other Documents

      • Documents...

    • Help

      • Help (F1) images/download/thumbnails/1806331/image2014-11-5_16_37_58.png

      • Licenses... images/download/thumbnails/1806331/image2014-8-12_14_8_45.png

      • Check for Updates...

      • About ChemCurator...

    images/download/attachments/1806319/image2015-6-23_10_59_27.png
    • "Collapse molecule tree" images/download/attachments/1806319/collapseall.png Closes all nodes of the R-group tree. The default setting is off .

    • "Expand molecule tree" images/download/attachments/1806319/expandall.png Expands all nodes of the R-group tree. The default setting is off .

    • "Always display scaffold in Fragments" images/download/attachments/1806319/alwaysshowscaffold.gif Displays the relevant scaffold of the selected R-group. The default setting is on .

    • "Toggle molecule display in tree" images/download/attachments/1806319/nodepic_24.png Expands the boxes of the tree to show the structure of the molecule. The default setting is on .

    • R-group search box: allows quick navigation the desired R-group of the Markush structure.

    • "Enumerate Markush structure" images/download/attachments/1806319/image2015-1-6_11_36_44.png Open the Markush enumeration panel.

    Panels and views

    Markush Editor contains six main components by default. All of the components can be reorganized and resized.

    1. Editor panel contains Markush tree, Scaffold and R-group fragments view;

    2. Claim hierarchy contains your independent and dependent claims

    3. Structure checker displays the error and warnings related to your Markush structure;

    4. Exemplified structures view can display the validation status (matching or non-matching) of individual compounds against your Markush structure.

    5. Preview displays enumerated examples;

    6. Nesting view displays the embedding of the selected R-group(s);

    Editor panel

    The Markush structures of the opened file are organized and arranged in the Editor panel. In the tree view, the scaffold is presented on the first (parent) level of the tree, and the associated R-groups are classified as its children. The scaffold(s) and attached groups are denoted by named boxes. The parent level boxes are named as "Scaffold". Nested nodes are labeled according to the represented R-group definitions (e.g.: R1, R2,...Rn or the alias of the R-group if it has one), followed by the number of members. To view any scaffold or R-group definition, select the relevant node. The structure(s) of the chosen element will be presented in the fragment view. The selected items are highlighted in the tree view.

    images/download/attachments/1806319/image2020-10-2_9-50-57.png

    You can select more than one structure from the tree using Shift+Left-Click or Ctrl+Left-Click to display them in the View panel at the same time.

    Note: Shift/Ctrl+Arrow keys work for selection as well.

    images/download/attachments/1806319/image2020-10-2_9-51-27.png

    Expand the nodes of the Tree panel to show the small structures of each node.

    Exemplified structures panel

    Exemplified structures panel can be used to check whether individual compounds match your Markush structure or not. Matching structures are highlighted by a green background, while non-matching structures are highlighted in red.

    images/download/attachments/1806319/image2015-6-23_11_27_43.png

    Preview panel

    Preview tab displays enumerated examples (max. 4) of the selected R-group(s).

    images/download/attachments/1806319/preview.png

    Nesting view panel

    Nesting view tab displays the step-by-step route of embedding of the selected R-group starting from the scaffold.

    images/download/attachments/1806319/nestingview.png

    If any of the validation structures are selected, the matching and non-matching R-groups and fragments are also highlighted in Markush structure (in the scaffold view, the tree view, and the fragment view).

    images/download/attachments/1806319/image2020-10-2_9-54-6.png

    Structure checker panel

    Structure checker panel displays the structure drawing errors and warnings related to the active editor component. In the case of an error, an exclamation mark appears in a red circle, in the case of a warning, a yellow triangle appears. By clicking on the checker items, you can choose between the available automatic fixer options. You can fix the issues one-by-one with the Fix Selected button or all together with the Fix All button.

    images/download/attachments/1806331/image2014-12-4_14_19_10.png

    Edit Markush Structures

    This paragraph contains the Markush Editor specific features description. To learn more about editing Markush features visit Marvin Sketch (the built-in chemical editor of Markush Editor) documentation.

    Create Markush structure

    If you would like to create a Markush structure based on an existing structure check the Composer Wizard documentation. If you want to create a new Markush structure from scratch , click on the New icon, images/download/attachments/1806319/newdocument24.png in the toolbar or select New from the file menu. A new empty scaffold definition appears, and you can draw your scaffold in the previously described way.

    images/download/thumbnails/1806319/scaffold.png

    Scaffold can be edited like any R-group definition (see next section). To expand your structure, add R-groups to your scaffold and after saving it, new empty R-group definitions appear and you can continue editing.

    images/download/thumbnails/1806319/groups.png

    Edit R-groups and fragments

    You can edit R-group definitions or individual fragment definitions by right-clicking or double-clicking on the tree node or the selected fragment. From the context menu, you can select the Edit function or you can add new fragments or remove existing ones.

    images/download/attachments/1806319/editrgroup.png

    Edit R-group definition from context menu

    images/download/attachments/1806319/editfragment.png

    Edit fragment definition from context menu

    Sketch window opens with the selected definitions. Modified definitions can be saved by the "Save" button in the bottom right corner of the sketch window, or dropped by pressing the Cancel button.

    images/download/attachments/1806319/edit3.png

    R-group bridging

    With R-group bridging, you can create connected R-group definitions. First, you need to select two R-groups (on the same level and with one attachment point and only one occurrence in the parent structure) and after right-clicking on it, you can select the "Create Bridge" function.

    images/download/attachments/1806319/bridgeing1.png

    A new empty R-group definition appears with R(x) + R(y) label where x and y denote the number of the originally selected R-groups. You can add fragment definitions with two attachment points to this R-group.

    images/download/attachments/1806319/bridgeing2.png

    Claim Hierarchy

    With the Claim Hierarchy feature, you can define dependent claims for your main claim. The claim hierarchy can be edited in the Claim Hierarchy panel. If you right-click to deny the existing claim you can add dependent claims. Claims can be edited if you select it in the claim tree.

    images/download/attachments/1806319/image2020-10-2_14-6-47.pngIn the dependent claims, you can exclude any selected fragments, to narrow the scope of the claim. Any fragment excluded from a claim automatically excluded from all of the referring claims. To exclude a fragment select a dependent claim and select any fragment(s) and right-click on it.

    images/download/attachments/1806319/image2020-10-2_14-14-22.pngExcluded fragments are displayed with a gray background. Exemplified structures validation following the claim selection. Excluded fragments can be included again with right-click include.

    images/download/attachments/1806319/image2020-10-2_14-18-52.png

    Markush Composer Wizard

    With Markush Composer wizard, you can automatically generate Markush structures from a set of compounds. The compound set has to be in a single file (SDF, SMILES, etc). The composer wizard can be opened from File->Compose Markush Structure...

    images/download/attachments/1806319/image2020-10-2_10-19-22.png

    After selecting this action, the Composer wizard opens.

    images/download/attachments/1806319/image2020-10-2_10-9-21.png

    After selecting the Input file , the generation process can be parametrized.

    Main options:

    If you want to generate single-level Markush structures, uncheck the Enable nested R-groups checkbox.

    If you don't want to reuse R-group definitions, uncheck the Merge duplicated R-groups checkbox.

    If you don't want to generate atom lists, uncheck the Enable atom lists checkbox.

    Scaffold options:

    You can choose between Automatic detection of the scaffold or using a User-defined scaffold.

    Advanced options:

    For processing a very large set of compounds, you can choose a fast search mode instead of normal in Search mode. With fast search mode, the precision of the internal similarity calculations is reduced, which can cause suboptimal results in some cases.

    If the largest common part of the set of compounds is smaller than the Minimum scaffold size , the composer generates multiple Markush structures with larger scaffolds.

    If some of the R-group fragments in an R-group definition have larger common parts than the Minimum common size of nesting R-groups , the algorithm generates a new nested R-group.

    If the User-defined scaffold option selected, you can navigate to the second page of the wizard dialog with the Next button. On the second page, a preferred scaffold can be set. Input structures not containing the preferred scaffold can be ignored with the Ignore input molecules not containing the scaffold option or in other case composer generates one or more additional Markush structures with different scaffolds for the non-matching input structures. If you do not set any scaffold, Composer tries to find the optimal scaffold automatically. You can use atom lists, bond lists, and R-groups on your predefined scaffold. If you don't define any R-group on this manually specified scaffold, Composer automatically adds R-groups to it, but if you define at least one R-group, Composer uses R-groups exactly how you set them. That is, input molecules with substituents in different positions will be ignored.

    images/download/attachments/1806319/image2020-10-2_10-12-33.png

    After click on the Finish button, the wizard automatically generates a Markush structure based on the input set.

    images/download/attachments/1806319/image2015-1-21_11_29_20.png

    Export to document

    The claim draft can be automatically generated and exported to docx and html format from the File > Export to Document... menu item or with theimages/download/thumbnails/1806319/image2020-10-2_9-41-25.png icon from the toolbar.

    images/download/attachments/1806319/image2020-10-2_10-4-3.png

    After selecting this action, the document export wizard opens.

    images/download/attachments/1806319/image2020-10-2_10-7-2.png

    The generated claim draft automatically opens. If the "Export example molecules" selected the list of exemplified structures with IUPAC names and structure images also created.

    images/download/attachments/1806319/image2020-10-2_10-27-31.png

    Document preview

    Document preview can be opened from Windows > Document Preview menu item or with the images/download/thumbnails/1806319/image2020-10-2_9-38-24.png icon from the toolbar. Document Preview interactively following all modifications in the Markush structure or in the claim hierarchy.

    images/download/attachments/1806319/image2020-10-2_11-56-59.png

    Customize fragment dictionary

    Default fragment names used for the claim draft generation chan be overwritten with a custom fragment dictionary. The dictionary editor available Tools > Options > Dictionary (tab). Alternative fragment names or export as an image can be defined.

    images/download/attachments/1806319/image2020-10-2_12-8-10.png

    Enumerate Markush Structure

    Markush enumeration panel can be opened by clicking on the button images/download/attachments/1806319/image2015-1-6_11_36_44.png of the toolbar. Enumeration can generate the specific compounds represented by the Markush structure. The following configuration options are available:

    Main options that specify some essential enumeration settings:

    • Full enumeration: performs exhaustive enumeration of the Markush structure. Markush libraries can potentially be vast in size, so the enumeration is limited to a maximum number of structures that you can specify.

    • Random enumeration: performs random enumeration (sampling) of the Markush structure. This is mostly useful for large Markush libraries where it is not practical to fully enumerate the library. Random enumeration allows you to sample the library in a random fashion so that you obtain a good representation of the various structures in the library. The same warning about the library size that are described for full enumeration also applies to random enumeration.

    • Enumerate homology groups: specifies whether homology groups (Alkyl, Aryl, etc.) in the Markush structure should be enumerated with examples of the group. Note that this option gives a representative sample of structures for the homology group, but it is definitely a non-exhaustive enumeration. (Note that homology groups may represent a huge or even infinite number of specific groups.)

    • Number of structures: limits the number of enumerated structures to be generated.

    Basic filter options help to eliminate the chemically incorrect enumerated structures:

    • Filter duplicates: eliminate duplicated structures.

    • Filter valance errors: eliminate enumeration of structures with valance errors.

    • Filter infeasible rings: eliminate enumeration of structures with chemically infeasible ring systems.

    Display options help to understand the correlation between the enumerated structure and the Markush structure, but they have some performance overhead:

    • Scaffold alignment: preserve the original scaffold orientation in the enumerated structures.

    • Fragment coloring: use different colors to highlight the parts that are derived from different R-groups.

    Biased enumeration can only be used with sequential enumeration (currently). Enumerated structures can be filtered according to the predefined property ranges. Biased filters guide the full enumeration process to the desired direction internally, thereby biased enumeration has significant performance benefits compared to post-filtering, but the enumeration process itself can be slower with such biased filers.

    images/download/attachments/1806319/image2015-6-23_12_48_26.png

    Enumerated structures can be displayed in the Grid view and Spreadsheet view. The Spreadsheet view contains not only the enumerated structures but the used R-group fragments and some calculated fields as well, including Formula, Name, and Mass. Enumeration results can be saved in various formats by clicking on the icon images/download/attachments/1806319/saveas24.png in the left sidebar of the enumeration panel.

    images/download/attachments/1806319/image2015-6-23_12_46_56.png