tristan-rat-modelling
Kinetic analysis using the TRISTAN rat assay for transported-mediated drug inhibition
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 19 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 (13.3%) to scientific vocabulary
Repository
Kinetic analysis using the TRISTAN rat assay for transported-mediated drug inhibition
Basic Info
- Host: GitHub
- Owner: openmiblab
- License: apache-2.0
- Language: Python
- Default Branch: main
- Size: 11.2 MB
Statistics
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
- Releases: 2
Metadata Files
README.md

Measuring drug-mediated inhibition of liver transporters in rats
📚 Context
The liver is responsible for filtering waste products from the blood, and evacuating these by excreting them to bile. Drugs commonly affect these processes, 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, using a dynamic gadoxetate-enhanced MRI acquisition, of any number of rats. The data must be in .dmr format as in this repository.
The outputs are measurements of gadoxetate uptake rates into hepatocytes, and excretion rates into bile. Key numerical results from the TRISTAN studies are saved in this database.
Apart from the main biomarkers, the pipeline creates plots for visual checking of individual results.
📄 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. It has the following substructure:
- Inputs: Datasets with signal-time curves downloaded from the data repository.
- Outputs: Numerical values for all subjects and all scans, summarised as one dmr file per study. These files have been uploaded to this database for further analysis.
- Results: One folder per study containing more detailed single-subject results: numerical values per subject and per scan, and plots per subject and per scan to check for goodness-of-fit.
💻 Usage
The pipeline can be run after installing the requirements:
console
pip install -r requirements.txt
The main scripts are in src and can be run independently. The script src/tristan.py reproduces the results generated in various studies during the TRISTAN project, and which have been secured in this database. The script src/newdrug.py can be used to generate results for a new drug.
In order to reproduce existing results, delete the build folder and run the script tristan.py. 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 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
Melillo N, Scotcher D, Kenna JG, Green C, Hines CDG, Laitinen I, Hockings PD,
Ogungbenro K, Gunwhy ER, Sourbron S, et al. Use of In Vivo Imaging and
Physiologically-Based Kinetic Modelling to Predict Hepatic Transporter
Mediated Drug–Drug Interactions in Rats. Pharmaceutics. 2023; 15(3):896.
[DOI] <https://doi.org/10.3390/pharmaceutics15030896>_
💰 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 |
Steven Sourbron |
Owner
- Name: openmiblab
- Login: openmiblab
- Kind: organization
- Repositories: 1
- Profile: https://github.com/openmiblab
GitHub Events
Total
- Release event: 1
- Push event: 3
- Create event: 3
Last Year
- Release event: 1
- Push event: 3
- Create event: 3
Committers
Last synced: 12 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Steven Sourbron | s****n@s****k | 9 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 12 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- dcmri ==0.6.17
- miblab ==0.0.14
- numpy ==2.3.0
- pydmr ==0.0.4
- tqdm ==4.67.1
