Go back to Examples v12.1


Example 03 - Custom data upload by registered users


This section provides examples of data upload by registered users. Three subsections provide detailed examples for uploading basic and advanced formats.

Basic format

The file in basic format has two tab-separated columns Name and Value (see also Upload user-provided overlay data):

  • Name containing names of elements to be colored
  • Value containing a value from [-1,1] range, to be transformed to blue-red coloring, with negative values colored blue, positive colored red; the saturation of the color will be defined by the absolute value.

This is Example file 2, containing a custom coloring for the map Example file 1.

To upload this data set, do the following:

  1. Make sure you have the privileges to generate overlays in the example map
    1. Open in admin panel Project tab and click on Edit
    2. Go to Users tab, see if by your name the View project checkbox is checked
  2. Enter the user view of the example map from the Admin view > Projects by clicking on the name of the uploaded project (example_map by default)
  3. Make sure that you are logged in by checking the Info tab in the left panel
  4. In Overlays > User-provided overlays section, choose Add overlay then press Choose File to select Example File 2 to upload
    Warning: To see uploaded overlay agree on Google Maps terms
  5. In Overlays > User-provided Overlays tab, click View checkbox to examine generated view

Examine the generated coloring and the uploaded data set. Please see image below and note that:

  • All SNCA elements are colored to the same color because of by-name matching
  • SNCA elements are blue-colored (the value in the file is -0.5), while PRKN is red (the value in the file is 0.75)

Basic format overlay

Advanced format - generic type

Advanced format foresees two parts of the uploaded dataset - header and body (see also Upload user-provided overlay data).

Header lines have to start with ‘#’. It can contain the following elements:

  • Version # VERSION=xyz - a version of this custom layout
  • Name # NAME=xyz - a name that will be automatically assigned upon upload
  • Description # DESCRIPTION=xyz - a description that will be automatically assigned upon upload

Body is a table with a following set of columns:

  • Name, Value - same as in basic layout
  • Compartment - name of a compartment in which coloring should take place
    Warning! Coloring of the elements in different compartments works ONLY for separate (not nested) compartments. Setting a color for elements in a compartment that encloses other compartments sets the color in the nested compartments as well.
  • ChEBI - ChEBI identifiers of elements to be colored
  • Entrez gene - Entrez identifiers of elements to be colored
  • Gene ontology - Gene Ontology identifiers of elements to be colored
  • Ensembl - Ensembl identifiers of elements to be colored
  • HGNC symbol - HGNC symbols of elements to be colored
  • UniProt - UniProt identifiers of elements to be colored
  • ReactionIdentifier - ID of interaction to be colored (interactions coloring only)
  • LineWidth - line width of the colored interaction (interactions coloring only)
  • Color - color of the colored element.

By-identifier coloring

This is Example file 3, containing a custom coloring for an example map above Example file 1.

Upload this data set similarly as in basic format upload.

Examine the generated coloring and the uploaded data set. Please see image below and note that:

  • elements are colored by their identifiers instead of their names
  • groups of SNCA elements are colored differently - nucleus elements are colored blue, synapse elements are colored red; this is by compartment constraint
    Warning! Coloring compartments works ONLY for separate (not nested) compartments. Setting the color for SNCA identifier in the cell will color the contents of the nucleus and synapse as well. Setting different colors for the same SNCA identifier in the cell and in the nucleus will cause an error, as two different colors will be assigned to the same SNCA identifier in the nucleus inside the cell. Example warnings
  • removing compartment column will also cause the error described above
  • using SNCA coloring by-name overrides by-identifier coloring, the order of selection is as follows:
    • match by-name
    • match by-identifier
    • constrain by-compartment

Advanced format overlay


Custom colors and interaction coloring

Advanced format foresees assigning user-defined colors to both elements and interactions.

This is Example file 4, containing a custom coloring for an example map Example file 1.

Upload this data set similarly as in basic format upload.

Examine the generated coloring and the uploaded data set. Please see image below and note that:

  • color column replaces value for defining colors of interactions and elements; both parameters can not be used simultaneously
  • reactionIdentifier is not affected by compartment constraint

Custom format overlay

Remarks

  • Column names work only if an element is annotated by one of the terms above
  • Column name: Name refers to the full name in the annotation panel; e.g., HGNC gene name for genes/proteins; ChEBI name for simple molecules or GO name for a Gene Ontology term.
  • Elements needs to be written in the table as displayed in the left panel; e.g., HGNC: 11138; Ensembl: “ENSG00000184845”; ChEBI: “CHEBI:18243”.
  • The uploaded table must be a text file
  • Most columns could be used simultaneously as long as the same element is not addressed in two different columns; e.g. LRRK2 by HGNC name (=LRRK2) and Entrez gene ID (=120892) or a reaction identifier and a PubMed target the same reaction.
  • Restrictions:
    • A value or a color columns must in the uploaded text file but they mutually exclusive
    • Name should only be combined with the identifiers: reaction Identifier and compartment
    • Reaction identifier should only be combined with the identifiers name or PubMed
    • If the column compartment is used the field must be filled by a compartment name derived from the content, otherwise the element will not be displayed in the content. Currently there is no possibility to choose all compartments.

Alternatively: you can always extract an area of interest as a CellDesigner file, open it in CellDesigner and colour it there.

Advanced format - genetic variant

Genetic variant is an overlay in a specific format. There is Genome overlay file, containing genetic variants overlay for the map Example file 1.

Before upload, check if Organism type is defined for your project (see section Edit project). If it is missing, the genome browser is not displayed.
Upload the overlay similar to the basic format upload. Please note that field TYPE automatically switch onto GENETIC VARIANT after choosing the file.
Click View to display coloring on the map, see below.

Advanced genome overlay


In the map we see colored SNCA and PRKN. It informs that there are genes variants. To take a closer look at the sequence, you can zoom in/out using button +/-. Clicking on the pin display popup window. In the bottom row, in our example named Genetic, we see the locus of the particular variant. PRKN holds four variants all together in the example. The height of the mark | informs about the allele frequency, the shorter mark the lower frequency.