Tools for Magnetic Resonance Fingerprinting
Project description
mrftools
Python / pip package for managing MRF sequence definitions, dictionary definitions, bloch simulation results, and more. Utilizes HDF5 interchange format (.mrf files).
WARNING FOR USERS
If you are using mrftools for development, you probably want to start with: https://gitlab.casemri.com/common-resources/mrftools-starter-project
This repository can be used for installation if pip is unavailable, or if you are developing new core modules for mrftools.
If you are only interested in using the framework in your own project, you should start with the starter project above instead.
A NOTE ON VERSIONS
Currently, mrftools==0.1.x is the "main" version of the package - this is represented in the "main" branch of this repository.
If you want to use the modular sequence definition structure while it is still in alpha, use the "addSequenceModules" branch (at your own risk).
Features
- MRF Sequence definitions
- Intended to define a sequence for execution on the scanner or within a bloch simulation
- Supports timepoints with varying TR, TE, and FA
- Supports multiple "beats" with varying RRTime, PrepTime, and PrepID
- Can be defined programatically via Python, via .txt import, or via .mrf import
- Can be exported to .txt format or .mrf format (** txt export not implemented fully **)
- MRF Dictionary definitions
- Intended to define a set of dictionary entries to be used by a bloch simulation
- Supports entries with varying T1, T2, and B0 values
- Can be defined programatically via Python, via .txt import, or via .mrf import
- Can be exported to .txt format or .mrf format
- MRF Simulation definitions
- Intended to specify and execute a bloch simulation of a specific sequence over a specific dictionary set
- Configurable phase range and number of isochromat spins
- Can either store all isochromat results or perform averaging before saving dictionary
- Results and configuration can be exported to .mrf format
Installation from pip
- pip install mrftools
Installation from source
- git clone https://gitlab.casemri.com/common-resources/mrftools
- cd mrftools
- pip install .
Building and Publishing pip Package
- python3 setup.py sdist bdist_wheel
- twine upload dist/*
Project details
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
Hashes for mrftools-0.1.52-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 63965292b35620fe62d442d2a00190f9306b54510e8cc927cbda9fa129baa6cc |
|
MD5 | 8185c5ec5212c9803d1d21458497f5f7 |
|
BLAKE2b-256 | d3cddbeb8d8509ef6e02256eb2bc79b37a4d3742dd2da5e963992db3b72a5bc5 |