KomaMRI v0.9.0
This new breaking release of Koma v0.9 has multiple new features. Thanks to @rkierulf, our GSoC student, for the GPU enhancements and @pvillacorta for the new motion definitions that enable flow and shareable phantoms.
(1) Device-agnostic kernel-based simulations (more info here)
We can now use various GPU backends with the help of KernelAbstractions.jl. This means that GPU-related packages like CUDA are not installed by default. Installation and loading of the desired GPU package is needed (for example ] add CUDA
, using CUDA
).
(2) New simulation method, faster and better
Now Bloch
has specialized implementations for CPU and GPU and the previous implementation is in BlochSimple
. This new simulation method is 4-5 times faster and uses around 80 times less memory. We have seen a 100-200x improvement in some sequences, especially if they have a lot of soft RF pulses.
(3) Distributed simulations (more info here)
We also tested distributed simulations with multiple GPUs and nodes :)
(4) GPU benchmarks (here)
We have a fancy new benchmarking page to ensure that there are no performance regressions.
(5)Phantom
's including flexible motions and flow (more experimental)
You can now plot phantoms with motion and define them using mix-and-match motion definitions! More complex phantoms are possible including simple motions or arbitrary motions. Many more examples of using them are coming soon! 😄 including a realistic CFD-simulated aorta! All of this is done using our new reproducible phantom definition (HDF5-based), which enables the sharing of these phantoms with complex motion.
Hope these changes make your simulations faster! 😄 As always, if you have any problems, feel free to talk to me (@cncastillo ) in Slack or post an issue or discussion on GitHub.
Merged pull requests:
- Motion Phantom (#184) (@pvillacorta)
- Bump codecov/codecov-action from 4.1.1 to 4.3.0 (#384) (@dependabot[bot])
- Bump julia-actions/setup-julia from 1 to 2 (#385) (@dependabot[bot])
- Tutorial for SimpleMotion creation and simulation (#387) (@pvillacorta)
- Update nightly.yml (#388) (@cncastillo)
- Adding "How to Cite Koma" section to docs (#389) (@cncastillo)
- Bump julia-actions/julia-format from 2 to 3 (#398) (@dependabot[bot])
- Update DisplayFunctions.jl (#402) (@curtcorum)
- Add Binder badge to Literate tutorials (#403) (@cncastillo)
- Extend GPU support to Metal, ROCm, and oneAPI backends (#405) (@rkierulf)
- Fix some test failures (#406) (@rkierulf)
- Optimize ArbitraryMotion (continuation) (#408) (@pvillacorta)
- Add Buildkite GPU pipeline (#411) (@rkierulf)
- Fix plot phantom function (#413) (@pvillacorta)
- Fixing testing environments for GPU backends (#415) (@cncastillo)
- Add kernel-based matrix cumsum (#416) (@rkierulf)
- Initial benchmarking implementation: steps to run benchmarks and comb… (#418) (@rkierulf)
- Fix typos in docstrings (#419) (@pvillacorta)
- [DOCS] Add JuliaHealth Star Counter Badge to README (#420) (@TheCedarPrince)
- Updates to github-action-benchmark index.html (#421) (@rkierulf)
- Fixing issues in Julia 1.11 and Julia 1.12 (#422) (@cncastillo)
- Fix monorepo script not working for pushes to main (#423) (@rkierulf)
- Change 'main' to 'master' so benchmarking action actually runs (#424) (@rkierulf)
- Including details about prints of simulate (#431) (@gsahonero)
- Bump to 0.9.0-DEV (#434) (@cncastillo)
- New Motion (#442) (@pvillacorta)
- Optimize run_spin_precession! and run_spin_excitation! for CPU (#443) (@rkierulf)
- Change
reduce(vcat, itr)
toreduce(vcat, [itr])
(#444) (@cncastillo) - Pkg version handling and choosable test backend for VSCode (#453) (@cncastillo)
- Pkg version handling and choosable test backend for VSCode (again) (#455) (@cncastillo)
- CompatHelper: bump compat for PlutoPlotly in [weakdeps] to 0.5 for package KomaMRIPlots, (keep existing compat) (#456) (@github-actions[bot])
- Fixing benchmark comments on PRs (#457) (@cncastillo)
- Optimize run_spin_precession! for GPU (#459) (@rkierulf)
- CompatHelper: bump compat for AMDGPU in [weakdeps] to 1 for package KomaMRICore, (keep existing compat) (#460) (@github-actions[bot])
- CompatHelper: bump compat for MRIReco to 0.9, (keep existing compat) (#461) (@github-actions[bot])
- Optimize run_spin_excitation! for GPU (#462) (@rkierulf)
- Fixing brain phantom values (#465) (@gsahonero)
- Add Distributed Examples to Documentation (#468) (@rkierulf)
- Include more specific SLURM instructions (#469) (@cncastillo)
- GSOC: Add GPU Explanation Section to Documentation (#470) (@rkierulf)
- Fix extra allocations when benchmarking with no motion (#483) (@pvillacorta)
- Fix bug in
plot_phantom_map
whenlength(obj)
>max_spins
(#485) (@pvillacorta) - Fix sum of
Grad
s (#486) (@pvillacorta) - Fix bugs related with
SpinRange
and flow (#488) (@pvillacorta) - Diffusion tutorial for isotropic diffusion (#489) (@tinorodriguez)
- Fix
plot_phantom_map
for dynamic phantoms (#490) (@pvillacorta) - Changing size of plot for diffusion example (#491) (@cncastillo)
- KomaMRI v0.9 (#492) (@cncastillo)
Closed issues:
- CUDA memory problems? (#125)
- Using BuildKite for GPU related CI? (#147)
- Use the same functions to sample RFs in the simulation than for plotting sequence (#167)
- Separate CI for more comprehensive results (#276)
- Add simulate function for debugging purposes (#288)
- Create Pluto example for fat_sat_low_field (#291)
- Reporting of phantom spatial sampling in obj.info structure. (#322)
- GSOC Proposal Issue Tracking: Part 1 (#349)
- GSOC Proposal Issue Tracking: Part 2 (#350)
- Extend GPU support to include Apple (Metal.jl), AMD (AMDGPU.jl), and Intel (OneAPI.jl) (#351)
- Profile Bloch Simulation Method (#352)
- Create new Kernel-based Simulation Method (#353)
- Use @LocalMem inside future kernel-based simulation functions to speed up memory access (#354)
- Add example of Multi-GPU simulation (#355)
- Add example and / or support for multi-node simulation (#356)
- Simplify ArbitraryMotion struct (#371)
- Re-use weights in interpolation for ArbitraryMotion (#372)
- Define
Nspins
for SimpleMotion (#376) - Applying @time to simulate reveals discrepancies on resources and timing reports (#392)
- plot_signal docstring (correction) (#401)
- [KomaUI Plotting] obj_ui[] does not draw on first time updated. Need to press :rho or other option. (#407)
- New motion approach to combine SimpleMotion and ArbitraryMotion into the same phantom (#410)
- Future: use @testsetup to reduce time to run tests on GPU (#414)
- Problems initializing KomaUI (#432)
- Brain phantom values inconsistencies (#464)
spin_reset
haseltype
T and should be anAbstractMatrix{Bool}
(#479)