AOP Mapper User Guide

AOP Mapper URL: https://enanomapper.adma.ai/aop/

Overview

The AOP Mapper is an interactive web tool designed to facilitate the exploration and analysis of Adverse Outcome Pathways (AOPs). It enables users to visualize and query relationships among all AOP-Wiki object types, including Molecular Initiating Events (MIEs), Key Events (KEs), Key Event Relationships (KERs), Key Event Components (biological objects, processes and actions), and Adverse Outcomes (AOs). In addition, it incorporates associated data such as chemicals, stressors, and assays—where assays are extracted during preprocessing from the measurement methods described in Key Events.

Implementation

The AOP Mapper is a user interface that operates on a Apache Solr index generated from the AOP-Wiki XML file (version 2025-07-01), downloaded from https://aopwiki.org/downloads. The Solr index is built by a separate Python pipeline as part of the preprocessing workflow.

Query Fields

The query interface is located at the top of the page and includes the following fields:

First row - free text, identifier and graph options

AOP Wiki Search - Free text
ID - Enter a specific object identifier (e.g., AOP123, KE77) to retrieve information about a particular AOP, KE, KER ...
Graph Traversal - Select the number of upstream and downstream steps to visualize in the AOP network. Options range from None, Upstream 1 to Upstream 5 and Downstream -1 to Downstream -5, AOP graph. If not None, the query results are extended with corresponding items of the AOP network.

Second row - additional filters

Type in to get suggestions, then select from the list.

Biological Events - Specify biological process, action, or object.
Applicability Taxonomy - Filter results based on the applicability of the AOP to different species or contexts.
MIE - Select key event, which is denoted as an molecular initiating event.
Adverse outcomes - Select key event, which is denoted as an adverse outcome.
Measurement Methodology - Specify the methodology used in the measurement (e.g., ELISA, microscopy).
Stressors - Input the name or CAS number of a chemical stressor to find related AOPs.

Third row - Result types

Choose the types of results to include in the search

AOP
KE (key events)
Chemical
Stressor
Assay
Bio process
Bio object
Bio action
Bio event - this is the triple (Bio object - Bio process - Bio action)
Taxonomy
KER (key event relationship)

After entering the desired criteria, click the Search button to update the results and visualize the corresponding network graph.

Results

The bottom of the page is structured as tabs. The default tab is the results table.

The results are listed in a paginated table. The first column contains the item identifier, with a link to the AOP wiki , where available.

View and download (Network graph)

If there are results displayed, switching to the View & Download tab will generate a network graph, which displays:

Nodes - Represent KEs, AOs, stressors, chemicals and assays. Hovering over a node shows a tooltip with a brief description. Clicking a node opens detailed information in the side panel (TBD).
Edges - Indicate relationships between nodes, such as causal links between KEs. The links are based on merged adjacent KER, but the KERs are not displayed (TBD optional).
Graph Controls -
- Zoom: Use the mouse scroll wheel or pinch gestures to zoom in and out.
- Pan: Click and drag the background to move the graph.
- Layout Options: Switch between different layout algorithms (e.g., force-directed, hierarchical) for optimal visualization.
- Reset View: Click the reset button to return to the default graph view.
Download button to download the hits as a CSV file for offline analysis.

Example Queries

Switch to the Example queries tab and click on a tag. It will load the query fields. Click Search to run the query.

Help

Link to the AOP Mapper User Guide (this document)

Debug info

shows the query or an error message