Docs | BioBox Platform
GuideAPIRelease NotesLog In
  • Welcome to BioBox!
  • Framework
    • Overview
    • Why Graph?
    • Core Concepts
  • Data Packages
    • Data Packages
    • External Ontologies
      • Gene Ontology
      • Tissue
      • Disease
      • Cell Ontology
      • Phenotype
  • How To
    • 🧭Configure your Knowledge Graph Schema
      • πŸ—‚οΈFormat Internal Data For Uploading
      • ‴️Upload Internal Data
    • βš–οΈCreate Prioritization Graph Models
      • πŸ—’οΈGenerate Reports
      • πŸ›£οΈPathway Enrichment
    • πŸ—ΊοΈUse the Graph Explorer
      • βš™οΈRunning Graph Algorithms
      • πŸ’ΎSave Graph Explorer Sessions
    • πŸ”—Use the Query Language
      • Customize the data table returned with your query
      • 🧭Explore and understand your results
      • πŸ“ŠVisualize data returned in Query Language
      • ✏️Modify Queries using the Query Editor
    • Ask questions with Natural Language (GraphRAG)
      • Use Agent Orion to generate a query with Natural Language
      • Use Agent Iris to converse with your data
  • πŸ“ŠVisualize data on the Legacy Platform
    • πŸ“„Create a Genomic Sequencing Dashboard (Legacy Platform)
    • 🍭Create a Stacked Lollipop Plot (Legacy Platform)
    • ↕️Upload raw data (Legacy Platform)
    • πŸ“«Invite Users to Your Organization
  • Release Notes
Powered by GitBook
On this page
  • Quick Action Toolbar
  • Object View
  • Path Results
  • Saving and Rerunning Queries
  1. How To
  2. Use the Query Language

Explore and understand your results

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

PreviousCustomize the data table returned with your queryNextVisualize data returned in Query Language

Last updated 3 months ago

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.

Copy API

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

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

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.

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.

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.

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

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

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

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

πŸ”—
🧭
can be found here.
can be found here.
can be found here.
AI Agent Orion
Exploring the Query Language Object View
Query Language Path Results
Saving and relaunching queries
Query Language Results Page
Quick Action Toolbar
Query Language Path Results