tristan-rat-analysis

Analysis of the TRISTAN rat data

https://github.com/openmiblab/tristan-rat-analysis

Science Score: 46.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
  • 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.9%) to scientific vocabulary
Last synced: 9 months ago · JSON representation

Repository

Analysis of the TRISTAN rat data

Basic Info
  • Host: GitHub
  • Owner: openmiblab
  • License: apache-2.0
  • Language: Python
  • Default Branch: main
  • Size: 526 KB
Statistics
  • Stars: 0
  • Watchers: 0
  • Forks: 0
  • Open Issues: 0
  • Releases: 2
Created about 1 year ago · Last pushed about 1 year ago
Metadata Files
Readme License Zenodo

README.md

example-result


Measuring drug-mediated inhibition of liver transporters: analysis of TRISTAN rat data

Code License: Apache 2.0 Data License: CC BY 4.0 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 derives some key results from previous studies in rats published by the TRISTAN consortium. The analysis was done post-hoc as an illustration and replication excercise with new code, but does not aim to replicate the exact figures and tables from the manuscript.

🛠️ Methodology

The inputs to the pipeline are metrics produced by the assay for primary and secondary objectives, saved in a persistent data archive.

The output is the a number of figures summarising key findings from the rat studies.

💻 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.

📄 Code structure

The src folder contains all the source code, with the top level entry scripts run.py. This 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:

  • Data: contains the downloaded data.
  • Tables: tables and numerical results produced by src/methods/analysis.py.
  • Figs: Figures produced by src/methods/plot.py.

❤️ 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

Steven Sourbron
Steven Sourbron

Owner

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

GitHub Events

Total
  • Release event: 1
  • Push event: 1
  • Create event: 4
Last Year
  • Release event: 1
  • Push event: 1
  • Create event: 4

Committers

Last synced: 12 months ago

All Time
  • Total Commits: 4
  • Total Committers: 1
  • Avg Commits per committer: 4.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 4
  • Committers: 1
  • Avg Commits per committer: 4.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Steven Sourbron s****n@s****k 4
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

requirements.txt pypi
  • matplotlib ==3.10.3
  • miblab ==0.0.15
  • numpy ==2.3.0
  • pandas ==2.3.0
  • pydmr ==0.0.4