MetaboMAPS: Pathway sharing and multi-omics data visualization in metabolic context

Implementation

PHP is used to access an internal SQL database and to handle file and user management. In addition, a user-friendly web interface is integrated to handle pathway exploration and user interactions. The pathways can be uploaded, stored and downloaded in SVG format. SVG manipulation, including zoom, editing, and plotting of data, is done with the JavaScript Library D3. Hosting, infrastructure maintenance, and issue tracking is provided by the enzyme database BRENDA.

Operation

MetaboMAPS (Helmecke, 2020) can be accessed with every modern browser. Log-in is required for upload, editing, and sharing of pathways, but not for exploring pathways, data visualization and downloads.

Sharing metabolic pathways

MetaboMAPS (Helmecke, 2020) is a platform where users can upload individual metabolic pathways and release them for the scientific community. In this process, the pathway gets a unique accession number for reference in publications. Furthermore, the user can link pathways to publications. If the pathway map includes unpublished information, it can be uploaded in confidential mode. In this way, the pathway can be shared with specified colleagues and used for data visualization, but is not available for the general public. Pathways can be found by searching category, name, assigned identifier (e.g. EC number, locus tag), or accession. A unique feature of MetaboMAPS is that uploaded maps must not follow strict conventions as other tools require. The style, detail level and content of the maps is according to the scientist’s needs, and since the maps can be downloaded and modified, they can also be adjusted by other users. Pathway rating and the possibility to add comments increase the quality of uploaded pathways via community contributions. In this way, MetaboMAPS does not compete with but complements curated, comprehensive maps that are already well established. It offers a niche for tentative, novel or incomplete pathways to support ongoing research beyond common knowledge. Since MetaboMAPS creates reproducible, customizable visualizations of high quality, it is suitable to generate publication-ready figures with little effort.

Each pathway is associated with one or more organisms. In fact, it is possible to add the same pathway to hundreds of different organisms. An organism overview shows all pathway maps that are associated to a selected organism. On the other hand, the pathway overview page displays all background information, such as a list of authors, the pathway description, links to publications, and all organisms that are associated to this pathway. The pathways and information are also easily accessible on mobile devices.

Users can upload their own metabolic pathways in SVG format. We chose this particular format because it can be displayed in every modern browser, can be easily manipulated, is completely scalable, and of small file size. Additionally, SVG-files can be exported from every program that users eventually use to draw a metabolic pathway (e.g. Inkscape, Adobe Illustrator, Microsoft Powerpoint, LibreOffice Impress) and users can continue to work with their preferred software.

Multi-omics data visualization

A unique and highly useful feature of MetaboMAPS is the possibility to visualize experimental data on metabolic pathways. Suitable data sets include but are not limited to transcriptomic, proteomic, metabolomic studies, flux distributions, 13C-flux measurements and others. The process for sharing pathway maps and using them for visualization is shown in Figure 1. The first step is the upload of an existing metabolic pathway in SVG format (Figure 1A). Afterwards, the user can add further information and assign the pathway to a pathway category. In the second step, an intuitive online editor is used to draw plot boxes (Figure 1B), which define the positions where the experimental data should be visualized. Each plot box can be assigned to one or more identifiers, either organism-specific (e.g. locus tags, GIs) or general (e.g. EC numbers, metabolite names). Data from the BKMS (Lang et al., 2011) and BRENDA (Jeske et al., 2019) databases are used to provide auto-completion of metabolites and enzymes, synonym matching, and cross-linking identifiers to other databases, e.g. BRENDA, KEGG, and MetaCyc. The identifier connects a row in the uploaded data set to a specific plot box. In the third step, any type of numerical data can be loaded in the browser and is visualized in the respective plot box (Figure 1C). Data must be in CSV-format, containing the identifiers that connect the data to plot boxes in the first row. Different types of visualization, like colour scales, a number of plot types (e.g. bar charts, line charts, heat maps), and other visual settings offer a high degree of customization. In the end, the pathway including the data visualization as well as legends can be downloaded in SVG or PNG-format.

Figure 1. The process of data visualization on MetaboMAPS.

(A) Upload the metabolic pathway in SVG format. Alternatively, you can use an existing pathway. (B) Draw plot boxes for metabolite (dashed border) and reaction (solid border) associated data. Assign identifiers to each plot box (e.g. EC numbers, locus tags, GI, metabolite synonyms, database IDs). (C) Load your own data set (as CSV file) and visualize reaction and metabolite dependent data simultaneously.

Software availability

Software available from: https://metabomaps.brenda-enzymes.org.

Source code available from: https://github.com/JuliaHelmecke/MetaboMAPS.

Archived source code at time of publication: https://doi.org/10.5281/zenodo.3742817 (Helmecke, 2020).

License: GNU General Public License v3.0 or later.