tristan-human-stage-3-analysis
Data analysis code of the first-in-human paper
https://github.com/openmiblab/tristan-human-stage-3-analysis
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 2 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 (10.7%) to scientific vocabulary
Repository
Data analysis code of the first-in-human paper
Basic Info
Statistics
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 2
Metadata Files
README.md

An MRI-assay for drug-induced inhibition of liver transporters: first-in-human study
📚 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. An analysis pipeline was developed which generates measurements from signal-time curves in liver and aorta.
The pipeline in this repository was used to derive results in the first-in-human study, which measured the effect of the drug rifampicin on the biomarkers produced by the assay, in 8 healthy volunteers.
🛠️ Methodology
The inputs to the pipeline are metrics produced by the assay for primary and secondary objectives, saved in a persistent data archive as two separate datasets: - tristanhumanshealthyrifampicinall_results: MRI biomarkers in subjects with successful treatment visits - tristanhumanshealthycontrolsall_results: MRI biomarkers in subjects with baseline visits only.
Also source data on the study participants such as basic demographics and liver function tests, saved in the source data archive of the study as: - tristanhumanshealthyrifampicindata: clinical covariates such as demographics and blood-based liver function tests in all subjects.
The output is the effect of the drugs on primary and secondary endpoints, as well as results for additional questions such as correlations between baseline values and with effect sizes measured by conventional liver function tests. The pipeline computes the statistics and generates tables and figures for internal reporting and inclusion in the publication.
💻 Usage
The pipeline can be run after installing the requirements:
console
pip install -r requirements.txt
The folder build contains the output of the analysis. To reproduce it, delete the build folder and run the script src/run.py. This takes less than a minute on a standard laptop computer and should recreate all results in the build folder.
Alternatively run the jupyter notebook src/run.ipynb which reproduces all results interactively and has explanations and results interleaved with the code for better understanding of the methodology.
📄 Code structure
The src folder contains all the source code, with the top level entry scripts run.py and src/run.ipynb. These call functions in the subfolder stages.
The build folder contains the output of the top level scripts. It can be deleted and will be fully rebuilt when running the script. The build folder has the following contents:
- Report.pdf is a compact summary of all key outputs. It is built in LaTeX and the folder Report_source contains the source LaTeX files.
- Data: contains the downloaded data and their modifications by the script src/stages/data.py.
- Figs: Figures produced by src/stages/plot.py.
- Tables: tables and numerical results produced by src/stages/desc.py and src/stages/calc.py.
❤️ Citation
The manuscript is under review. A summary of results was presented at the ISMRM (Singapore 2024):
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
Eve Shalom |
Steven Sourbron |
Owner
- Name: openmiblab
- Login: openmiblab
- Kind: organization
- Repositories: 1
- Profile: https://github.com/openmiblab
GitHub Events
Total
- Release event: 1
- Push event: 11
- Create event: 1
Last Year
- Release event: 1
- Push event: 11
- Create event: 1
Committers
Last synced: 8 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Steven Sourbron | s****n@s****k | 23 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 8 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
- matplotlib *
- miblab *
- numpy *
- pandas *
- pingouin *
- pydmr *
- seaborn *
