MR image simulator for teaching purposes
Project description
SpinSight MRI simulator
SpinSight is an MRI simulator written in Python and created for educational puposes. It jointly visualizes the imaging parameters, the MRI pulse sequence, the k-space data matrix, and the MR image. These are updated in near real-time when the user changes parameters. The simulator is run as a web browser dashboard. The data is simulated from computational 2D phantoms in vector graphics format (SVG).
Running the Simulator
Install using pip:
pip install spinsight
Then run as a command line tool
spinsight
This serves SpinSight on the local host, so that the simulator can be run by navigating to localhost in the web browser. The same command line tool can be used to deploy the simulator on a local network, or on a web server (run spinsight -h for help). Be aware that several minutes are required upon loading a phantom for the first time.
Phantom construction
To create a new phantom, add a directory with the phantom name under spinsight/phantoms. This directory shall contain specifications in a .toml file with the same name (see brain.toml for reference). The specified .svg file must meet the following specifications:
- All paths must be closed
- All paths must have a fill color matching a hexcolor defined in the
TISSUESdict in constants.py (this defines the tissue). - Only polygons are supported (not Bézier curves etc)
Alternatively a second .toml file can be specified with a list of shapes (see Shepp-Logan_shapes.toml for reference).
Dependencies
See pyproject.toml under heading [tool.poetry.dependencies].
License
SpinSight is distributed under the terms of the GNU General Public License. See LICENSE.md.
Contact Information
Johan Berglund, Ph.D.
Uppsala University Hospital,
Uppsala, Sweden
johan.berglund@akademiska.se
Copyright © 2021–2025 Johan Berglund.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file spinsight-1.2.3.tar.gz.
File metadata
- Download URL: spinsight-1.2.3.tar.gz
- Upload date:
- Size: 613.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d314955d0c906a13eb75deea13f41499ecb066df431a17a9bb8359106b36bdb6
|
|
| MD5 |
36b2372e6cd16c86fdf3e6da6be80448
|
|
| BLAKE2b-256 |
9c861e6714ba308fb9666feb85c8b0988b42012f0b9db7738e3f397d0d4105ac
|
File details
Details for the file spinsight-1.2.3-py3-none-any.whl.
File metadata
- Download URL: spinsight-1.2.3-py3-none-any.whl
- Upload date:
- Size: 107.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dfa7ee69f5803fdadb99937fb6b58a04101cc73db6abe70089fd5b3adab07a8a
|
|
| MD5 |
fb7261b16e0f76649b386f40e9372c80
|
|
| BLAKE2b-256 |
c58cd064ae6c0aaec913f29e9d3f374d6299111f05afaf1ab6b93fb88f7d6ba3
|
