DSI Studio has a high version turning rate, and occasionally the computation outcome may be different between versions. I would recommend keeping a local copy of DSI Studio for each research project and updating DSI Studio every time a new project is initiated.
Packages
Major changes
- 2020/08/02: Major revision on QA calculation. nQA is now replacing QA (https://groups.google.com/g/dsi-studio/c/t-kSFxXrGFU)
- 2023/06/28: Fiber tracking results will change because the default step size = 0 has a different implementation. Older versions will randomly select between 0.5 and 1.5 voxel spacing. The updated version will be 1.0 voxel spacing. To replicate older versions, set the step size to -1 in the command line. Fiber tracking with nonzero step size and correlation tracking is not affected.
- 2023/07/08: Tractography atlas is further separated into 5 sets of pathways. The GUI and command line interface for automated fiber tracking has been modified. The updated DSI Studio allows for using multiple tractography atlases.
Download Links
Download and unzip to run the executive. No installation needed
| OS | File | Note |
|---|---|---|
| Windows (7+) | GPU version (recommended) CPU version (if GPU does not work) |
Unzip the file and click on the DSI Studio program to run it. If missing DLL files, install the VC package. To use GPU, install CUDA Toolkit and update your graphic drivers. |
| Mac (11+) | dsi_studio_mac-11.zip dsi_studio_mac-12.zip dsi_studio_mac-13.zip |
make sure to enable run permission. |
| Ubuntu (16.04+) | dsi_studio_ubuntu1604.zip dsi_studio_ubuntu1804.zip dsi_studio_ubuntu2004.zip dsi_studio_ubuntu2204.zip |
If showing error related to libQt6Charts, run sudo apt install libqt6charts6-devIf reporting error related to xcb, check out this solution. |
| CentOS (7) | dsi_studio_centos7.zip |
Containers
Docker
docker run -ti --rm -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -v $PWD:/data dsistudio/dsistudio:latest
Singularity
$ singularity pull docker://dsistudio/dsistudio:latest # This creates a singularity container *.sif file from the latest release of DSI Studio. Make sure you keep a copy of .sif file for your results
$ singularity exec -B /var,/run -B /home/server/folder dsistudio_latest.sif dsi_studio # Some cluster does not allow users to access host drive, and you may need to mount folder into singularity container
$ singularity exec dsistudio_latest.sif dsi_studio # This invokes the graphic interface of DSI Studio
$ singularity exec dsistudio_latest.sif dsi_studio --action=rec --source=my.src.gz # call DSI Studio command line interface in the singularity container
License
DSI Studio is dual-licensed. You can pick one license or the other.
Academic License
DSI Studio is free for academic or research purposes under Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0) license.
Commercial License
A commercial license is available for using DSI Studio source code or its compiled executive program (i.e. dsi_studio.exe or dsi_studio). This license does not cover third-party tools, resources, or patents owned by other entities, such as:
- TinyFSL: using the FSL plugins needs FSL License.
- Alases: each atlas includes its own license or usage agreement. Most of them are free for both academic and commercial usage.
- Certain algorithms and functions within DSI Studio may be protected by patents. Therefore, it is crucial to be aware of potential patent restrictions when using DSI Studio for commercial purposes. To avoid possible copyright or patent infringement, please contact Frank Yeh to acquire the details.
To obtain the DSI Studio license for commercial use, please email frank.yeh@gmail.com
Hardware recommendation:
Here is an example of a workstation for DSI Studio tractography:
- Chassis: Dell Precision 7920 Tower
- Processor: two CPUs of Intel Xeon Gold 6230 (2.1GHz, 3.9GHz Turbo, 20 Cores)
- Memory: 128GB RAM
- Graphics Card: NVidia Quadro RTX4000, 8GB
- Hard drive: 2TB SSD
- Operating System: Windows