Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Flexibilize the definition of motion time spans #531

Open
wants to merge 6 commits into
base: master
Choose a base branch
from

Conversation

pvillacorta
Copy link
Collaborator

@pvillacorta pvillacorta commented Jan 2, 2025

This PR arises from the need to create motion patterns that are currently not replicable in Koma. An example is the figure below, taken from this paper, which shows the temporal evolution of a contraction and torsion motion in the myocardium:

image

This time curve cannot be replicated either with the TimeRange structure or the Periodic structure, so a new structure called TimeCurve has been defined, which can replicate any arbitrary temporal behaviour.

In fact, the TimeRange and Periodic structures may no longer be necessary if the efficiency of the unit_time function with a TimeCurve is better or at least equal to the corresponding unit_time implementations with TimeRange and Periodic. Efficiency checks are still pending.

Additionally, I want to add a field to account for pseudo-periodic motion patterns such as arrhythmias.

https://juliahealth.org/KomaMRI.jl/previews/PR531/

- New `TimeCurve` struct and
- Slight changes in `times` and `sort_motions!`
- Allow to and export Booleans in KomaMRIFiles/Phantom.jl
- Change default `TimeRange` in `Motion` constructors from `[-1,0]` to `[0,eps]`
- Rename `duration` to `periods` in TimeCurve.jl, Motion.jl and MotionList.jl
- Improve docstrings in TimeCurve.jl
- Add new figures and remove old ones
- Improve docstrings of `TimeCurve` and its custom constructors.
- Add figures to `TimeRange` and `Periodic` docstrings
- Remove `unit_time` docstring, since it is not exported
@pvillacorta pvillacorta added documentation Improvements to docs., it also triggers doc preview enhancement New feature or request performance labels Jan 4, 2025
@pvillacorta pvillacorta marked this pull request as ready for review January 4, 2025 22:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements to docs., it also triggers doc preview enhancement New feature or request performance
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants