Spin-Scenario: A flexible scripting environment for realistic MR simulations
Yan Chang1, Daxiu Wei2, Huihui Jia3
1Suzhou Institute of Biomedical Engineering and Technology, Chinese Academy of Sciences, 215163 Suzhou, China; University of Chinese Academy of Sciences, China.
Abstract:
In this paper we present a new open source package, Spin-Scenario, aimed at developing an intuitive, flexible and unique scripting framework able to cover many aspects of simulations in both MR imaging and MR spectroscopy. For this purpose, we adopted the Liouville space model as the standard computing engine and let the consequent computational burden be afforded by parallel computing techniques. Benefitting from the powerful Lua scripting language, the pulse sequence programming syntax was specially designed to offer an extremely concise way of scripting. Moreover, the built-in dataflow graph based optimal control scheme enables an efficient optimization of shaped pulses or multiple cooperative pulses for real-life experiment evaluations. As the name states, the users are expected to be able to realize their creative ideas like a scenarist that creates a scenario script and looks at the spin actors acting accordingly. The validation of the framework was demonstrated with several examples within MR imaging and MR spectroscopy. Spin-Scenario is available for download at https://github.com/spin-scenario.
Related Concept Videos
Social Scripts
Spin–Spin Coupling Constant: Overview
Qualitatively, any spin plus-half nucleus polarizes the spins of its electrons to the minus-half state. Consequently, the paired electron in the hydrogen–carbon bond must...
NMR Spectroscopy: Spin–Spin Coupling
Spin–Spin Coupling: One-Bond Coupling
Spin–Spin Coupling: Two-Bond Coupling (Geminal Coupling)
The central atom need not be NMR-active because its electrons are affected by the electron polarization of the spin-active atoms. However, spin information is transmitted less effectively than in one-bond coupling, and 2J values are usually weaker than 1J values. The energy of...
Spin–Spin Coupling: Three-Bond Coupling (Vicinal Coupling)
The extent of coupling depends on the C‑C bond length, the two H‑C‑C angles, any electron-withdrawing substituents, and the dihedral angle between the involved orbitals. The...


