# Explore and understand your results

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2F1LRxmv1jUKrANbBukfu7%2FScreenshot%202025-02-26%20at%2010.13.59%20AM.png?alt=media&#x26;token=dbf22d73-37ae-47cc-8df1-5446e332c057" alt=""><figcaption><p>Query Language Results Page</p></figcaption></figure>

## Quick Action Toolbar

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FbSrGK8LqOGy8VDs0eEmR%2FScreenshot%202025-02-26%20at%2010.08.01%20AM.png?alt=media&#x26;token=346634c5-f503-46b1-94c9-0ef5dec82e9d" alt=""><figcaption><p>Quick Action Toolbar</p></figcaption></figure>

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.&#x20;

**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. ](https://docs.biobox.io/guide/how-to/ask-multi-modal-questions/ask-questions-with-query-language/modify-queries-using-the-query-editor)

**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.](https://restapi.docs.biobox.io/#ca543f31-cb75-4cb6-93ac-13a06fd3b362)&#x20;

**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**&#x20;

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.  ](https://docs.biobox.io/guide/how-to/ask-multi-modal-questions/ask-questions-with-query-language/visualize-data-returned-in-query-language)

**Add Custom Data Table**

This will allow you to add a data table and customize the data properties in the table.&#x20;

**Natural Language Query Generator**&#x20;

[AI Agent Orion](https://docs.biobox.io/guide/how-to/ask-multi-modal-questions/ask-questions-with-natural-language-graphrag/use-agent-orion-to-generate-a-query-with-natural-language) converts natural language into query language, without having to write in query language.&#x20;

## 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.&#x20;

For the question&#x20;

> Which genes are upregulated in differential expression datasets where the experimental group is diagnosed with endometrium adenocarcinoma?&#x20;

The following query was generated&#x20;

{% code overflow="wrap" %}

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

{% endcode %}

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.&#x20;

{% embed url="<https://www.loom.com/share/5194c321c9034adab3fe755003af8da0?sid=a44aa05c-d8bc-4d4b-933c-8b92baded4f7>" %}
Exploring the Query Language Object View
{% endembed %}

## Path Results&#x20;

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. <br>

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2Fe1snA8AdYEfDPCpeuH5a%2FScreenshot%202024-11-28%20at%202.53.57%20PM.png?alt=media&#x26;token=ca99d45a-0585-466d-ad6c-f26874fc591b" alt=""><figcaption><p>Query Language Path Results </p></figcaption></figure>

{% embed url="<https://www.loom.com/share/3b7409c7836247a68406361e378ed2f8?sid=ef12315d-cdc0-41af-953a-d41264919ac1>" %}
Query Language Path Results
{% endembed %}

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 <mark style="color:blue;">**"load additional paths"**</mark>  drop down.&#x20;

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"

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FQj03XacwIyE9WVDyIm7A%2FScreenshot%202024-11-28%20at%203.01.48%20PM.png?alt=media&#x26;token=b6bf62e9-9e36-4a46-8e01-cb7349d60fba" alt=""><figcaption></figcaption></figure>

## Saving and Rerunning Queries&#x20;

Any query that is generated can be saved and relaunched within seconds. To save a query, select <mark style="color:blue;">**"Save Query"**</mark> 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.&#x20;

{% embed url="<https://www.loom.com/share/3f89933e6cc746db99832ed0085b352c?sid=a4fa07cd-7326-40eb-b780-83fc9ec3b864>" %}
Saving and relaunching queries
{% endembed %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.biobox.io/guide/how-to/ask-multi-modal-questions/ask-questions-with-query-language/explore-and-understand-your-results.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
