Example 1 - CellDesigner file upload and annotation

This section provides examples of usage of automatic annotators and automatic verification when adding a new project to MINERVA.

Description of the example map content

Click here to download an example map, drawn in CellDesigner file. The file is quite simple, and has the following properties:

  • Annotations
    1. Gene component SNCA is not annotated

    2. RNA component SNCA is annotated with Entrez Gene id (NCBI Gene in CellDesigner MIRIAM tab)

    3. Two (of three) protein components SNCA are annotated with UniProt id

    4. Protein component PRKN is not annotated

    5. Phenotype component UPS is annotated with Gene Ontology

    6. Interaction re3 is annotated wit PubMed id, while other reactions are not

  • Compartments and areas
    1. SNCA translation and SNCA degradation areas are drawn on top of the diagram

    2. Cell, synapse and nucleus compartments are drawn

Automatic annotation

See Configure automatic annotation for details about annotators.

  1. Upload the the example map to your MINERVA instance using Add project button

  2. Configure automatic annotations:
    • check the checkbox Annotate model automatically

    • press the Advanced button; select the following annotators:

      1. Gene:
        HGNC annotator

      2. GenericProtein
        UniProt annotator

      3. Phenotype:
        Gene Ontology annotator

      4. Rna:
        Entrez Gene annotator

  3. Close the Select annotators window and Save the project

Examine the generated content of the map. Please note that:

  • The annotations between SNCA DNA, SNCA RNA and SNCA protein differ, because different annotators use different information sources to annotate the elements.

  • In the left panel the annotations marked as source: Annotated by curator correspond to original MIRIAM annotations within source file

  • Even though SNCA DNA had no MIRIAM annotation, it was correctly annotated by name by HGNC annotator

  • UniProt annotator works only by the identifier, so it was unable to provide annotations for PRKN (no annotation)

  • Gene Ontology annotator retrieved a definition of the annotated Phenotype

Automatic verification

See Section Configure automatic verification for details on annotators.

NOTE: Your MINERVA instance remembers the settings from the previous run, so keep annotation settings as above.

  1. Upload the the example map to your MINERVA instance again, use Add project button. Make sure to either remove previously uploaded example, or to name the project differently.

  2. Configure automatic verification:
    • check the checkbox Verify manual annotations
    • press the Advanced button and set the following rules for:
    1. Element > Species > Gene
      • select as valid (top right window):
        Ensembl, Entrez Gene, HGNC, HGNC Symbol

      • tick checkbox One of these miriam should be required and set as required (bottom right window):
        Ensembl, Entrez Gene, HGNC, HGNC Symbol

    2. Element > Species > Phenotype
      • select as valid:
        Gene Ontology

      • tick checkbox and set as required:
        Gene Ontology

    3. Element > Species > Rna
      • select as valid:
        Entrez Gene, HGNC, HGNC Symbol

      • tick checkbox and set as required:
        Entrez Gene, HGNC, HGNC Symbol

    4. Element > Species > Protein > GenericProtein
      • select as valid:
        Entrez Gene, HGNC Symbol, UniProt

      • tick checkbox and set as required:

    5. GenericReaction
      • select as valid:

      • tick checkbox set as required:

    6. Make sure that items in upper hierarchy levels (e.g. Generic Reactions, Element, Species or Protein) have the same sets of verification rules
  3. Close the Select valid annotations window and Save the project.

Upon upload, an exclamation mark icon will appear next to the project in the Status column. After clicking, the popup window will look like this: Status warnings

Examine the generated warnings (image above). Please, note that:

  • PRKN is missing UniProt id in CellDesigner

  • Automatic annotators provided additional annotations to Gene and RNA elements, outside of the valid list. You can suppress these warnings by updating the valid list

  • GenericProtein element PRKN was indicated as missing a required annotation (UniProt)

  • Reactions are indicated as missing a required annotation (PubMed)

See more in section Examine warnings.

NOTE: Valid and Required settings for lower hierarchy levels are overridden by settings for upper hierarchy levels. For instance, if no HGNC annotation is required for GenericProtein, but Protein requires HGNC, that protein will raise a warning.