Skip to content

Latest commit

 

History

History
105 lines (78 loc) · 6.94 KB

README.md

File metadata and controls

105 lines (78 loc) · 6.94 KB

GitHub commits since latest release (by date) GitHub code size in bytes GitHub issues Maintenance GitHub last commit GitHub top language GitHub

MC/DC logo

User Friendly, Fast and Robust Monte Carlo Diffusion and Collision Simulator
Explore MC/DC docs and examples »

Report bug · Request feature

Table of contents

Introduction

The Monte Carlo Diffusion and Collision simulator (MC/DC), is an C++ open source Diffusion Weighted Magnetic Resonance Imaging (DW-MRI) Monte Carlo Simulator. For a in-detail explanation of the numerical framework and basics on DW-MRI imaging we refer the visitor to the following publication: Frontiers https://doi.org/10.3389/fninf.2020.00008

Citation:

AUTHOR=Rafael-Patino Jonathan, Romascano David, Ramirez-Manzanares Alonso, Canales-Rodríguez Erick Jorge, Girard Gabriel, Thiran Jean-Philippe TITLE=Robust Monte-Carlo Simulations in Diffusion-MRI: Effect of the Substrate Complexity and Parameter Choice on the Reproducibility of Results
JOURNAL=Frontiers in Neuroinformatics
VOLUME=14 YEAR=2020 PAGES=8
URL=https://www.frontiersin.org/article/10.3389/fninf.2020.00008
DOI=10.3389/fninf.2020.00008 ISSN=1662-5196

Quick start

Several quick start options are available:

Status

GitHub commits since latest release (by date) GitHub code size in bytes GitHub issues Maintenance GitHub last commit ForTheBadge built-with-science

What's included

The MC/DC Simulator only uses C++ Eigen template library for linear algebra as an external dependency, which is included in the repository; all other basic structures ---from 3d-mesh-models handling to the MRI signal synthesis---are built from scratch in the following hierarchical structure.

enter image description here

All the displayed components depicted above are organized in separated class-oriented modules with abstract-based prototypes that can inherited and re-implemented to augment the functionality and scope of the a simulations.

Bugs and feature requests

Have a bug or a feature request? Please first read the ongoing development chart and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

Documentation

The MC/DC technical documentation is automatically generated using doxygen and the source-files comments, and can be found in here in html format, or in here as a .tex source file.

Versioning

For full reproducibility of the results presented on: https://www.frontiersin.org/articles/10.3389/fninf.2020.00008/full, the first version, 1.42, is the same version released in the paper's GitHub repository: https://github.com/jonhrafe/Robust-Monte-Carlo-Simulations.

However, future releases may not follow the conf_file conventions used and included in the aforementioned repository.

Developer(s)

Jonathan Rafael-Patino

Copyright and license

GNU Lesser General Public License v2.1

Primarily used for software libraries, the GNU LGPL requires that derived works be licensed under the same license, but works that only link to it do not fall under this restriction.