🧭Explore and understand your results

How to explore and interpret the results returned from the Query Language

Query Language Results Page

Quick Action Toolbar

Quick Action Toolbar

Below the search bar containing your query you will see some quick actions Save Query This will allow you to provide a name, description and save the query. All queries are accessible using the left hand toolbar.

Query Editor This will open the query editor which will allow you to edit the query without having to write in query language. A detailed explanation of how to use the query editor can be found here.

Copy API

This will provide you with the curl request associated with the API call for the specific query you have searched. Our API documentation can be found here.

Path Results

This will switch your view from "Object View" where you can see all of the individual objects that satisfy your search criteria to "Path Results" where you can see the individual graph paths that satisfy the query.

Add Visualization

This will allow you to add a box plot or scatter plot to visualize quantitative data returned in your results. A detailed break down of how to create and customize these visualizations can be found here.

Add Custom Data Table

This will allow you to add a data table and customize the data properties in the table.

Natural Language Query Generator

AI Agent Orion converts natural language into query language, without having to write in query language.

Object View

Once you have launched a query you will be taken to the object view. This is where you can see all of the individual objects (data points) that answer your question.

For the question

Which genes are upregulated in differential expression datasets where the experimental group is diagnosed with endometrium adenocarcinoma?

The following query was generated

(Gene)<- upregulates <-(DifferentialExpressionDataset)-> experimental group includes ->(TumorSample)-> pathologically confirmed to be ->(Disease{displayName="endometrium adenocarcinoma"}) 

The table displays all of the objects associated with each concept within this query. This includes all of genes, differential expression datasets, tumour samples and diseases. You can filter on any of the data properties associated with each concept. For example, search for genes on a specific chromosome or with a specific display name. The list of objects returned for each concept can be exported as a JSON or CSV.

Exploring the Query Language Object View

Path Results

The path results allow you to explore the individual graph paths that answer the query. To access the path results select "Path Results" located under the search bar. For the example above, it will display the individual gene identified in a specific differential dataset with a specific tumour sample that was diagnosed with endometrium carcinoma.

Query Language Path Results

Query Language Path Results

By selecting a query you can explore all of data properties associated with each path. For example the specific logR and P values embedded in the "upregulates" relationship. Initially, 25 paths are displayed. More paths can be added using the "load additional paths" drop down.

The inputs listed beneath each concept can be utilized to search for paths containing a specific object. For example paths where the gene is "SOX4"

Saving and Rerunning Queries

Any query that is generated can be saved and relaunched within seconds. To save a query, select "Save Query" under the search bar. Provide a name and description for the query. All saved queries are accessible from the left hand side bar. Select a saved query to relaunch it.

Saving and relaunching queries