DIRECT

DIRECT: Deep Image REConstruction Toolkit - Published in JOSS (2022)

https://github.com/nki-ai/direct

Science Score: 98.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 7 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: arxiv.org, pubmed.ncbi, ncbi.nlm.nih.gov, sciencedirect.com, joss.theoj.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords

deep-learning fastmri-challenge inverse-problems medical-imaging mri-reconstruction pytorch

Keywords from Contributors

mesh
Last synced: 4 months ago · JSON representation ·

Repository

Deep learning framework for MRI reconstruction

Basic Info
Statistics
  • Stars: 281
  • Watchers: 4
  • Forks: 45
  • Open Issues: 5
  • Releases: 12
Topics
deep-learning fastmri-challenge inverse-problems medical-imaging mri-reconstruction pytorch
Created over 5 years ago · Last pushed 6 months ago
Metadata Files
Readme Contributing License Code of conduct Citation Authors

README.rst

.. raw:: html

   

DIRECT: Deep Image REConstruction Toolkit
.. raw:: html

JOSS TOX Pylint Black Codacy Codecov

InstallationQuick StartDocumentationModel Zoo


``DIRECT`` is a Python, end-to-end pipeline for solving Inverse Problems emerging in Imaging Processing. It is built with PyTorch and stores state-of-the-art Deep Learning imaging inverse problem solvers such as denoising, dealiasing and reconstruction. By defining a base forward linear or non-linear operator, ``DIRECT`` can be used for training models for recovering images such as MRIs from partially observed or noisy input data. ``DIRECT`` stores inverse problem solvers such as the vSHARP, Learned Primal Dual algorithm, Recurrent Inference Machine and Recurrent Variational Network, which were part of the winning solutions in Facebook & NYUs FastMRI challenge in 2019, the Calgary-Campinas MRI reconstruction challenge at MIDL 2020 and the CMRxRecon challenge 2023. For a full list of the baselines currently implemented in DIRECT see `here <#baselines-and-trained-models>`_. .. raw:: html
Zero-filled reconstruction, Compressed-Sensing (CS) reconstruction using the BART toolbox, Reconstruction using a RIM model trained with DIRECT
Projects -------- In the `projects `_ folder baseline model configurations are provided for each project. Baselines and trained models ---------------------------- We provide a set of baseline results and trained models in the `DIRECT Model Zoo `_. Baselines and trained models include the `vSHARP `_, `Recurrent Variational Network (RecurrentVarNet) `_, the `Recurrent Inference Machine (RIM) `_, the `End-to-end Variational Network (VarNet) `_, the `Learned Primal Dual Network (LDPNet) `_, the `X-Primal Dual Network (XPDNet) `_, the `KIKI-Net `_, the `U-Net `_, the `Joint-ICNet `_, and the `AIRS Medical fastmri model (MultiDomainNet) `_. License and usage ----------------- DIRECT is not intended for clinical use. DIRECT is released under the `Apache 2.0 License `_. Citing DIRECT ------------- If you use DIRECT in your own research, or want to refer to baseline results published in the `DIRECT Model Zoo `_\ , please use the following BiBTeX entry: .. code-block:: text @article{DIRECTTOOLKIT, doi = {10.21105/joss.04278}, url = {https://doi.org/10.21105/joss.04278}, year = {2022}, publisher = {The Open Journal}, volume = {7}, number = {73}, pages = {4278}, author = {George Yiasemis and Nikita Moriakov and Dimitrios Karkalousos and Matthan Caan and Jonas Teuwen}, title = {DIRECT: Deep Image REConstruction Toolkit}, journal = {Journal of Open Source Software} }

Owner

  • Name: NKI AI for Oncology Lab
  • Login: NKI-AI
  • Kind: organization
  • Location: Netherlands

The AI for Oncology Lab's mission to is to develop AI innovations which improve cancer diagnosis and therapy.

JOSS Publication

DIRECT: Deep Image REConstruction Toolkit
Published
May 30, 2022
Volume 7, Issue 73, Page 4278
Authors
George Yiasemis
Netherlands Cancer Institute, University of Amsterdam
Nikita Moriakov
Netherlands Cancer Institute, Radboud University Medical Center
Dimitrios Karkalousos
Amsterdam UMC, Biomedical Engineering and Physics
Matthan Caan
Amsterdam UMC, Biomedical Engineering and Physics
Jonas Teuwen
Netherlands Cancer Institute, University of Amsterdam, Radboud University Medical Center
Editor
Øystein Sørensen ORCID
Tags
Pytorch Deep Learning Inverse Problem Solver Image Processing Deep MRI reconstruction Accelerated MRI

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - family-names: Yiasemis
    given-names: George
    email: g.yiasemis@nki.nl
    orcid:  https://orcid.org/0000-0002-1348-8987
  - family-names: Moriakov
    given-names: Nikita
    email: n.moriakov@nki.nl
    orcid:  https://orcid.org/0000-0002-7127-1006
  - family-names: Karkalousos
    given-names: Dimitrios
    email: d.karkalousos@amsterdamumc.nl
    orcid: https://orcid.org/0000-0001-5983-0322
  - family-names: Caan
    given-names: Matthan
    email: m.w.a.caan@amsterdamumc.nl
    orcid: https://orcid.org/0000-0002-5162-8880
  - family-names: Teuwen
    given-names: Jonas
    email: j.teuwen@nki.nl
    orcid:  https://orcid.org/0000-0002-1825-1428
title: "DIRECT: Deep Image REConstruction Toolkit"
doi: 10.21105/joss.04278
url: https://doi.org/10.21105/joss.04278
journal: Journal of Open Source Software
publisher: he Open Journal
volume: "7"
number: "73"
pages: "4278"
year: "2022"

GitHub Events

Total
  • Issues event: 8
  • Watch event: 43
  • Delete event: 7
  • Issue comment event: 7
  • Push event: 49
  • Pull request review event: 3
  • Pull request event: 8
  • Fork event: 6
  • Create event: 11
Last Year
  • Issues event: 8
  • Watch event: 43
  • Delete event: 7
  • Issue comment event: 7
  • Push event: 49
  • Pull request review event: 3
  • Pull request event: 8
  • Fork event: 6
  • Create event: 11

Committers

Last synced: 5 months ago

All Time
  • Total Commits: 603
  • Total Committers: 7
  • Avg Commits per committer: 86.143
  • Development Distribution Score (DDS): 0.272
Past Year
  • Commits: 4
  • Committers: 2
  • Avg Commits per committer: 2.0
  • Development Distribution Score (DDS): 0.25
Top Committers
Name Email Commits
Jonas Teuwen j****n@g****m 439
George Yiasemis g****s@h****m 90
Dimitrios Karkalousos d****s@g****m 28
deepsource-autofix[bot] 6****] 24
wdika d****s@a****l 19
George Yiasemis g****s@a****l 2
dependabot[bot] 4****] 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 48
  • Total pull requests: 63
  • Average time to close issues: about 1 month
  • Average time to close pull requests: 22 days
  • Total issue authors: 21
  • Total pull request authors: 4
  • Average comments per issue: 1.81
  • Average comments per pull request: 0.54
  • Merged pull requests: 48
  • Bot issues: 0
  • Bot pull requests: 7
Past Year
  • Issues: 5
  • Pull requests: 11
  • Average time to close issues: 3 months
  • Average time to close pull requests: about 2 months
  • Issue authors: 3
  • Pull request authors: 3
  • Average comments per issue: 1.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 4
  • Bot issues: 0
  • Bot pull requests: 6
Top Authors
Issue Authors
  • georgeyiasemis (13)
  • zwep (8)
  • NayeeC (3)
  • chenGTMES (2)
  • kingaza (2)
  • jonasteuwen (2)
  • estenhl (2)
  • SHUGOSHAx (2)
  • amirshamaei (2)
  • osorensen (1)
  • zg-young (1)
  • XiaoMengLiLiLi (1)
  • osbm (1)
  • Winnie-xwj (1)
  • yilmazkorkmaz1 (1)
Pull Request Authors
  • georgeyiasemis (67)
  • dependabot[bot] (8)
  • jonasteuwen (4)
  • danielskatz (1)
Top Labels
Issue Labels
enhancement (21) bug (16) Stale (11) better engineering (2) question (1) help wanted (1) documentation (1)
Pull Request Labels
python (63) documentation (33) ci (16) dependencies (8) better engineering (4) enhancement (3) bug (3) docker (2) javascript (1)

Dependencies

.github/workflows/black.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • psf/black 22.1.0 composite
.github/workflows/coverage.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • codecov/codecov-action v1 composite
.github/workflows/pr-labels.yml actions
  • actions/labeler v2 composite
.github/workflows/pylint.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v1 composite
.github/workflows/stale.yml actions
  • actions/stale v3 composite
.github/workflows/tox.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
docker/Dockerfile docker
  • nvidia/cuda ${CUDA}-devel-ubuntu18.04 build
setup.py pypi
  • h5py ==3.3.0
  • numpy >=1.21.2
  • omegaconf ==2.1.1
  • protobuf ==3.20.1
  • scikit-image >=0.19.0
  • scikit-learn >=1.0.1
  • tensorboard >=2.7.0
  • torch >=1.10.2
  • torchvision *
  • tqdm *
pyproject.toml pypi