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
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
Metadata Files
README.md

Measuring drug-mediated inhibition of liver transporters
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:
Acquire data as laid out in the experimental protocol and derive signal-time curves (miblab pipeline for this part coming soon).
Save your data in dmr format in the same way as the datasets on the public archive.
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.
Contributors
Ebony Gunwhy |
Eve Shalom |
Steven Sourbron |
Owner
- Name: openmiblab
- Login: openmiblab
- Kind: organization
- Repositories: 1
- Profile: https://github.com/openmiblab
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
Top Committers
| Name | 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)
