For the complete documentation index, see llms.txt. This page is also available as Markdown.
delta report

🎯Create delta reports to compare prioritization frameworks

Understand how changes in scientific criteria and data availability impact ranking and prioritization across your organization. Explore how and why previous decisions were made.

A delta report is a snapshot of your data and prioritization criteria at a specific point in time. By comparing two reports, your team can see exactly what changed in the prioritization and why.

Delta reports help you answer questions like:

  • What led to the de-prioritization of a target or a disease-relevant cell population?

  • How does a target of interest rank across multiple prioritization frameworks?

  • How does my top target hold up when I remove GWAS evidence and focus on internal scRNA and proteomic expression?

And many more.

Before you start

Delta reports are built on top of a graph model and its underlying reports, so you'll need both in place first. If you haven't set those up yet, see configuring graph models and how to create reports.

The two types of delta reports

There are two ways to compare reports, depending on the question you're asking:

  1. Compare archived and live reports in a single model. Use this to see how rankings shift over time as new data and scientific criteria are added to a model.

  2. Compare one object's ranking across models. Use this to see how a single target ranks under different scientific criteria and hypotheses, with each model representing a different way of thinking about the problem.

This guide walks through both, using a running example: understanding how the prioritization of gene targets for Amyotrophic Lateral Sclerosis (ALS) has changed, and uncovering how institutional knowledge, prioritization criteria, and data have driven those changes.


From the top application toolbar, open the Graph Models tab. Then, in the left-hand side panel, select Delta Reports.

Click Create a New Report. You'll be prompted to choose which type of report you want to build.

Choose your report type

Pick the comparison that matches your question:

  • Comparing Archived vs. live reports shows how the ranking of objects has changed over time as the data and scientific criteria in that model evolved.

  • One object across multiple models lets you select several models and see how the different scientific criteria and hypotheses built into each one affect where that object lands.

The next steps depend on which type you chose. Follow the path that matches your selection.


Comparing archived and live reports in a single model

This report shows how the ranking of objects has changed over time as the data and scientific criteria in that model have evolved.

1

Step 1: Select Intention

Select "Compare Archived and Live reports in a Single Model"

2

Step 2: Configure the report

First, select the graph model you want to use for the comparison.

Next, select the anchor object. The anchor is the context everything is grounded in. To see how gene targets for a disease have changed over time, you'd set a disease such as Amyotrophic Lateral Sclerosis as the anchor object.

Once an anchor is set, BioBox displays the archived and live reports available for that anchor. Select the reports you want to compare.

3

Step 3: Review the results

You'll see every ranked object laid out across the reports you selected, which enables you to compare them side by side.

To focus on a single object, select the two reports you want to compare and search for a gene. This shows exactly how that target's ranking changed over time and what contributed to the change.


Comparing an object's ranking across models

This report lets you select several models and see how the different scientific criteria and hypotheses built into each one affect where that object ranks.

1

Step 1: Select Intention

Select "Compare a specific object's ranking across models".

2

Step 2: Configure the report

First, select the object you want to track, for example a specific gene target you're evaluating for ALS.

Next, select the models you want to compare. Each model brings your team's reasoning and scientific criteria, so this is where you decide which frameworks to put side by side. For instance, you might compare a model weighted toward GWAS evidence against one built around internal scRNA and proteomic expression.

3

Step 3: Review the results

Search for a target, and you'll see how it ranks in each model, along with the criteria that drove the differences. This makes it clear why a target rises under one framework and falls under another.

When you're done, you can save the report for later. All saved reports will be available for exploration on the delta report home page.

Last updated