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
Last synced: 6 months ago · JSON representation

Repository

Data analysis code of the first-in-human paper

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

README.md

example-result


An MRI-assay for drug-induced inhibition of liver transporters: first-in-human study

Code License: Apache 2.0 Data License: CC BY 4.0 Jupyter Notebook DOI Input Data Input 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. 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.

TRISTAN

👥 Contributors

Eve Shalom
Eve Shalom

Steven Sourbron
Steven Sourbron

Owner

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

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

All Time
  • Total Commits: 23
  • Total Committers: 1
  • Avg Commits per committer: 23.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 23
  • Committers: 1
  • Avg Commits per committer: 23.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email 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

requirements.txt pypi
  • matplotlib *
  • miblab *
  • numpy *
  • pandas *
  • pingouin *
  • pydmr *
  • seaborn *
src/stages/setup.py pypi