Welcome to CMRsim!
CMRsim is a MRI - simulation framework that features bloch-simulations as well as analytic signal evaluations for moving objects with an easy to use API written in pure python. The computationally demanding calculations are implemented in TensorFlow2 and therefore are seamlessly executable on CPU and GPU environments, while also making efficient use of computational resources!
What makes CMRsim special?
CMRsim features bloch-simulations as well as simulations using analytical signal equations and even allows to combine elements of both.
Convenient support for moving particles!
Modularity that makes to designing comparative simulation experiments convenient.
Architecture and implementation that allows to easily include your own simulation modules.
Reproducibility by using versioned and documented open-source software.
Easily scalable to detailed digital phantoms
Installation
Pip
CMRsim can be installed using the python package manager pip. The package can be found
in the registry of the repository hosted on the ETH-Gitlab instance as well as on the python
package index (PyPI).
Versioning:
Stable release versions are denoted with the ususal major.minor notation. Additionally,
development versions are constantly updated on solved issued and can be installed using the
major.minor.devX notation
Release versions are published on PyPI, which allows installing cmrsim with:
pip install cmrsimDevelopment versions are only available using the extra url:
pip install cmrsim --extra-index-url https://gitlab.ethz.ch/api/v4/projects/23798/packages/pypi/simpleTo install cuda and cdnn for GPU accellaration (requires nvidia drivers to be installed on your system), from version 0.31 you can use:
pip install cmrsim[cuda]Docker
For each major release a set of docker images are compiled and published in the container registry associated with repository. Within the docker images, all requirements are installed for simulation deployment.
Furthermore, there are three image-tags available. To use the pull the docker image use (e.g. for jupyter tag):
docker pull registry.ethz.ch/jweine/cmrsim/jupyter:latestCPU
Based on the Tensorflow:…-cpu:latest docker image. Containing all cmrsim dependencies and cmrsim
GPU
Based on the Tensorflow:…-gpu:latest docker image. Containing all cmrsim dependencies and cmrsim
Jupyter
Based on the gpu:latest tag, but also includes an installation of jupyter-lab for interactive simulation / rendering.
Release files for cmrsim 0.31
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cmrsim-0.31.tar.gz | 102.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cmrsim-0.31-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 229.8 kB
Release files / cmrsim-0.31.tar.gz
| Download URL | cmrsim-0.31.tar.gz |
|---|---|
| Size | 102.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
85a5a8e52a6aba5c2c09f7a5f086ead6d3c51247b8048729213e9ff271813a22
|
|
BLAKE2b-256 checksum How to use checksums |
4d964148ca57c4516f5419fa5327fc73aa742575c7276b655e0119a09590f013
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.0 CPython/3.11.9
|
Release files / cmrsim-0.31-py3-none-any.whl
| Download URL | cmrsim-0.31-py3-none-any.whl |
|---|---|
| Size | 127.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
43e45c7ca6e21d4057de25a95b3ffcb99b9213dbdd218e2113bd6d9f845b9e10
|
|
BLAKE2b-256 checksum How to use checksums |
48cf79675108edfb84dc111a14e29b20be327c781e206c087649c5456c503003
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.0 CPython/3.11.9
|
