tristan-human-stage-2-modelling

Model fitting developed for the tristan project

https://github.com/openmiblab/tristan-human-stage-2-modelling

Science Score: 59.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 11 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    1 of 1 committers (100.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.3%) to scientific vocabulary
Last synced: 6 months ago · JSON representation

Repository

Model fitting developed for the tristan project

Basic Info
  • Host: GitHub
  • Owner: openmiblab
  • License: apache-2.0
  • Language: Jupyter Notebook
  • Default Branch: main
  • Size: 268 MB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 4
Created about 2 years ago · Last pushed 9 months ago
Metadata Files
Readme License Zenodo

README.md

example-result


Measuring drug-mediated inhibition of liver transporters

Code License: Apache 2.0 Data License: CC BY 4.0 DOI Input Data Output Data

Context

The liver is responsible for filtering waste products from the blood, and evacuating these by excreting them to bile. Drugs commonly affect these procesesses, potentially leading to toxic side effects.

If a drug inhibits excretion into the bile, then harmful material can get stuck in liver cells and cause damage to the liver. This is commonly referred to as drug-induced liver injury (DILI). If a drug on the other hand blocks the uptake of these materials into the liver, they will circulate in the blood for too long and may cause harm elsewehere.

When dealing with novel drugs, either in basic research or drug development, it is often unknown to what extent a drug affects the uptake or excretion into the liver. This can expose trial participants to significant risk, or even patients in clinical practice if the risk is not identified during development.

In order to mitigate these risks, the TRISTAN project developed an MRI-based method to measure the effect of drugs in liver transporters directly. Proof of concept was provided in preclinical studies and pilot studies in humans, showing that the method is able to detect inhibition of uptake and excretion caused by drugs.

The pipeline in this repository was used to generate the results in humans. It can be used to reproduce them independently, but also to analyse new data acquired in the same way.

What does it do?

The inputs to the pipeline are signal-time curves in regions-of-interest in the liver and aorta, using a dynamic gadoxetate-enhanced MRI acquisition, of any number of human subjects. The data must be in .dmr format as in this repository with data acquired during the TRISTAN project:

The outputs are measurements of gadoxetate uptake rates into hepatocytes, and excretion rates into bile, as well as secondary results such as extracellular volumes or systemic parameters like cardiac output. Key numerical results from the TRISTAN studies are saved in this database.

Apart from the main biomarkers, the pipeline creates plots, performs statistical analysis and summarises all results in pdf reports.

Code structure

The src folder contains all the source code, with the top level entry scripts, which call on functions in the subfolder methods.

The build folder contains the output produced by the scripts in src. It can be deleted and will be recreated by the scripts. The output of the script tristan.py is included in this repository as an example.

Usage

The pipeline can be run after installing the requirements:

console pip install -r requirements.txt

The main scripts in the src and all be run independently. They all reproduce results that were generated during the TRISTAN project, except for the script analyze_newdrug.py which is a template for future application of the pipeline to newly discovered drugds. The script analyze_rifampicin.py only generates the primary results, and the notebook with the same name analyze_rifampicin.ipynb is a narrative step-by-step guide to the calculation.

In order to reproduce existing results, delete the build folder and run the script tristan_all.py. The entire calculation may take several hours on a laptop computer. The pipeline will download its input data from a public archive. The local copy of the data is deleted after completion of the analysis.

In order to analyse a new drug with the same method, perform the following steps:

  1. Acquire data as laid out in the experimental protocol and derive signal-time curves (miblab pipeline for this part coming soon).

  2. Save your data in dmr format in the same way as the datasets on the public archive.

  3. Then run the script analyze_newdrug.py making sure to replace the placeholder values by those that describe your data. When the computation finishes, the results will be added to the build folder.

Citation

Thazin Min, Marta Tibiletti, Paul Hockings, Aleksandra Galetin, Ebony Gunwhy, Gerry Kenna, Nicola Melillo, Geoff JM Parker, Gunnar Schuetz, Daniel Scotcher, John Waterton, Ian Rowe, and Steven Sourbron. Measurement of liver function with dynamic gadoxetate-enhanced MRI: a validation study in healthy volunteers. Proc Intl Soc Mag Reson Med, Singapore 2024, 4015.

Funding

The work was performed as part of the TRISTAN project on imaging biomarkers for drug toxicity. The project was EU-funded through the Innovative Health Initiative.

TRISTAN

Contributors

Ebony Gunwhy
Ebony Gunwhy

Eve Shalom
Eve Shalom

Steven Sourbron
Steven Sourbron

Owner

  • Name: openmiblab
  • Login: openmiblab
  • Kind: organization

GitHub Events

Total
  • Release event: 2
  • Push event: 8
  • Create event: 3
Last Year
  • Release event: 2
  • Push event: 8
  • Create event: 3

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 30
  • Total Committers: 1
  • Avg Commits per committer: 30.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 27
  • Committers: 1
  • Avg Commits per committer: 27.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Steven Sourbron s****n@s****k 30
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 8 months ago

All Time
  • Total issues: 0
  • Total pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: less than a minute
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: less than a minute
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • plaresmedima (1)
Top Labels
Issue Labels
Pull Request Labels